> **Building with AI coding agents?** Install the authstack plugin with one command. This equips your agent with accurate Scalekit implementation patterns.
>
> **Recommended** (the `-y` flags skip prompts, so the command runs without an interactive terminal):
> ```bash
> npx -y @scalekit-inc/cli setup -y
> ```
>
> Global:
> ```bash
> npm install -g @scalekit-inc/cli
> scalekit setup -y
> ```
>
> Supports Claude Code, Cursor, GitHub Copilot, Codex + skills for other Agent Skills-compatible agents in `~/.agents/skills`.
> Skills: integrate-agentkit, implement-saaskit, add-mcp-oauth, implement-sso, implement-scim.
> [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/)

---

# Connect AI agents to Bidsketch

The Bidsketch connector lets your AI agent act in each user's Bidsketch account. Each user connects their own Bidsketch API key once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 39 tools.

**Authentication:** API Key
**Categories:** CRM & Sales, Files & Documents
**Tools:** 39: 18 read, 14 write, 7 destructive
**Users sign in with:** API key
**Built by:** Scalekit connector
**Try it:** [Playground in the Scalekit dashboard](https://app.scalekit.com/ws/signup?sk_intent=playground&provider=BIDSKETCH)

## Setup

1. ### Install the SDK

   **Node.js**

   ```bash
   npm install @scalekit-sdk/node dotenv
   ```

   **Python**

   ```bash
   pip install scalekit-sdk-python python-dotenv
   ```

2. ### Set your credentials

   Add your Scalekit credentials to your `.env` file. Find values in **[app.scalekit.com](https://app.scalekit.com)** > **Developers** > **API Credentials**.

   ```sh title=".env"
   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>
   ```

3. ### Create the Bidsketch connection

   In **AgentKit > Connections**, create a Bidsketch connection. The name you give it is the `connection_name` your code passes. See [Configure connections](/agentkit/connections/).

4. ### Authorize a user and make your first call

   **Node.js** (`quickstart.mts`)

   ```typescript
   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   import { createInterface } from 'node:readline/promises'

   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENVIRONMENT_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions

   const connector = 'bidsketch'
   const identifier = 'user_123'

   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize Bidsketch:', link)
   const rl = createInterface({ input: process.stdin, output: process.stdout })
   await rl.question('Press Enter after authorizing...')
   rl.close()

   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'bidsketch_clients_list',
     toolInput: {},
   })
   console.log(result)
   ```

   ```bash
   npx tsx quickstart.mts
   ```

   **Python** (`quickstart.py`)

   ```python
   import os
   from scalekit import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()

   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions

   connection_name = "bidsketch"
   identifier = "user_123"

   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize Bidsketch:", link_response.link)
   input("Press Enter after authorizing...")

   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="bidsketch_clients_list",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)
   ```

   ```bash
   python quickstart.py
   ```

   Each user opens the link once and enters their Bidsketch credentials there. See [Authorize a user](/agentkit/tools/authorize/) for the full flow and statuses.

## Tools

Pass the exact name to `execute_tool`, with an input like each tool's example. To ask for a tool that's missing, use the [request form](https://scalekitsupport.portal.usepylon.com/forms/request-a-connector-tool).

**Node.js**

```typescript
const result = await actions.executeTool({
  toolName: 'bidsketch_client_get',
  toolInput: {
    client_id: 4815162342,
  },
  connector: 'bidsketch',
  identifier: 'user_123',
})
```

**Python**

```python
result = actions.execute_tool(
    tool_name="bidsketch_client_get",
    tool_input={
        "client_id": 4815162342,
    },
    connection_name="bidsketch",
    identifier="user_123",
)
```

`result.data` is the app's response as JSON, and `result.execution_id` (`executionId` in Node.js) is the ID of the call.

### `bidsketch_client_get`

Get Client · Read-only

Get one Bidsketch client by ID.
Returns the client's name, email, phones, website, address, notes and secondary contact.
Use List Clients to find IDs.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `client_id` (`integer`, required): Bidsketch client ID. Get it from List Clients. Example: 4815162342.

Example input: `{"client_id":4815162342}`

### `bidsketch_client_proposals_list`

List Client Proposals · Read-only

List the proposals for one client.
Returns proposals with id, name, status, draft flag, totals and timestamps.
Use List Proposals for every proposal on the account.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `client_id` (`integer`, required): Bidsketch client ID. Get it from List Clients. Example: 4815162342.
- `page` (`integer`, optional): Page number, starting at 1. Each page holds per_page records (default 100). Example: 2.
- `per_page` (`integer`, optional): Records per page. Defaults to 100. Example: 50.

Example input: `{"client_id":4815162342}`

### `bidsketch_clients_list`

List Clients · Read-only

List the clients on the Bidsketch account, 100 per page by default.
Returns clients with id, name, contact details, address and timestamps.
Use Get Client for one client.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `page` (`integer`, optional): Page number, starting at 1. Each page holds per_page records (default 100). Example: 2.
- `per_page` (`integer`, optional): Records per page. Defaults to 100. Example: 50.

Example input: `{}`

### `bidsketch_fee_get`

Get Fee · Read-only

Get one saved fee by ID.
Returns its name, type, amount, quantity, unit, category, HTML description and total.
Use List Fees to find IDs.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `fee_id` (`integer`, required): Bidsketch saved fee ID. Get it from List Fees. Example: 187375.

Example input: `{"fee_id":187375}`

### `bidsketch_fees_list`

List Fees · Read-only

List the reusable fees saved on the account.
Returns fees with id, name, type, amount, quantity, unit, category, total and details.
Use List Proposal Fees for the fees on one proposal.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `page` (`integer`, optional): Page number, starting at 1. Each page holds per_page records (default 100). Example: 2.
- `per_page` (`integer`, optional): Records per page. Defaults to 100. Example: 50.

Example input: `{}`

### `bidsketch_proposal_content_get`

Get Proposal Content · Read-only

Get a proposal with all its content in one call.
Returns the proposal with its sections and fees collections, in proposal order (opening sections, fees, closing sections).
Use Get Proposal for the proposal fields alone.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `proposal_id` (`integer`, required): Bidsketch proposal ID. Get it from List Proposals. Example: 11051955.

Example input: `{"proposal_id":11051955}`

### `bidsketch_proposal_fee_get`

Get Proposal Fee · Read-only

Get one fee on a proposal.
Returns its name, type, amount, quantity, unit, optional flag, description and total.
Use List Proposal Fees to find IDs.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `fee_id` (`integer`, required): Bidsketch proposal fee ID. Get it from List Proposal Fees. Example: 187376.
- `proposal_id` (`integer`, required): Bidsketch proposal ID. Get it from List Proposals. Example: 11051955.

Example input: `{"fee_id":187376,"proposal_id":11051955}`

### `bidsketch_proposal_fees_list`

List Proposal Fees · Read-only

List the fees on one proposal.
Returns fees with id, name, type, amount, quantity, optional flag, total and details.
Use List Fees for the account's saved fees.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `proposal_id` (`integer`, required): Bidsketch proposal ID. Get it from List Proposals. Example: 11051955.

Example input: `{"proposal_id":11051955}`

### `bidsketch_proposal_get`

Get Proposal · Read-only

Get one proposal by ID.
Returns its name, client, status, draft flag, currency, tax, discount, fee subtotals, total, settings and content counts.
Use Get Proposal Content for all of its sections and fees in one call.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `proposal_id` (`integer`, required): Bidsketch proposal ID. Get it from List Proposals. Example: 11051955.

Example input: `{"proposal_id":11051955}`

### `bidsketch_proposal_section_get`

Get Proposal Section · Read-only

Get one section of a proposal.
Returns its name, type and HTML content.
Use List Proposal Sections to find IDs.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `proposal_id` (`integer`, required): Bidsketch proposal ID. Get it from List Proposals. Example: 11051955.
- `section_id` (`integer`, required): Bidsketch proposal section ID. Get it from List Proposal Sections. Example: 450451.

Example input: `{"proposal_id":11051955,"section_id":450451}`

### `bidsketch_proposal_sections_by_type_list`

List Proposal Sections by Type · Read-only

List only the opening or only the closing sections of a proposal.
Returns sections with id, name and HTML content.
Use List Proposal Sections for all sections.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `proposal_id` (`integer`, required): Bidsketch proposal ID. Get it from List Proposals. Example: 11051955.
- `section_type` (`string`, required): Which sections to list: opening or closing. Example: opening. One of: `opening`, `closing`.

Example input: `{"proposal_id":11051955,"section_type":"opening"}`

### `bidsketch_proposal_sections_list`

List Proposal Sections · Read-only

List all content sections on one proposal.
Returns sections with id, name, type (opening or closing) and HTML content.
Use List Proposal Sections by Type for only opening or closing sections.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `proposal_id` (`integer`, required): Bidsketch proposal ID. Get it from List Proposals. Example: 11051955.

Example input: `{"proposal_id":11051955}`

### `bidsketch_proposal_stats_get`

Get Proposal Stats · Read-only

Get proposal statistics for the account.
Returns the total number of proposals.
Use List Proposals for the proposals themselves.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `bidsketch_proposals_list`

List Proposals · Read-only

List every proposal on the account, 100 per page by default.
Returns proposals with id, name, client, status (Pending, Viewed, Accepted or Declined), draft flag, totals and timestamps.
Use List Client Proposals for one client's proposals.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `page` (`integer`, optional): Page number, starting at 1. Each page holds per_page records (default 100). Example: 2.
- `per_page` (`integer`, optional): Records per page. Defaults to 100. Example: 50.

Example input: `{}`

### `bidsketch_section_get`

Get Section · Read-only

Get one saved section by ID.
Returns its name, type, category and HTML content.
Use List Sections to find IDs.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `section_id` (`integer`, required): Bidsketch saved section ID. Get it from List Sections. Example: 450449.

Example input: `{"section_id":450449}`

### `bidsketch_sections_list`

List Sections · Read-only

List the reusable content sections saved on the account.
Returns sections with id, name, type (opening or closing), category and HTML description.
Use List Proposal Sections for the sections on one proposal.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `page` (`integer`, optional): Page number, starting at 1. Each page holds per_page records (default 100). Example: 2.
- `per_page` (`integer`, optional): Records per page. Defaults to 100. Example: 50.

Example input: `{}`

### `bidsketch_template_get`

Get Template · Read-only

Get one proposal template by ID.
Returns its name and the sections and fees it contains.
Use List Templates to find IDs.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `template_id` (`integer`, required): Bidsketch proposal template ID. Get it from List Templates. Example: 112683.

Example input: `{"template_id":112683}`

### `bidsketch_templates_list`

List Templates · Read-only

List the proposal templates saved on the account.
Returns templates with id, name and timestamps.
Use Create Proposal from Template to start a proposal from one.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `page` (`integer`, optional): Page number, starting at 1. Each page holds per_page records (default 100). Example: 2.
- `per_page` (`integer`, optional): Records per page. Defaults to 100. Example: 50.

Example input: `{}`

### `bidsketch_client_create`

Create Client · Write

Create a client in Bidsketch.
Returns the new client with its id (201). Returns 426 if the plan's client limit is reached.
Use List Clients first to avoid duplicates.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `email` (`string`, required): The client's primary email address. Example: eric@example.com.
- `first_name` (`string`, required): The client's first name (for a person). Example: Eric.
- `last_name` (`string`, required): The client's last name (for a person). Example: Steele.
- `address_field_one` (`string`, optional): First address line. Example: 1 Gazebo Way.
- `address_field_two` (`string`, optional): Second address line. Example: Suite 200.
- `alt_phone` (`string`, optional): Alternate phone number. Example: 1-800-555-0100.
- `city` (`string`, optional): City. Example: Philadelphia.
- `country` (`string`, optional): Country. Example: USA.
- `name` (`string`, optional): The client's full name or company name. Example: Eric's Gazebo Emporium.
- `notes` (`string`, optional): Notes about the client. Send quotes unescaped. Example: Prefers email contact..
- `other_contact` (`object`, optional): Secondary contact. If given, it needs first_name, last_name and email; phone is optional. Example: {"first_name": "Jenny", "last_name": "Tutone", "email": "jenny@example.com", "phone": "867-5309"}.
- `phone` (`string`, optional): Primary phone number. Example: 481-516-2342.
- `postal_zip` (`string`, optional): Postal or ZIP code. Example: 19106.
- `state` (`string`, optional): State or region. Example: PA.
- `website` (`string`, optional): The client's website. Example: example.com.

Example input: `{"email":"<email>","first_name":"<first_name>","last_name":"<last_name>"}`

### `bidsketch_client_update`

Update Client · Write

Update a client's name, contact details, address or notes.
Returns the updated client. Fields left out are not changed.
Use Get Client to read the current values.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `client_id` (`integer`, required): Bidsketch client ID. Get it from List Clients. Example: 4815162342.
- `address_field_one` (`string`, optional): First address line. Example: 1 Gazebo Way.
- `address_field_two` (`string`, optional): Second address line. Example: Suite 200.
- `alt_phone` (`string`, optional): Alternate phone number. Example: 1-800-555-0100.
- `city` (`string`, optional): City. Example: Philadelphia.
- `country` (`string`, optional): Country. Example: USA.
- `email` (`string`, optional): The client's primary email address. Example: eric@example.com.
- `first_name` (`string`, optional): The client's first name (for a person). Example: Eric.
- `last_name` (`string`, optional): The client's last name (for a person). Example: Steele.
- `name` (`string`, optional): The client's full name or company name. Example: Eric's Gazebo Emporium.
- `notes` (`string`, optional): Notes about the client. Send quotes unescaped. Example: Prefers email contact..
- `other_contact` (`object`, optional): Secondary contact. If given, it needs first_name, last_name and email; phone is optional. Example: {"first_name": "Jenny", "last_name": "Tutone", "email": "jenny@example.com", "phone": "867-5309"}.
- `phone` (`string`, optional): Primary phone number. Example: 481-516-2342.
- `postal_zip` (`string`, optional): Postal or ZIP code. Example: 19106.
- `state` (`string`, optional): State or region. Example: PA.
- `website` (`string`, optional): The client's website. Example: example.com.

Example input: `{"client_id":4815162342}`

### `bidsketch_fee_create`

Create Fee · Write

Save a reusable fee to the account for future proposals.
Returns the new fee with its id.
Use Create Proposal Fee to add a fee to one proposal.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `amount` (`number`, required): Fee amount: the total for fixed fees, or the amount per unit for calculated fees. Example: 85.0.
- `feetype` (`string`, required): Fee type: fixed, hourly, monthly, yearly or custom. Example: hourly. One of: `fixed`, `hourly`, `monthly`, `yearly`, `custom`.
- `name` (`string`, required): Fee name. Example: Labor.
- `category` (`string`, optional): Category to group fees. Any text. Example: HVAC Repair.
- `description` (`string`, optional): HTML description of the fee. Example: Includes parts and materials.
.
- `quantity` (`integer`, optional): Quantity for calculated fees. Example: 4.
- `unit` (`string`, optional): Unit label, only for custom fees (hourly, monthly and yearly fees use Hour, Month and Year). Example: Visit.

Example input: `{"amount":85,"feetype":"fixed","name":"<name>"}`

### `bidsketch_fee_update`

Update Fee · Write

Update a saved fee's name, type, amount, quantity, unit, category or description.
Returns the updated fee.
Use Get Fee to read the current values.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `fee_id` (`integer`, required): Bidsketch saved fee ID. Get it from List Fees. Example: 187375.
- `amount` (`number`, optional): Fee amount: the total for fixed fees, or the amount per unit for calculated fees. Example: 85.0.
- `category` (`string`, optional): Category to group fees. Any text. Example: HVAC Repair.
- `description` (`string`, optional): HTML description of the fee. Example: Includes parts and materials.
.
- `feetype` (`string`, optional): Fee type: fixed, hourly, monthly, yearly or custom. Example: hourly. One of: `fixed`, `hourly`, `monthly`, `yearly`, `custom`.
- `name` (`string`, optional): Fee name. Example: Labor.
- `quantity` (`integer`, optional): Quantity for calculated fees. Example: 4.
- `unit` (`string`, optional): Unit label, only for custom fees (hourly, monthly and yearly fees use Hour, Month and Year). Example: Visit.

Example input: `{"fee_id":187375}`

### `bidsketch_proposal_create`

Create Proposal · Write

Create an empty proposal for a client.
Returns the new proposal with its id. Returns 426 if the plan's proposal limit is reached.
Then add content with Create Proposal Section and Create Proposal Fee. Use Create Proposal from Template to start with content.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `client_id` (`integer`, required): ID of the client the proposal is for, from List Clients. Example: 163452.
- `description` (`string`, required): Summary of the proposal. Example: Repair and service of the HVAC system..
- `name` (`string`, required): Proposal name. Example: HVAC repair for Mayor Wilson's office.
- `currency` (`string`, optional): ISO currency code. Example: USD.
- `discount` (`number`, optional): Discount as a decimal fraction (0.1 for 10%). Example: 0.1.
- `proposal_date` (`string`, optional): Proposal date as MM/DD/YYYY. Example: 11/16/2026.
- `settings` (`object`, optional): Proposal display settings: approval_message (HTML), optional_fees_note, optional_fees_title, proposal_fees_title, and the booleans include_optional_fees_in_totals, hide_monthly_total, hide_project_total, hide_yearly_total and hide_grand_total. Example: {"proposal_fees_title": "Fee Summary", "hide_grand_total": false}.
- `tax` (`number`, optional): Tax rate as a decimal fraction (0.1 for 10%). Example: 0.1.
- `tax2` (`number`, optional): Second tax rate as a decimal fraction. Example: 0.05.

Example input: `{"client_id":163452,"description":"<description>","name":"<name>"}`

### `bidsketch_proposal_create_from_template`

Create Proposal from Template · Write

Create a proposal for a client from a saved template, copying its sections and fees.
Returns the new proposal with its id.
Use List Templates to pick the template. Use Create Proposal for an empty proposal.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `client_id` (`integer`, required): ID of the client the proposal is for, from List Clients. Example: 163452.
- `description` (`string`, required): Summary of the proposal. Example: Repair and service of the HVAC system..
- `name` (`string`, required): Proposal name. Example: HVAC repair for Mayor Wilson's office.
- `template_id` (`integer`, required): Bidsketch proposal template ID. Get it from List Templates. Example: 112683.
- `currency` (`string`, optional): ISO currency code. Example: USD.
- `discount` (`number`, optional): Discount as a decimal fraction (0.1 for 10%). Example: 0.1.
- `proposal_date` (`string`, optional): Proposal date as MM/DD/YYYY. Example: 11/16/2026.
- `settings` (`object`, optional): Proposal display settings: approval_message (HTML), optional_fees_note, optional_fees_title, proposal_fees_title, and the booleans include_optional_fees_in_totals, hide_monthly_total, hide_project_total, hide_yearly_total and hide_grand_total. Example: {"proposal_fees_title": "Fee Summary", "hide_grand_total": false}.
- `tax` (`number`, optional): Tax rate as a decimal fraction (0.1 for 10%). Example: 0.1.
- `tax2` (`number`, optional): Second tax rate as a decimal fraction. Example: 0.05.

Example input: `{"client_id":163452,"description":"<description>","name":"<name>","template_id":112683}`

### `bidsketch_proposal_fee_create`

Create Proposal Fee · Write

Add a fee (fixed, hourly, monthly, yearly or custom) to a proposal, optionally as an optional item.
Returns the new fee with its id.
Use Create Proposal Section for text content.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `amount` (`number`, required): Fee amount: the total for fixed fees, or the amount per unit for calculated fees. Example: 85.0.
- `feetype` (`string`, required): Fee type: fixed, hourly, monthly, yearly or custom. Example: hourly. One of: `fixed`, `hourly`, `monthly`, `yearly`, `custom`.
- `name` (`string`, required): Fee name. Example: Labor.
- `proposal_id` (`integer`, required): Bidsketch proposal ID. Get it from List Proposals. Example: 11051955.
- `category` (`string`, optional): Category to group fees. Any text. Example: HVAC Repair.
- `description` (`string`, optional): HTML description of the fee. Example: Includes parts and materials.
.
- `optional` (`boolean`, optional): Mark the fee as an optional item on the proposal. Example: false.
- `quantity` (`integer`, optional): Quantity for calculated fees. Example: 4.
- `unit` (`string`, optional): Unit label, only for custom fees (hourly, monthly and yearly fees use Hour, Month and Year). Example: Visit.

Example input: `{"amount":85,"feetype":"fixed","name":"<name>","proposal_id":11051955}`

### `bidsketch_proposal_fee_update`

Update Proposal Fee · Write

Update a proposal fee's name, type, amount, quantity, unit, category, description or optional flag.
Returns the updated fee.
Use Get Proposal Fee to read the current values.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `fee_id` (`integer`, required): Bidsketch proposal fee ID. Get it from List Proposal Fees. Example: 187376.
- `proposal_id` (`integer`, required): Bidsketch proposal ID. Get it from List Proposals. Example: 11051955.
- `amount` (`number`, optional): Fee amount: the total for fixed fees, or the amount per unit for calculated fees. Example: 85.0.
- `category` (`string`, optional): Category to group fees. Any text. Example: HVAC Repair.
- `description` (`string`, optional): HTML description of the fee. Example: Includes parts and materials.
.
- `feetype` (`string`, optional): Fee type: fixed, hourly, monthly, yearly or custom. Example: hourly. One of: `fixed`, `hourly`, `monthly`, `yearly`, `custom`.
- `name` (`string`, optional): Fee name. Example: Labor.
- `optional` (`boolean`, optional): Mark the fee as an optional item on the proposal. Example: false.
- `quantity` (`integer`, optional): Quantity for calculated fees. Example: 4.
- `unit` (`string`, optional): Unit label, only for custom fees (hourly, monthly and yearly fees use Hour, Month and Year). Example: Visit.

Example input: `{"fee_id":187376,"proposal_id":11051955}`

### `bidsketch_proposal_section_create`

Create Proposal Section · Write

Add a content section to a proposal, as an opening or closing section.
Returns the new section with its id.
Use Create Proposal Fee to add pricing.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `name` (`string`, required): Section name (its heading). Example: Our Advantage.
- `proposal_id` (`integer`, required): Bidsketch proposal ID. Get it from List Proposals. Example: 11051955.
- `sectiontype` (`string`, required): Where the section appears: opening (before fees) or closing (after fees). Example: opening. One of: `opening`, `closing`.
- `category` (`string`, optional): Category to group sections. Any text. Example: HVAC Repair.
- `description` (`string`, optional): HTML content of the section. Example: We use proven methods to fix your system.
.

Example input: `{"name":"<name>","proposal_id":11051955,"sectiontype":"opening"}`

### `bidsketch_proposal_section_update`

Update Proposal Section · Write

Update a proposal section's name, type, category or content.
Returns the updated section.
Use Get Proposal Section to read the current values.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `proposal_id` (`integer`, required): Bidsketch proposal ID. Get it from List Proposals. Example: 11051955.
- `section_id` (`integer`, required): Bidsketch proposal section ID. Get it from List Proposal Sections. Example: 450451.
- `category` (`string`, optional): Category to group sections. Any text. Example: HVAC Repair.
- `description` (`string`, optional): HTML content of the section. Example: We use proven methods to fix your system.
.
- `name` (`string`, optional): Section name (its heading). Example: Our Advantage.
- `sectiontype` (`string`, optional): Where the section appears: opening (before fees) or closing (after fees). Example: opening. One of: `opening`, `closing`.

Example input: `{"proposal_id":11051955,"section_id":450451}`

### `bidsketch_proposal_update`

Update Proposal · Write

Update a proposal's name, client, description, currency, date, tax, discount or settings.
Returns the updated proposal. Fields left out are not changed.
Use Get Proposal to read the current values.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `proposal_id` (`integer`, required): Bidsketch proposal ID. Get it from List Proposals. Example: 11051955.
- `client_id` (`integer`, optional): ID of the client the proposal is for, from List Clients. Example: 163452.
- `currency` (`string`, optional): ISO currency code. Example: USD.
- `description` (`string`, optional): Summary of the proposal. Example: Repair and service of the HVAC system..
- `discount` (`number`, optional): Discount as a decimal fraction (0.1 for 10%). Example: 0.1.
- `name` (`string`, optional): Proposal name. Example: HVAC repair for Mayor Wilson's office.
- `proposal_date` (`string`, optional): Proposal date as MM/DD/YYYY. Example: 11/16/2026.
- `settings` (`object`, optional): Proposal display settings: approval_message (HTML), optional_fees_note, optional_fees_title, proposal_fees_title, and the booleans include_optional_fees_in_totals, hide_monthly_total, hide_project_total, hide_yearly_total and hide_grand_total. Example: {"proposal_fees_title": "Fee Summary", "hide_grand_total": false}.
- `tax` (`number`, optional): Tax rate as a decimal fraction (0.1 for 10%). Example: 0.1.
- `tax2` (`number`, optional): Second tax rate as a decimal fraction. Example: 0.05.

Example input: `{"proposal_id":11051955}`

### `bidsketch_section_create`

Create Section · Write

Save a reusable content section to the account.
Returns the new section with its id.
Use Create Proposal Section to add a section to one proposal.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `name` (`string`, required): Section name (its heading). Example: Our Advantage.
- `sectiontype` (`string`, required): Where the section appears: opening (before fees) or closing (after fees). Example: opening. One of: `opening`, `closing`.
- `category` (`string`, optional): Category to group sections. Any text. Example: HVAC Repair.
- `description` (`string`, optional): HTML content of the section. Example: We use proven methods to fix your system.
.

Example input: `{"name":"<name>","sectiontype":"opening"}`

### `bidsketch_section_update`

Update Section · Write

Update a saved section's name, type, category or content.
Returns the updated section.
Use Get Section to read the current values.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `section_id` (`integer`, required): Bidsketch saved section ID. Get it from List Sections. Example: 450449.
- `category` (`string`, optional): Category to group sections. Any text. Example: HVAC Repair.
- `description` (`string`, optional): HTML content of the section. Example: We use proven methods to fix your system.
.
- `name` (`string`, optional): Section name (its heading). Example: Our Advantage.
- `sectiontype` (`string`, optional): Where the section appears: opening (before fees) or closing (after fees). Example: opening. One of: `opening`, `closing`.

Example input: `{"section_id":450449}`

### `bidsketch_webhook_create`

Create Webhook · Write

Subscribe a URL to a Bidsketch event, such as a proposal being viewed or accepted.
Returns the webhook with its id; keep the id to delete it later.
The API has no list endpoint for webhooks.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `endpoint` (`string`, required): URL that receives the event POSTs. It must answer 200 OK. Example: https://example.com/hooks/bidsketch.
- `event` (`string`, required): Event to subscribe to: client_created, proposal_created, proposal_sent, proposal_viewed, proposal_accepted, proposal_declined or proposal_accepted_or_declined. Example: proposal_accepted. One of: `client_created`, `proposal_created`, `proposal_sent`, `proposal_viewed`, `proposal_accepted`, `proposal_declined`, `proposal_accepted_or_declined`.

Example input: `{"endpoint":"<endpoint>","event":"client_created"}`

### `bidsketch_client_delete`

Delete Client · Destructive

Delete a client and all of its proposals. This cannot be undone.
Returns 204 No Content.
Use List Client Proposals to check what will be deleted.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `client_id` (`integer`, required): Bidsketch client ID. Get it from List Clients. Example: 4815162342.

Example input: `{"client_id":4815162342}`

### `bidsketch_fee_delete`

Delete Fee · Destructive

Delete a saved fee from the account.
Returns an empty response.
Use List Fees to find the ID.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `fee_id` (`integer`, required): Bidsketch saved fee ID. Get it from List Fees. Example: 187375.

Example input: `{"fee_id":187375}`

### `bidsketch_proposal_delete`

Delete Proposal · Destructive

Delete a proposal and all of its content. This cannot be undone.
Returns 204 No Content.
Use List Proposals to find the ID.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `proposal_id` (`integer`, required): Bidsketch proposal ID. Get it from List Proposals. Example: 11051955.

Example input: `{"proposal_id":11051955}`

### `bidsketch_proposal_fee_delete`

Delete Proposal Fee · Destructive

Remove a fee from a proposal.
Returns an empty response.
Use List Proposal Fees to find the ID.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `fee_id` (`integer`, required): Bidsketch proposal fee ID. Get it from List Proposal Fees. Example: 187376.
- `proposal_id` (`integer`, required): Bidsketch proposal ID. Get it from List Proposals. Example: 11051955.

Example input: `{"fee_id":187376,"proposal_id":11051955}`

### `bidsketch_proposal_section_delete`

Delete Proposal Section · Destructive

Remove a section from a proposal.
Returns an empty response.
Use List Proposal Sections to find the ID.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `proposal_id` (`integer`, required): Bidsketch proposal ID. Get it from List Proposals. Example: 11051955.
- `section_id` (`integer`, required): Bidsketch proposal section ID. Get it from List Proposal Sections. Example: 450451.

Example input: `{"proposal_id":11051955,"section_id":450451}`

### `bidsketch_section_delete`

Delete Section · Destructive

Delete a saved section from the account.
Returns an empty response.
Use List Sections to find the ID.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `section_id` (`integer`, required): Bidsketch saved section ID. Get it from List Sections. Example: 450449.

Example input: `{"section_id":450449}`

### `bidsketch_webhook_delete`

Delete Webhook · Destructive

Delete a webhook subscription.
Returns 204 No Content.
Use the id returned by Create Webhook.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `webhook_id` (`integer`, required): Webhook ID, returned by Create Webhook. Example: 1.

Example input: `{"webhook_id":1}`

## Related

Other CRM & Sales connectors ([all 174](/agentkit/connectors/?category=crm-sales)):

- [Salesforce](/agentkit/connectors/salesforce/): Scalekit connector, OAuth, 74 tools
- [HubSpot](/agentkit/connectors/hubspot/): Scalekit connector, OAuth, 457 tools
- [Close](/agentkit/connectors/close/): Scalekit connector, OAuth, 103 tools


---

## More Scalekit documentation

| Resource | What it contains | When to use it |
|----------|-----------------|----------------|
| [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content |
| [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas |
| [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |
