> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Better Proposals

> Better Proposals is a web-based proposal creation tool that enables users to send professionally designed proposals.

![Better Proposals logo](https://mintcdn.com/composio-preview/6S5R4NszqpnVIZRD/images/toolkits/better_proposals.svg?fit=max\&auto=format\&n=6S5R4NszqpnVIZRD\&q=85\&s=a15ba6410cc58a6c9ea1c4e1a0e4c5d7)

* **Category:** proposal & invoice management
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 23
* **Triggers:** 0
* **Slug:** `BETTER_PROPOSALS`
* **Version:** 20261101\_00

## Tools

> [accordion] Create Company
>
> **Slug:** `BETTER_PROPOSALS_CREATE_COMPANY`
>
> Tool to create a new company. Use after confirming the company does not already exist.
>
> #### Input Parameters
>
> **CompanyName** `string` *required*
>
> Company name.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Document Type
>
> **Slug:** `BETTER_PROPOSALS_CREATE_DOCUMENT_TYPE`
>
> Tool to create a new document type. Use after confirming the desired type name does not already exist.
>
> #### Input Parameters
>
> **TypeName** `string` *required*
>
> Document type name
>
> **TypeColour** `string`
>
> Hex colour for your new document type. Default is '#01A3EF'.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Proposal Cover
>
> **Slug:** `BETTER_PROPOSALS_CREATE_PROPOSAL_COVER`
>
> Tool to create a new proposal cover design. Use when you need a custom cover design before sending out a proposal. Use after finalizing cover settings.
>
> #### Input Parameters
>
> **BrandID** `integer`
>
> ID of the brand to use; if omitted, default brand settings are applied
>
> **BGColour** `string`
>
> Background colour as 6-digit hex code, e.g. 'ffffff'
>
> **Headline** `string`
>
> Main headline text on the cover
>
> **CoverName** `string`
>
> Name for the cover; default is 'Untitled'
>
> **Subheader** `string`
>
> Subheader text on the cover
>
> **TextAlign** `string ("left" | "center" | "right")`
>
> Text alignment on the cover; one of 'left', 'center', or 'right'
>
> **ButtonText** `string`
>
> Label text for the start button
>
> **TextColour** `string`
>
> Text colour as 6-digit hex code, e.g. 'ffffff'
>
> **ButtonStyle** `string ("round" | "square")`
>
> Style of the start button; 'round' or 'square'
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get All Companies
>
> **Slug:** `BETTER_PROPOSALS_GET_ALL_COMPANIES`
>
> Tool to retrieve a paginated list of all companies. Use when listing available companies for display or selection.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number to retrieve (minimum 1)
>
> **per\_page** `integer`
>
> Number of companies per page (minimum 1)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get All Currencies
>
> **Slug:** `BETTER_PROPOSALS_GET_ALL_CURRENCIES`
>
> Tool to retrieve a paginated list of all currencies. Use when listing available currency options before selection.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number to retrieve (minimum 1)
>
> **per\_page** `integer`
>
> Number of currencies per page (minimum 1)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get All Document Types
>
> **Slug:** `BETTER_PROPOSALS_GET_ALL_DOCUMENT_TYPES`
>
> Tool to retrieve a paginated list of all document types. Use when you need to display or select a document type ID.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number to retrieve
>
> **per\_page** `integer`
>
> Number of document types per page
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get All Proposals
>
> **Slug:** `BETTER_PROPOSALS_GET_ALL_PROPOSALS`
>
> Tool to retrieve a paginated list of all proposals. Use when you need to fetch proposals list after validating credentials.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number for pagination, must be >= 1
>
> **type** `integer`
>
> Document Type ID to filter proposals
>
> **per\_page** `integer`
>
> Number of proposals per page, must be >= 1
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get All Quotes
>
> **Slug:** `BETTER_PROPOSALS_GET_ALL_QUOTES`
>
> Tool to retrieve a paginated list of all quotes. Use after setting pagination parameters.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number to fetch, default is 1
>
> **per\_page** `integer`
>
> Number of quotes per page, default is 10
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get All Templates
>
> **Slug:** `BETTER_PROPOSALS_GET_ALL_TEMPLATES`
>
> Tool to retrieve a paginated list of all templates. Use when you need to list available templates for selection.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number to retrieve (minimum 1)
>
> **per\_page** `integer`
>
> Number of templates per page (minimum 1)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Brand Settings
>
> **Slug:** `BETTER_PROPOSALS_GET_BRAND_SETTINGS`
>
> Retrieve settings for the default brand, including its name, currency and tax configuration, for use when creating or customizing documents.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Company
>
> **Slug:** `BETTER_PROPOSALS_GET_COMPANY`
>
> Tool to retrieve details of a specific company. Use when you need company metadata by ID.
>
> #### Input Parameters
>
> **company\_id** `string` *required*
>
> The unique identifier of the company to retrieve.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Currency
>
> **Slug:** `BETTER_PROPOSALS_GET_CURRENCY`
>
> Retrieve details of a specific Better Proposals currency by its ID. Use this to look up currency metadata.
>
> #### Input Parameters
>
> **currency\_id** `string` *required*
>
> The unique identifier of the currency to retrieve.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get New Proposals
>
> **Slug:** `BETTER_PROPOSALS_GET_NEW_PROPOSALS`
>
> Retrieve a paginated list of new proposals, optionally filtered by document type.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number for pagination, must be >= 1
>
> **type** `integer`
>
> Document Type ID to filter proposals
>
> **per\_page** `integer`
>
> Number of proposals per page, must be >= 1
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Opened Proposals
>
> **Slug:** `BETTER_PROPOSALS_GET_OPENED_PROPOSALS`
>
> Retrieve a paginated list of proposals that recipients have opened, optionally filtered by document type.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number for pagination, must be >= 1
>
> **type** `integer`
>
> DocumentTypeID to filter proposals
>
> **per\_page** `integer`
>
> Number of proposals per page, must be >= 1
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Paid Proposals
>
> **Slug:** `BETTER_PROPOSALS_GET_PAID_PROPOSALS`
>
> Retrieve a paginated list of paid proposals, optionally filtered by document type.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number for pagination, must be >= 1
>
> **type** `integer`
>
> Document Type ID to filter paid proposals
>
> **per\_page** `integer`
>
> Number of paid proposals per page, must be >= 1
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Proposal
>
> **Slug:** `BETTER_PROPOSALS_GET_PROPOSAL`
>
> Retrieve details of a specific proposal by ID, including available metadata, contacts and price tables.
>
> #### Input Parameters
>
> **proposal\_id** `string` *required*
>
> The unique identifier of the proposal to retrieve.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Proposal Count
>
> **Slug:** `BETTER_PROPOSALS_GET_PROPOSAL_COUNT`
>
> Tool to retrieve the total count of proposals. Use when you need to know how many proposals exist.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Quote
>
> **Slug:** `BETTER_PROPOSALS_GET_QUOTE`
>
> Tool to retrieve details of a specific quote. Use when you need full quote data by ID.
>
> #### Input Parameters
>
> **quote\_id** `string` *required*
>
> The unique identifier of the quote to retrieve.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Sent Proposals
>
> **Slug:** `BETTER_PROPOSALS_GET_SENT_PROPOSALS`
>
> Retrieve a page of sent proposals, optionally filtered by document type.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number for pagination, must be >= 1
>
> **type** `integer`
>
> Document Type ID to filter proposals
>
> **per\_page** `integer`
>
> Number of proposals per page, must be >= 1
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Settings
>
> **Slug:** `BETTER_PROPOSALS_GET_SETTINGS`
>
> Tool to retrieve current account settings. Use when you need default currency, tax, and timezone configuration before creating proposals.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Signed Proposals
>
> **Slug:** `BETTER_PROPOSALS_GET_SIGNED_PROPOSALS`
>
> Retrieve a page of signed proposals, optionally filtered by document type.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number for pagination, must be >= 1
>
> **type** `integer`
>
> Document Type ID to filter signed proposals
>
> **per\_page** `integer`
>
> Number of signed proposals per page, must be >= 1
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Template Details
>
> **Slug:** `BETTER_PROPOSALS_GET_TEMPLATE`
>
> Tool to retrieve details of a specific template. Use after selecting the template ID to fetch metadata.
>
> #### Input Parameters
>
> **template\_id** `string` *required*
>
> The unique identifier of the template to retrieve
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Merge Tags
>
> **Slug:** `BETTER_PROPOSALS_LIST_MERGE_TAGS`
>
> Tool to retrieve custom merge tags with pagination support. Use when you need to list available merge tags for templates.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number to retrieve (minimum 1). Default: 1
>
> **per\_page** `integer`
>
> Number of merge tags per page (minimum 1). Default: 10
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
