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

- **Category:** proposal & invoice management
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 29
- **Triggers:** 0
- **Slug:** `NUSII_PROPOSALS`
- **Version:** 00000000_00

## Tools

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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The unique identifier of the proposal to archive. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Client

**Slug:** `NUSII_PROPOSALS_CREATE_CLIENT`

Tool to create a new client in Nusii Proposals. Use when you need to add a client with their contact and business details. Returns the created client's information including unique identifier.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `web` | string | No | Client's website |
| `city` | string | No | Client's city |
| `name` | string | Yes | Client's first name (required) |
| `email` | string | Yes | Client's email address (required) |
| `state` | string | No | Client's state name |
| `locale` | string | No | Client's language preference for proposals |
| `address` | string | No | Client's street address |
| `country` | string | No | Client's country name |
| `surname` | string | No | Client's last name |
| `business` | string | No | Client's company name |
| `currency` | string | No | Client's currency (defaults to account's default or USD) |
| `postcode` | string | No | Client's postal code |
| `telephone` | string | No | Client's phone number |
| `pdf_page_size` | string | No | PDF page size preference (default: A4) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | Descriptive name/body of the line item. |
| `amount` | integer | No | Cost amount in cents (e.g., 10000 for $100.00). |
| `per_type` | string | No | For per-type costs - 'year', 'month', 'week', 'day', 'hour', 'item', or 'unit'. Only applicable when cost_type is 'per'. |
| `position` | integer | No | Order position of the line item within the section. |
| `quantity` | integer | No | Multiplier for per-type costs (total = quantity × amount). Only applicable when cost_type is 'per'. |
| `cost_type` | string | No | Type of cost - 'fixed', 'recurring', or 'per'. Default is 'fixed'. |
| `section_id` | integer | Yes | The ID of the section to create the line item in. |
| `recurring_type` | string | No | For recurring costs - 'yearly', 'semiannually', 'trimester', 'monthly', 'weekly', 'daily', or 'hourly'. Only applicable when cost_type is 'recurring'. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `theme` | string | No | Proposal visual theme. Defaults to 'clean' if not specified. |
| `title` | string | No | The proposal's title. |
| `report` | boolean | No | Converts the proposal to report format. Defaults to false. |
| `client_id` | integer | No | Associated client identifier. If provided, client_email is ignored. |
| `expires_at` | string | No | Proposal expiration date in ISO 8601 format (e.g., '2024-12-31T23:59:59Z'). |
| `template_id` | integer | No | Copies sections from the specified template into the new proposal. |
| `client_email` | string | No | Client email address. Creates a new client if none exists. Ignored when client_id is provided. |
| `display_date` | string | No | Date displayed on the proposal in ISO 8601 format. Defaults to send date if not specified. |
| `exclude_total` | boolean | No | Removes the total from the proposal. Defaults to false. |
| `prepared_by_id` | integer | No | User ID of the person who prepared the proposal. |
| `exclude_total_in_pdf` | boolean | No | Removes the total from the PDF version of the proposal. Defaults to false. |
| `document_section_title` | string | No | Documents section heading. Defaults to 'Documents' if not specified. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `body` | string | No | Section content |
| `name` | string | No | Internal section identifier |
| `title` | string | No | Section heading |
| `optional` | boolean | No | Client can choose the price package when true (default: false) |
| `position` | integer | No | Display order in proposal/template |
| `reusable` | boolean | No | Reusable sections can be reused to any template/proposal (default: false) |
| `page_break` | boolean | No | PDF page break indicator (default: false) |
| `proposal_id` | integer | No | The proposal identifier. Either proposal_id or template_id should be provided. |
| `template_id` | integer | No | The template identifier. Either proposal_id or template_id should be provided. |
| `section_type` | string | No | Either 'text' or 'cost'; defaults to 'text' |
| `include_total` | boolean | No | Display subtotal within section (default: false) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `events` | array | Yes | Array of event names to subscribe to (e.g., ["proposal_created", "client_created"]). |
| `target_url` | string | Yes | Destination URL of the webhook request. This is where webhook events will be sent. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The unique identifier of the client to delete |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The unique identifier of the line item to delete |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The unique identifier of the proposal to delete |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete a section

**Slug:** `NUSII_PROPOSALS_DELETE_SECTION`

Tool to delete a specific section from Nusii. Use when you need to remove a section from a proposal. Returns the deleted section data for confirmation purposes.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The unique identifier of the section to delete |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The unique identifier of the webhook endpoint to delete |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The unique identifier of the client to retrieve |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Proposal

**Slug:** `NUSII_PROPOSALS_GET_PROPOSAL`

