# Propal

## Docs

- [Authentication](https://docs.propal.io/api-reference/authentication.md): Authenticate your API requests with API keys.
- [Create a catalog item](https://docs.propal.io/api-reference/catalog/create-a-catalog-item.md)
- [Delete a bundle](https://docs.propal.io/api-reference/catalog/delete-a-bundle.md)
- [Delete a catalog item](https://docs.propal.io/api-reference/catalog/delete-a-catalog-item.md)
- [Get a bundle with items](https://docs.propal.io/api-reference/catalog/get-a-bundle-with-items.md)
- [Get a catalog item](https://docs.propal.io/api-reference/catalog/get-a-catalog-item.md)
- [List bundles](https://docs.propal.io/api-reference/catalog/list-bundles.md)
- [List catalog items](https://docs.propal.io/api-reference/catalog/list-catalog-items.md)
- [Update a catalog item](https://docs.propal.io/api-reference/catalog/update-a-catalog-item.md)
- [Error handling](https://docs.propal.io/api-reference/errors.md): Understand error responses and handle them gracefully.
- [Automate reporting](https://docs.propal.io/api-reference/guides/automate-reporting.md): Build custom dashboards and automated reports with the Metrics API.
- [Create proposals from a CRM](https://docs.propal.io/api-reference/guides/create-proposal-from-crm.md): Automate proposal creation when a deal reaches a specific stage in your CRM.
- [Sync contacts](https://docs.propal.io/api-reference/guides/sync-contacts.md): Keep your Propal leads in sync with your CRM or contact database.
- [API introduction](https://docs.propal.io/api-reference/introduction.md): Everything you need to know about the Propal public API.
- [Create a lead](https://docs.propal.io/api-reference/leads/create-a-lead.md)
- [Delete a lead](https://docs.propal.io/api-reference/leads/delete-a-lead.md)
- [Get a lead](https://docs.propal.io/api-reference/leads/get-a-lead.md)
- [List leads](https://docs.propal.io/api-reference/leads/list-leads.md): Returns a paginated list of leads for the authenticated organization.
- [List proposals for a lead](https://docs.propal.io/api-reference/leads/list-proposals-for-a-lead.md)
- [Update a lead](https://docs.propal.io/api-reference/leads/update-a-lead.md)
- [Create a file upload URL](https://docs.propal.io/api-reference/media/create-a-file-upload-url.md): Returns a signed upload URL. Upload the file directly to the URL using a PUT request with the file binary as body. The file record is created in Propal immediately — the upload URL is valid for 1 hour.
- [Create a folder](https://docs.propal.io/api-reference/media/create-a-folder.md)
- [Delete a file](https://docs.propal.io/api-reference/media/delete-a-file.md)
- [Delete a folder](https://docs.propal.io/api-reference/media/delete-a-folder.md)
- [Get a file with signed URL](https://docs.propal.io/api-reference/media/get-a-file-with-signed-url.md)
- [List media files](https://docs.propal.io/api-reference/media/list-media-files.md)
- [List media folders](https://docs.propal.io/api-reference/media/list-media-folders.md)
- [Conversion metrics](https://docs.propal.io/api-reference/metrics/conversion-metrics.md)
- [Overview metrics](https://docs.propal.io/api-reference/metrics/overview-metrics.md)
- [Pipeline metrics](https://docs.propal.io/api-reference/metrics/pipeline-metrics.md)
- [Proposal timing](https://docs.propal.io/api-reference/metrics/proposal-timing.md)
- [Rejection reasons](https://docs.propal.io/api-reference/metrics/rejection-reasons.md)
- [Sales metrics](https://docs.propal.io/api-reference/metrics/sales-metrics.md)
- [Team performance](https://docs.propal.io/api-reference/metrics/team-performance.md)
- [Get organization details](https://docs.propal.io/api-reference/organization/get-organization-details.md)
- [List organization members](https://docs.propal.io/api-reference/organization/list-organization-members.md)
- [Pagination](https://docs.propal.io/api-reference/pagination.md): Navigate through large collections with cursor-based pagination.
- [Attach a proposal product](https://docs.propal.io/api-reference/proposals/attach-a-proposal-product.md): Attaches an existing proposal_products row (NOT a bundle) to the proposal. Idempotent — replaces any existing attachment.
- [Create a proposal from a template](https://docs.propal.io/api-reference/proposals/create-a-proposal-from-a-template.md)
- [Delete a proposal](https://docs.propal.io/api-reference/proposals/delete-a-proposal.md)
- [Detach the proposal product](https://docs.propal.io/api-reference/proposals/detach-the-proposal-product.md): Removes the currently attached proposal product from the proposal. Idempotent.
- [Duplicate a proposal](https://docs.propal.io/api-reference/proposals/duplicate-a-proposal.md)
- [Get a proposal](https://docs.propal.io/api-reference/proposals/get-a-proposal.md)
- [Get signature status](https://docs.propal.io/api-reference/proposals/get-signature-status.md)
- [List proposal views](https://docs.propal.io/api-reference/proposals/list-proposal-views.md): Returns a paginated list of viewing sessions (1 row = 1 session, updated via heartbeat) and aggregate metrics for a proposal. Personal data (IP, full geo object) is not exposed.
- [List proposals](https://docs.propal.io/api-reference/proposals/list-proposals.md): Returns a paginated list of proposals for the authenticated organization.
- [List revision requests](https://docs.propal.io/api-reference/proposals/list-revision-requests.md)
- [Publish a proposal](https://docs.propal.io/api-reference/proposals/publish-a-proposal.md)
- [Unpublish a proposal](https://docs.propal.io/api-reference/proposals/unpublish-a-proposal.md)
- [Update proposal metadata](https://docs.propal.io/api-reference/proposals/update-proposal-metadata.md)
- [Quickstart](https://docs.propal.io/api-reference/quickstart.md): Make your first API call in under 5 minutes.
- [Rate limiting](https://docs.propal.io/api-reference/rate-limiting.md): Understand request limits and how to stay within them.
- [Create a template from a proposal](https://docs.propal.io/api-reference/templates/create-a-template-from-a-proposal.md)
- [Delete a template](https://docs.propal.io/api-reference/templates/delete-a-template.md)
- [Get a template](https://docs.propal.io/api-reference/templates/get-a-template.md)
- [List templates](https://docs.propal.io/api-reference/templates/list-templates.md)
- [Create a theme](https://docs.propal.io/api-reference/themes/create-a-theme.md)
- [Delete a theme](https://docs.propal.io/api-reference/themes/delete-a-theme.md)
- [Get a theme](https://docs.propal.io/api-reference/themes/get-a-theme.md)
- [List themes](https://docs.propal.io/api-reference/themes/list-themes.md)
- [Update a theme](https://docs.propal.io/api-reference/themes/update-a-theme.md)
- [HubSpot](https://docs.propal.io/guides/integrations/hubspot.md): Synchronize contacts and proposals between Propal and HubSpot CRM.
- [Integrations](https://docs.propal.io/guides/integrations/overview.md): Connect Propal with your CRM, payment processor, and other tools.
- [SDKs & libraries](https://docs.propal.io/guides/sdks.md): Client libraries and tools for working with the Propal API.
- [Propal documentation](https://docs.propal.io/introduction.md): Learn how to create proposals, connect your tools, and automate your sales workflows with Propal.
- [Authentication](https://docs.propal.io/mcp/authentication.md): OAuth 2.1 with PKCE, dynamic client registration, and scope enforcement.
- [Components DSL](https://docs.propal.io/mcp/components-dsl.md): The typed grammar agents use to build proposal content.
- [Reading & editing proposals](https://docs.propal.io/mcp/editing.md): Read the document as DSL, then insert, update, delete, reorder, or find & replace.
- [MCP introduction](https://docs.propal.io/mcp/introduction.md): Build, edit, and theme proposals from any MCP-compatible AI agent.
- [Limits & errors](https://docs.propal.io/mcp/limits-and-errors.md): Validation rules, structural limits, and how the MCP reports errors.
- [Quickstart](https://docs.propal.io/mcp/quickstart.md): Connect Claude Desktop, claude.ai web, or the MCP Inspector to Propal in under 5 minutes.
- [Theming](https://docs.propal.io/mcp/theming.md): Three creation modes, plus apply, detach, named slots, and per-section overrides.
- [Tool catalog](https://docs.propal.io/mcp/tools.md): Every tool the Propal MCP exposes, grouped by domain.

## OpenAPI Specs

- [openapi](https://docs.propal.io/openapi.json)

## Optional

- [Website](https://propal.io)
- [Affiliate Program](https://propal.firstpromoter.com)
- [Status](https://status.propal.io/status/uptime)