Skip to main content
Better Proposals logo
  • Category: proposal & invoice management
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 23
  • Triggers: 0
  • Slug: BETTER_PROPOSALS
  • Version: 20261101_00

Tools

Slug: BETTER_PROPOSALS_CREATE_COMPANYTool to create a new company. Use after confirming the company does not already exist.

Input Parameters

string
required
Company name.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BETTER_PROPOSALS_CREATE_DOCUMENT_TYPETool to create a new document type. Use after confirming the desired type name does not already exist.

Input Parameters

string
required
Document type name
string
Hex colour for your new document type. Default is ‘#01A3EF’.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BETTER_PROPOSALS_CREATE_PROPOSAL_COVERTool 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

integer
ID of the brand to use; if omitted, default brand settings are applied
string
Background colour as 6-digit hex code, e.g. ‘ffffff’
string
Main headline text on the cover
string
Name for the cover; default is ‘Untitled’
string
Subheader text on the cover
string ("left" | "center" | "right")
Text alignment on the cover; one of ‘left’, ‘center’, or ‘right’
string
Label text for the start button
string
Text colour as 6-digit hex code, e.g. ‘ffffff’
string ("round" | "square")
Style of the start button; ‘round’ or ‘square’

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BETTER_PROPOSALS_GET_ALL_COMPANIESTool to retrieve a paginated list of all companies. Use when listing available companies for display or selection.

Input Parameters

integer
Page number to retrieve (minimum 1)
integer
Number of companies per page (minimum 1)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BETTER_PROPOSALS_GET_ALL_CURRENCIESTool to retrieve a paginated list of all currencies. Use when listing available currency options before selection.

Input Parameters

integer
Page number to retrieve (minimum 1)
integer
Number of currencies per page (minimum 1)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BETTER_PROPOSALS_GET_ALL_DOCUMENT_TYPESTool to retrieve a paginated list of all document types. Use when you need to display or select a document type ID.

Input Parameters

integer
Page number to retrieve
integer
Number of document types per page

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BETTER_PROPOSALS_GET_ALL_PROPOSALSTool to retrieve a paginated list of all proposals. Use when you need to fetch proposals list after validating credentials.

Input Parameters

integer
Page number for pagination, must be >= 1
integer
Document Type ID to filter proposals
integer
Number of proposals per page, must be >= 1

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BETTER_PROPOSALS_GET_ALL_QUOTESTool to retrieve a paginated list of all quotes. Use after setting pagination parameters.

Input Parameters

integer
Page number to fetch, default is 1
integer
Number of quotes per page, default is 10

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BETTER_PROPOSALS_GET_ALL_TEMPLATESTool to retrieve a paginated list of all templates. Use when you need to list available templates for selection.

Input Parameters

integer
Page number to retrieve (minimum 1)
integer
Number of templates per page (minimum 1)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BETTER_PROPOSALS_GET_BRAND_SETTINGSRetrieve settings for the default brand, including its name, currency and tax configuration, for use when creating or customizing documents.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BETTER_PROPOSALS_GET_COMPANYTool to retrieve details of a specific company. Use when you need company metadata by ID.

Input Parameters

string
required
The unique identifier of the company to retrieve.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BETTER_PROPOSALS_GET_CURRENCYRetrieve details of a specific Better Proposals currency by its ID. Use this to look up currency metadata.

Input Parameters

string
required
The unique identifier of the currency to retrieve.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BETTER_PROPOSALS_GET_NEW_PROPOSALSRetrieve a paginated list of new proposals, optionally filtered by document type.

Input Parameters

integer
Page number for pagination, must be >= 1
integer
Document Type ID to filter proposals
integer
Number of proposals per page, must be >= 1

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BETTER_PROPOSALS_GET_OPENED_PROPOSALSRetrieve a paginated list of proposals that recipients have opened, optionally filtered by document type.

Input Parameters

integer
Page number for pagination, must be >= 1
integer
DocumentTypeID to filter proposals
integer
Number of proposals per page, must be >= 1

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BETTER_PROPOSALS_GET_PAID_PROPOSALSRetrieve a paginated list of paid proposals, optionally filtered by document type.

Input Parameters

integer
Page number for pagination, must be >= 1
integer
Document Type ID to filter paid proposals
integer
Number of paid proposals per page, must be >= 1

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BETTER_PROPOSALS_GET_PROPOSALRetrieve details of a specific proposal by ID, including available metadata, contacts and price tables.

Input Parameters

string
required
The unique identifier of the proposal to retrieve.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BETTER_PROPOSALS_GET_PROPOSAL_COUNTTool to retrieve the total count of proposals. Use when you need to know how many proposals exist.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BETTER_PROPOSALS_GET_QUOTETool to retrieve details of a specific quote. Use when you need full quote data by ID.

Input Parameters

string
required
The unique identifier of the quote to retrieve.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BETTER_PROPOSALS_GET_SENT_PROPOSALSRetrieve a page of sent proposals, optionally filtered by document type.

Input Parameters

integer
Page number for pagination, must be >= 1
integer
Document Type ID to filter proposals
integer
Number of proposals per page, must be >= 1

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BETTER_PROPOSALS_GET_SETTINGSTool to retrieve current account settings. Use when you need default currency, tax, and timezone configuration before creating proposals.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BETTER_PROPOSALS_GET_SIGNED_PROPOSALSRetrieve a page of signed proposals, optionally filtered by document type.

Input Parameters

integer
Page number for pagination, must be >= 1
integer
Document Type ID to filter signed proposals
integer
Number of signed proposals per page, must be >= 1

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BETTER_PROPOSALS_GET_TEMPLATETool to retrieve details of a specific template. Use after selecting the template ID to fetch metadata.

Input Parameters

string
required
The unique identifier of the template to retrieve

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BETTER_PROPOSALS_LIST_MERGE_TAGSTool to retrieve custom merge tags with pagination support. Use when you need to list available merge tags for templates.

Input Parameters

integer
Page number to retrieve (minimum 1). Default: 1
integer
Number of merge tags per page (minimum 1). Default: 10

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not