Tool to retrieve a single proposal with complete details and sections. Use when you need to fetch detailed information about a specific proposal.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The proposal identifier to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The unique identifier of the section to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The unique identifier of the webhook endpoint |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `per` | integer | No | Number of results per page. Must be >= 1. Default is 25. |
| `page` | integer | No | Page number for pagination. Must be >= 1. Default is 1. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `per` | integer | No | Number of results per page. Must be >= 1. Default is 25. |
| `page` | integer | No | Page number for pagination. Must be >= 1. Default is 1. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Proposal Activities

**Slug:** `NUSII_PROPOSALS_LIST_PROPOSAL_ACTIVITIES`

Tool to retrieve all proposal activities with optional filtering by proposal or client ID. Use when you need to track interactions with proposals such as views, sends, or acceptances. Supports pagination via page and per parameters.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `per` | integer | No | Number of results per page (default: 25). |
| `page` | integer | No | Page number for pagination (default: 1). |
| `client_id` | integer | No | Filter activities for a specific client by client ID. |
| `proposal_id` | integer | No | Filter activities for a specific proposal by proposal ID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `per` | integer | No | Number of results per page. Default is 25. |
| `page` | integer | No | Page number for pagination. Default is 1. |
| `status` | string ("draft" | "pending" | "accepted" | "rejected" | "clarification") | No | Filter by proposal status: 'draft', 'pending', 'accepted', 'rejected', or 'clarification'. |
| `archived` | boolean | No | Set to true to retrieve only archived proposals. Default is false. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `section_id` | integer | Yes | The ID of the section from which to retrieve line items |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Sections

**Slug:** `NUSII_PROPOSALS_LIST_SECTIONS`

Tool to retrieve all sections with optional filtering for proposals or templates. Use when you need to list sections or filter by proposal_id or template_id.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `per` | integer | No | Results per page (default: 25). |
| `page` | integer | No | Page number for pagination (default: 1). |
| `proposal_id` | integer | No | Filter sections by specific proposal ID. |
| `template_id` | integer | No | Filter sections by specific template ID. |
| `include_line_items` | boolean | No | When true, includes complete line item data in response. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `per` | integer | No | Number of results per page (default: 25). Must be >= 1. |
| `page` | integer | No | Page number for pagination (default: 1). Must be >= 1. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `per` | integer | No | Number of results per page, must be >=1. Default is 25. |
| `page` | integer | No | Page number for pagination, must be >=1. Default is 1. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The unique identifier of the client to update |
| `client` | object | Yes | Client data to update |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The line item ID to update |
| `name` | string | No | Body/description of the line item |
| `amount` | integer | No | Price in cents (e.g., 10000 for $100.00) |
| `per_type` | string ("year" | "month" | "week" | "day" | "hour" | "item" | "unit") | No | For per-unit costs - specifies the unit type. Only valid when cost_type is 'per' |
| `position` | integer | No | Order within the section, must be non-negative |
| `quantity` | integer | No | Multiplier for per-type costs (total = quantity × amount), must be at least 1 |
| `cost_type` | string ("fixed" | "recurring" | "per") | No | Cost structure - valid values: 'fixed' (one-time), 'recurring' (repeating), or 'per' (per-unit) |
| `recurring_type` | string ("yearly" | "semiannually" | "trimester" | "monthly" | "weekly" | "daily" | "hourly") | No | For recurring costs - specifies the recurrence frequency. Only valid when cost_type is 'recurring' |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The unique identifier of the proposal to update |
| `theme` | string | No | Visual design template for the proposal |
| `title` | string | No | Heading text for the proposal |
| `report` | boolean | No | Converts the proposal into a report format; defaults to false |
| `client_id` | string | No | Identifier linking to the client record |
| `expires_at` | string | No | Expiration date/time for the proposal in ISO 8601 format |
| `client_email` | string | No | 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 | No | 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 | No | Removes the total from display; defaults to false |
| `prepared_by_id` | string | No | User identifier for who created the proposal |
| `exclude_total_in_pdf` | boolean | No | Removes the total from the PDF output; defaults to false |
| `document_section_title` | string | No | Heading for the documents section |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The unique identifier of the section to update |
| `body` | string | No | Section content |
| `name` | string | No | Internal reference name for the section |
| `title` | string | No | Section heading |
| `optional` | boolean | No | Client selection option (default: false) |
| `position` | integer | No | Display order in proposal/template |
| `reusable` | boolean | No | Whether the section can be reused to any template/proposal |
| `page_break` | boolean | No | PDF page break toggle (default: false) |
| `proposal_id` | integer | No | Associated proposal identifier |
| `template_id` | integer | No | Associated template identifier |
| `section_type` | string | No | Content type - 'text' or 'cost' |
| `include_total` | boolean | No | Subtotal display within section (default: false) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |