> ## 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.

# Nusii proposals

> Proposal software that both you and your clients will love. Stop fighting with Word, InDesign and PDF's. Create beautiful proposals in less time, every time with Nusii.

![Nusii proposals logo](https://mintcdn.com/composio-preview/9YPuzjEU4UlMnwGq/images/toolkits/nusii_proposals.svg?fit=max\&auto=format\&n=9YPuzjEU4UlMnwGq\&q=85\&s=645e82d647312a94165a1b811e49142d)

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

## Tools

> [accordion] Archive Proposal
>
> **Slug:** `NUSII_PROPOSALS_ARCHIVE_PROPOSAL`
>
> Tool to archive a specific proposal in Nusii. Use when you need to archive a proposal that is no longer active.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The unique identifier of the proposal to archive.
>
> #### 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 Client
>
> **Slug:** `NUSII_PROPOSALS_CREATE_CLIENT`
>
> Create a new Nusii client with contact and business details. The returned result may not include the created client's identifier or information.
>
> #### Input Parameters
>
> **web** `string`
>
> Client's website
>
> **city** `string`
>
> Client's city
>
> **name** `string` *required*
>
> Client's first name (required)
>
> **email** `string` *required*
>
> Client's email address (required)
>
> **state** `string`
>
> Client's state name
>
> **locale** `string`
>
> Client's language preference for proposals
>
> **address** `string`
>
> Client's street address
>
> **country** `string`
>
> Client's country name
>
> **surname** `string`
>
> Client's last name
>
> **business** `string`
>
> Client's company name
>
> **currency** `string`
>
> Client's currency (defaults to account's default or USD)
>
> **postcode** `string`
>
> Client's postal code
>
> **telephone** `string`
>
> Client's phone number
>
> **pdf\_page\_size** `string`
>
> PDF page size preference (default: A4)
>
> #### 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 Line Item
>
> **Slug:** `NUSII_PROPOSALS_CREATE_LINE_ITEM`
>
> Tool to create a line item within a proposal section. Use when you need to add a cost item to a specific section of a proposal.
>
> #### Input Parameters
>
> **name** `string`
>
> Descriptive name/body of the line item.
>
> **amount** `integer`
>
> Cost amount in cents (e.g., 10000 for \$100.00).
>
> **per\_type** `string`
>
> For per-type costs - 'year', 'month', 'week', 'day', 'hour', 'item', or 'unit'. Only applicable when cost\_type is 'per'.
>
> **position** `integer`
>
> Order position of the line item within the section.
>
> **quantity** `integer`
>
> Multiplier for per-type costs (total = quantity × amount). Only applicable when cost\_type is 'per'.
>
> **cost\_type** `string`
>
> Type of cost - 'fixed', 'recurring', or 'per'. Default is 'fixed'.
>
> **section\_id** `integer` *required*
>
> The ID of the section to create the line item in.
>
> **recurring\_type** `string`
>
> For recurring costs - 'yearly', 'semiannually', 'trimester', 'monthly', 'weekly', 'daily', or 'hourly'. Only applicable when cost\_type is 'recurring'.
>
> #### 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
>
> **Slug:** `NUSII_PROPOSALS_CREATE_PROPOSAL`
>
> Tool to create a new proposal in Nusii. Use when you need to initialize a proposal with title, client information, and optional configuration settings.
>
> #### Input Parameters
>
> **theme** `string`
>
> Proposal visual theme. Defaults to 'clean' if not specified.
>
> **title** `string`
>
> The proposal's title.
>
> **report** `boolean`
>
> Converts the proposal to report format. Defaults to false.
>
> **client\_id** `integer`
>
> Associated client identifier. If provided, client\_email is ignored.
>
> **expires\_at** `string`
>
> Proposal expiration date in ISO 8601 format (e.g., '2024-12-31T23:59:59Z').
>
> **template\_id** `integer`
>
> Copies sections from the specified template into the new proposal.
>
> **client\_email** `string`
>
> Client email address. Creates a new client if none exists. Ignored when client\_id is provided.
>
> **display\_date** `string`
>
> Date displayed on the proposal in ISO 8601 format. Defaults to send date if not specified.
>
> **exclude\_total** `boolean`
>
> Removes the total from the proposal. Defaults to false.
>
> **prepared\_by\_id** `integer`
>
> User ID of the person who prepared the proposal.
>
> **exclude\_total\_in\_pdf** `boolean`
>
> Removes the total from the PDF version of the proposal. Defaults to false.
>
> **document\_section\_title** `string`
>
> Documents section heading. Defaults to 'Documents' if not specified.
>
> #### 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 Section
>
> **Slug:** `NUSII_PROPOSALS_CREATE_SECTION`
>
> Tool to create a section for a proposal or template in Nusii Proposals. Use when you need to add a new section to a proposal or template.
>
> #### Input Parameters
>
> **body** `string`
>
> Section content
>
> **name** `string`
>
> Internal section identifier
>
> **title** `string`
>
> Section heading
>
> **optional** `boolean`
>
> Client can choose the price package when true (default: false)
>
> **position** `integer`
>
> Display order in proposal/template
>
> **reusable** `boolean`
>
> Reusable sections can be reused to any template/proposal (default: false)
>
> **page\_break** `boolean`
>
> PDF page break indicator (default: false)
>
> **proposal\_id** `integer`
>
> The proposal identifier. Either proposal\_id or template\_id should be provided.
>
> **template\_id** `integer`
>
> The template identifier. Either proposal\_id or template\_id should be provided.
>
> **section\_type** `string`
>
> Either 'text' or 'cost'; defaults to 'text'
>
> **include\_total** `boolean`
>
> Display subtotal within section (default: false)
>
> #### 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 Webhook Endpoint
>
> **Slug:** `NUSII_PROPOSALS_CREATE_WEBHOOK_ENDPOINT`
>
> Tool to create a webhook endpoint to subscribe to Nusii events. Use when you need to register a new webhook for receiving event notifications.
>
> #### Input Parameters
>
> **events** `array` *required*
>
> Array of event names to subscribe to (e.g., \["proposal\_created", "client\_created"]).
>
> **target\_url** `string` *required*
>
> Destination URL of the webhook request. This is where webhook events will be sent.
>
> #### 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] Delete a client
>
> **Slug:** `NUSII_PROPOSALS_DELETE_CLIENT`
>
> Tool to delete a specific client from Nusii account. Use when you need to permanently remove a client record.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The unique identifier of the client to delete
>
> #### 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] Delete Line Item
>
> **Slug:** `NUSII_PROPOSALS_DELETE_LINE_ITEM`
>
> Tool to delete a line item from Nusii. Use when you need to remove a specific line item by its ID.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The unique identifier of the line item to delete
>
> #### 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] Delete a proposal
>
> **Slug:** `NUSII_PROPOSALS_DELETE_PROPOSAL`
>
> Tool to delete a proposal from the system. Use when you need to permanently remove a proposal by its ID.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The unique identifier of the proposal to delete
>
> #### 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] Delete a section
>
> **Slug:** `NUSII_PROPOSALS_DELETE_SECTION`
>
> Delete a specific section from Nusii, including a section in a proposal. The tool does not return the deleted section data.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The unique identifier of the section to delete
>
> #### 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] Delete Webhook Endpoint
>
> **Slug:** `NUSII_PROPOSALS_DELETE_WEBHOOK_ENDPOINT`
>
> Tool to delete a specific webhook endpoint from the system. Use when you need to remove a webhook endpoint.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The unique identifier of the webhook endpoint to delete
>
> #### 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 Account Me
>
> **Slug:** `NUSII_PROPOSALS_GET_ACCOUNT_ME`
>
> Tool to retrieve authenticated user's personal account information and settings. Use to get current account details including company info, currency, locale, and contact information.
>
> #### 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 Client
>
> **Slug:** `NUSII_PROPOSALS_GET_CLIENT`
>
> Tool to retrieve a single client from Nusii using their unique identifier. Use when you need to fetch detailed information about a specific client including contact details, business information, and preferences.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The unique identifier of the client 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
>
> **Slug:** `NUSII_PROPOSALS_GET_PROPOSAL`
>
> Retrieve a specific Nusii proposal by ID, including proposal attributes and section references.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The proposal identifier 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 Section
>
> **Slug:** `NUSII_PROPOSALS_GET_SECTION`
>
> Tool to retrieve a single section from a proposal or template in Nusii. Use when you need detailed information about a specific section including title, content, pricing, and metadata.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The unique identifier of the section 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 Webhook Endpoint
>
> **Slug:** `NUSII_PROPOSALS_GET_WEBHOOK_ENDPOINT`
>
> Tool to retrieve a single webhook endpoint configuration. Use when you need to get details about a specific webhook endpoint including its target URL and subscribed events.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The unique identifier of the webhook endpoint
>
> #### 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 Clients
>
> **Slug:** `NUSII_PROPOSALS_LIST_CLIENTS`
>
> Tool to retrieve all clients associated with the account. Use when you need to list or browse clients with pagination support.
>
> #### Input Parameters
>
> **per** `integer`
>
> Number of results per page. Must be >= 1. Default is 25.
>
> **page** `integer`
>
> Page number for pagination. Must be >= 1. Default is 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] List Line Items
>
> **Slug:** `NUSII_PROPOSALS_LIST_LINE_ITEMS`
>
> Tool to retrieve all line items from Nusii Proposals with pagination support. Use when you need to list or browse line items in proposals.
>
> #### Input Parameters
>
> **per** `integer`
>
> Number of results per page. Must be >= 1. Default is 25.
>
> **page** `integer`
>
> Page number for pagination. Must be >= 1. Default is 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] List Proposal Activities
>
> **Slug:** `NUSII_PROPOSALS_LIST_PROPOSAL_ACTIVITIES`
>
> List proposal activities, optionally filtering by proposal or client ID, to track interactions such as views, sends, and acceptances. Use page and per to paginate the results.
>
> #### Input Parameters
>
> **per** `integer`
>
> Number of results per page (default: 25).
>
> **page** `integer`
>
> Page number for pagination (default: 1).
>
> **client\_id** `integer`
>
> Filter activities for a specific client by client ID.
>
> **proposal\_id** `integer`
>
> Filter activities for a specific proposal by proposal ID.
>
> #### 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 Proposals
>
> **Slug:** `NUSII_PROPOSALS_LIST_PROPOSALS`
>
> Tool to retrieve all proposals from your Nusii account with pagination and filtering options. Use when you need to browse proposals or filter by status.
>
> #### Input Parameters
>
> **per** `integer`
>
> Number of results per page. Default is 25.
>
> **page** `integer`
>
> Page number for pagination. Default is 1.
>
> **status** `string ("draft" | "pending" | "accepted" | "rejected" | "clarification")`
>
> Filter by proposal status: 'draft', 'pending', 'accepted', 'rejected', or 'clarification'.
>
> **archived** `boolean`
>
> Set to true to retrieve only archived proposals. Default is false.
>
> #### 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 Section Line Items
>
> **Slug:** `NUSII_PROPOSALS_LIST_SECTION_LINE_ITEMS`
>
> Tool to retrieve all line items from a specific section. Use when you need to get details about line items including pricing, quantities, and cost types within a section. Note: This endpoint does not support pagination.
>
> #### Input Parameters
>
> **section\_id** `integer` *required*
>
> The ID of the section from which to retrieve line items
>
> #### 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 Sections
>
> **Slug:** `NUSII_PROPOSALS_LIST_SECTIONS`
>
> List sections with optional proposal or template filtering and pagination. Without a proposal or template ID, the API returns the account's reusable sections.
>
> #### Input Parameters
>
> **per** `integer`
>
> Results per page (default: 25).
>
> **page** `integer`
>
> Page number for pagination (default: 1).
>
> **proposal\_id** `integer`
>
> Filter sections by specific proposal ID.
>
> **template\_id** `integer`
>
> Filter sections by specific template ID.
>
> **include\_line\_items** `boolean`
>
> When true, includes complete line item data in response.
>
> #### 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 Themes
>
> **Slug:** `NUSII_PROPOSALS_LIST_THEMES`
>
> Tool to retrieve all available themes for proposals in Nusii. Use when you need to browse available theme options or select a theme for a proposal.
>
> #### 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 Users
>
> **Slug:** `NUSII_PROPOSALS_LIST_USERS`
>
> Tool to retrieve all users in paginated format. Use when you need to list users in the Nusii system. Supports pagination via page and per parameters.
>
> #### Input Parameters
>
> **per** `integer`
>
> Number of results per page (default: 25). Must be >= 1.
>
> **page** `integer`
>
> Page number for pagination (default: 1). 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] List Webhook Endpoints
>
> **Slug:** `NUSII_PROPOSALS_LIST_WEBHOOK_ENDPOINTS`
>
> Tool to retrieve all webhook endpoints configured for your Nusii account. Use when you need to view all configured webhook subscriptions. Supports pagination via page and per parameters.
>
> #### Input Parameters
>
> **per** `integer`
>
> Number of results per page, must be >=1. Default is 25.
>
> **page** `integer`
>
> Page number for pagination, must be >=1. Default is 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] Update Client
>
> **Slug:** `NUSII_PROPOSALS_UPDATE_CLIENT`
>
> Tool to update an existing client's information in Nusii. Use when you need to modify client details such as contact information, business details, or preferences.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The unique identifier of the client to update
>
> **client** `object` *required*
>
> Client data to update
>
> #### 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] Update Line Item
>
> **Slug:** `NUSII_PROPOSALS_UPDATE_LINE_ITEM`
>
> Tool to update an existing line item in Nusii proposals. Use when modifying line item details such as name, amount, cost type, or position. All update parameters are optional - only include the fields you want to change.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The line item ID to update
>
> **name** `string`
>
> Body/description of the line item
>
> **amount** `integer`
>
> Price in cents (e.g., 10000 for \$100.00)
>
> **per\_type** `string ("year" | "month" | "week" | "day" | "hour" | "item" | "unit")`
>
> For per-unit costs - specifies the unit type. Only valid when cost\_type is 'per'
>
> **position** `integer`
>
> Order within the section, must be non-negative
>
> **quantity** `integer`
>
> Multiplier for per-type costs (total = quantity × amount), must be at least 1
>
> **cost\_type** `string ("fixed" | "recurring" | "per")`
>
> Cost structure - valid values: 'fixed' (one-time), 'recurring' (repeating), or 'per' (per-unit)
>
> **recurring\_type** `string ("yearly" | "semiannually" | "trimester" | "monthly" | "weekly" | "daily" | "hourly")`
>
> For recurring costs - specifies the recurrence frequency. Only valid when cost\_type is 'recurring'
>
> #### 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] Update Proposal
>
> **Slug:** `NUSII_PROPOSALS_UPDATE_PROPOSAL`
>
> Tool to update an existing proposal in Nusii. Use when you need to modify proposal details like title, client, expiration date, or display settings.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The unique identifier of the proposal to update
>
> **theme** `string`
>
> Visual design template for the proposal
>
> **title** `string`
>
> Heading text for the proposal
>
> **report** `boolean`
>
> Converts the proposal into a report format; defaults to false
>
> **client\_id** `string`
>
> Identifier linking to the client record
>
> **expires\_at** `string`
>
> Expiration date/time for the proposal in ISO 8601 format
>
> **client\_email** `string`
>
> Fetches the client associated with that email. It creates a new client if there is no client with that email. This is ignored when client\_id is set.
>
> **display\_date** `string`
>
> By default the date displayed on the proposal is the sent date. This can be overwritten with the display\_date in ISO 8601 format
>
> **exclude\_total** `boolean`
>
> Removes the total from display; defaults to false
>
> **prepared\_by\_id** `string`
>
> User identifier for who created the proposal
>
> **exclude\_total\_in\_pdf** `boolean`
>
> Removes the total from the PDF output; defaults to false
>
> **document\_section\_title** `string`
>
> Heading for the documents section
>
> #### 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] Update Section
>
> **Slug:** `NUSII_PROPOSALS_UPDATE_SECTION`
>
> Tool to update an existing section in a proposal or template. Use when you need to modify section content, settings, or display properties.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The unique identifier of the section to update
>
> **body** `string`
>
> Section content
>
> **name** `string`
>
> Internal reference name for the section
>
> **title** `string`
>
> Section heading
>
> **optional** `boolean`
>
> Client selection option (default: false)
>
> **position** `integer`
>
> Display order in proposal/template
>
> **reusable** `boolean`
>
> Whether the section can be reused to any template/proposal
>
> **page\_break** `boolean`
>
> PDF page break toggle (default: false)
>
> **proposal\_id** `integer`
>
> Associated proposal identifier
>
> **template\_id** `integer`
>
> Associated template identifier
>
> **section\_type** `string`
>
> Content type - 'text' or 'cost'
>
> **include\_total** `boolean`
>
> Subtotal display within section (default: false)
>
> #### 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
