> **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 Fireberry

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

**Authentication:** API Key
**Categories:** CRM & Sales
**Tools:** 60: 32 read, 20 write, 8 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=FIREBERRY)

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

   In **AgentKit > Connections**, create a Fireberry 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 = 'fireberry'
   const identifier = 'user_123'

   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize Fireberry:', 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: 'fireberry_accounts_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 = "fireberry"
   identifier = "user_123"

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

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

   ```bash
   python quickstart.py
   ```

   Each user opens the link once and enters their Fireberry 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: 'fireberry_account_get',
  toolInput: {
    id: '<id>',
  },
  connector: 'fireberry',
  identifier: 'user_123',
})
```

**Python**

```python
result = actions.execute_tool(
    tool_name="fireberry_account_get",
    tool_input={
        "id": "<id>",
    },
    connection_name="fireberry",
    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.

### `fireberry_account_get`

Get Account · Read-only

Get one account by GUID.
Returns data with all of the record's fields.
Use fireberry_account_get when you have the GUID.

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

Inputs:

- `id` (`string`, required): GUID of the account. Example: 8f1e2d3c-4b5a-6978-8a9b-0c1d2e3f4a5b.

Example input: `{"id":"<id>"}`

### `fireberry_accounts_list`

List Accounts · Read-only

List accounts (object 1) a page at a time, up to 50 per page and 10 pages.
Returns data with Records[], Total_Records, Page_Size and Page_Number.
Use fireberry_accounts_list to browse. Use fireberry_records_query to filter or sort.

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

Inputs:

- `page_number` (`integer`, optional): Page number, up to 10. Defaults to 1; use fireberry_records_query for larger result sets. Example: 1.
- `page_size` (`integer`, optional): Records per page, up to 50. Defaults to 50. Example: 50.

Example input: `{}`

### `fireberry_articles_list`

List Articles · Read-only

List knowledge base articles (object 76) a page at a time.
Returns data with Records[] and paging info.
Use fireberry_articles_list to find help content for tickets.

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

Inputs:

- `page_number` (`integer`, optional): Page number, up to 10. Defaults to 1; use fireberry_records_query for larger result sets. Example: 1.
- `page_size` (`integer`, optional): Records per page, up to 50. Defaults to 50. Example: 50.

Example input: `{}`

### `fireberry_campaigns_list`

List Campaigns · Read-only

List marketing campaigns (object 67) a page at a time.
Returns data with Records[] and paging info.
Use fireberry_campaigns_list to get campaign GUIDs for accounts and contacts.

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

Inputs:

- `page_number` (`integer`, optional): Page number, up to 10. Defaults to 1; use fireberry_records_query for larger result sets. Example: 1.
- `page_size` (`integer`, optional): Records per page, up to 50. Defaults to 50. Example: 50.

Example input: `{}`

### `fireberry_contact_get`

Get Contact · Read-only

Get one contact by GUID.
Returns data with all of the record's fields.
Use fireberry_contact_get when you have the GUID.

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

Inputs:

- `id` (`string`, required): GUID of the contact. Example: 8f1e2d3c-4b5a-6978-8a9b-0c1d2e3f4a5b.

Example input: `{"id":"<id>"}`

### `fireberry_contacts_list`

List Contacts · Read-only

List contacts (object 2) a page at a time, up to 50 per page and 10 pages.
Returns data with Records[], Total_Records, Page_Size and Page_Number.
Use fireberry_contacts_list to browse. Use fireberry_records_query to filter or sort.

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

Inputs:

- `page_number` (`integer`, optional): Page number, up to 10. Defaults to 1; use fireberry_records_query for larger result sets. Example: 1.
- `page_size` (`integer`, optional): Records per page, up to 50. Defaults to 50. Example: 50.

Example input: `{}`

### `fireberry_field_get`

Get Field · Read-only

Get one field's details.
Returns data with the field's label, type and settings.
Use fireberry_field_get to check a field's type.

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

Inputs:

- `fieldname` (`string`, required): System name of the field. Example: accounttypecode.
- `id` (`integer`, required): Object number. Example: 1.

Example input: `{"fieldname":"<fieldname>","id":1}`

### `fireberry_invoice_items_list`

List Invoice Items · Read-only

List the line items of an invoice.
Returns data with each item's product, quantity and price.
Use fireberry_invoice_items_list after fireberry_invoices_list.

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

Inputs:

- `id` (`string`, required): GUID of the invoice. Example: 8f1e2d3c-4b5a-6978-8a9b-0c1d2e3f4a5b.

Example input: `{"id":"<id>"}`

### `fireberry_invoices_list`

List Invoices · Read-only

List invoices (object 81) a page at a time.
Returns data with Records[] and paging info.
Use fireberry_invoices_list for billing; get lines with fireberry_invoice_items_list.

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

Inputs:

- `page_number` (`integer`, optional): Page number, up to 10. Defaults to 1; use fireberry_records_query for larger result sets. Example: 1.
- `page_size` (`integer`, optional): Records per page, up to 50. Defaults to 50. Example: 50.

Example input: `{}`

### `fireberry_meetings_list`

List Meetings · Read-only

List meetings (object 6) a page at a time, up to 50 per page and 10 pages.
Returns data with Records[], Total_Records, Page_Size and Page_Number.
Use fireberry_meetings_list to browse. Use fireberry_records_query to filter or sort.

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

Inputs:

- `page_number` (`integer`, optional): Page number, up to 10. Defaults to 1; use fireberry_records_query for larger result sets. Example: 1.
- `page_size` (`integer`, optional): Records per page, up to 50. Defaults to 50. Example: 50.

Example input: `{}`

### `fireberry_notes_list`

List Notes · Read-only

List notes a page at a time, up to 50 per page and 10 pages.
Returns data with Records[], Total_Records, Page_Size and Page_Number.
Use fireberry_notes_list to browse. Use fireberry_records_query to filter or sort.

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

Inputs:

- `page_number` (`integer`, optional): Page number, up to 10. Defaults to 1; use fireberry_records_query for larger result sets. Example: 1.
- `page_size` (`integer`, optional): Records per page, up to 50. Defaults to 50. Example: 50.

Example input: `{}`

### `fireberry_object_fields_list`

List Object Fields · Read-only

List the fields of an object, including custom pcf fields.
Returns data with each field's system name, label and type.
Use fireberry_object_fields_list before creating or querying records to get exact field names.

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

Inputs:

- `id` (`integer`, required): Object number, for example 2 for contact. Example: 2.

Example input: `{"id":2}`

### `fireberry_object_get`

Get Object · Read-only

Get one object's metadata by object number.
Returns data with the object's names and settings.
Use fireberry_object_get to inspect an object.

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

Inputs:

- `id` (`integer`, required): Object number, for example 1 for account. Example: 1.

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

### `fireberry_objects_list`

List Objects · Read-only

List every object in the system, built-in and custom, with its object number.
Returns data with each object's name, system name and number.
Use fireberry_objects_list to find object numbers for queries and custom objects.

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

Inputs: none.

Example input: `{}`

### `fireberry_opportunities_list`

List Opportunities · Read-only

List opportunities (object 4) a page at a time, up to 50 per page and 10 pages.
Returns data with Records[], Total_Records, Page_Size and Page_Number.
Use fireberry_opportunities_list to browse. Use fireberry_records_query to filter or sort.

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

Inputs:

- `page_number` (`integer`, optional): Page number, up to 10. Defaults to 1; use fireberry_records_query for larger result sets. Example: 1.
- `page_size` (`integer`, optional): Records per page, up to 50. Defaults to 50. Example: 50.

Example input: `{}`

### `fireberry_opportunity_get`

Get Opportunity · Read-only

Get one opportunity by GUID.
Returns data with all of the record's fields.
Use fireberry_opportunity_get when you have the GUID.

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

Inputs:

- `id` (`string`, required): GUID of the opportunity. Example: 8f1e2d3c-4b5a-6978-8a9b-0c1d2e3f4a5b.

Example input: `{"id":"<id>"}`

### `fireberry_order_items_list`

List Order Items · Read-only

List the line items of an order.
Returns data with each item's product, quantity and price.
Use fireberry_order_items_list after fireberry_orders_list.

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

Inputs:

- `id` (`string`, required): GUID of the order. Example: 8f1e2d3c-4b5a-6978-8a9b-0c1d2e3f4a5b.

Example input: `{"id":"<id>"}`

### `fireberry_orders_list`

List Orders · Read-only

List orders (object 13) a page at a time.
Returns data with Records[] and paging info.
Use fireberry_orders_list to browse orders; get lines with fireberry_order_items_list.

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

Inputs:

- `page_number` (`integer`, optional): Page number, up to 10. Defaults to 1; use fireberry_records_query for larger result sets. Example: 1.
- `page_size` (`integer`, optional): Records per page, up to 50. Defaults to 50. Example: 50.

Example input: `{}`

### `fireberry_phone_calls_list`

List Phone Calls · Read-only

List phone calls (object 100) a page at a time, up to 50 per page and 10 pages.
Returns data with Records[], Total_Records, Page_Size and Page_Number.
Use fireberry_phone_calls_list to browse. Use fireberry_records_query to filter or sort.

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

Inputs:

- `page_number` (`integer`, optional): Page number, up to 10. Defaults to 1; use fireberry_records_query for larger result sets. Example: 1.
- `page_size` (`integer`, optional): Records per page, up to 50. Defaults to 50. Example: 50.

Example input: `{}`

### `fireberry_picklist_values_list`

List Picklist Values · Read-only

List the allowed values of a picklist field.
Returns data with each option's value code and label.
Use fireberry_picklist_values_list to find the integer codes for picklist fields such as statuscode.

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

Inputs:

- `fieldname` (`string`, required): System name of the picklist field. Example: statuscode.
- `id` (`integer`, required): Object number. Example: 1.

Example input: `{"fieldname":"<fieldname>","id":1}`

### `fireberry_products_list`

List Products · Read-only

List products (object 14) a page at a time, up to 50 per page and 10 pages.
Returns data with Records[], Total_Records, Page_Size and Page_Number.
Use fireberry_products_list to browse. Use fireberry_records_query to filter or sort.

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

Inputs:

- `page_number` (`integer`, optional): Page number, up to 10. Defaults to 1; use fireberry_records_query for larger result sets. Example: 1.
- `page_size` (`integer`, optional): Records per page, up to 50. Defaults to 50. Example: 50.

Example input: `{}`

### `fireberry_project_get`

Get Project · Read-only

Get one project by GUID.
Returns data with all of the record's fields.
Use fireberry_project_get when you have the GUID.

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

Inputs:

- `id` (`string`, required): GUID of the project. Example: 8f1e2d3c-4b5a-6978-8a9b-0c1d2e3f4a5b.

Example input: `{"id":"<id>"}`

### `fireberry_projects_list`

List Projects · Read-only

List projects (object 46) a page at a time, up to 50 per page and 10 pages.
Returns data with Records[], Total_Records, Page_Size and Page_Number.
Use fireberry_projects_list to browse. Use fireberry_records_query to filter or sort.

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

Inputs:

- `page_number` (`integer`, optional): Page number, up to 10. Defaults to 1; use fireberry_records_query for larger result sets. Example: 1.
- `page_size` (`integer`, optional): Records per page, up to 50. Defaults to 50. Example: 50.

Example input: `{}`

### `fireberry_record_get`

Get Record of Any Object · Read-only

Get one record of any object by GUID.
Returns data with all of the record's fields.
Use fireberry_record_get for objects without a dedicated get tool.

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

Inputs:

- `id` (`string`, required): GUID of the record. Example: 8f1e2d3c-4b5a-6978-8a9b-0c1d2e3f4a5b.
- `object` (`string`, required): Object system name or number: account (1), contact (2), opportunity (4), cases (tickets, 5), activity (meetings, 6), crmuser (users, 9), task (10), crmorder (orders, 13), product (14), contract (28), accountproduct (assets, 33), project (46), campaign (67), article (76), invoiceno (invoices, 81), calllog (phone calls, 100), activitylog (102), note, or a custom object's number. Example: account.

Example input: `{"id":"<id>","object":"<object>"}`

### `fireberry_records_list`

List Records of Any Object · Read-only

List records of any object, including custom objects, a page at a time (up to 50 per page and 10 pages).
Returns data with Records[], Total_Records, Page_Size and Page_Number.
Use fireberry_records_list for objects without a dedicated tool. Use fireberry_records_query to filter.

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

Inputs:

- `object` (`string`, required): Object system name or number: account (1), contact (2), opportunity (4), cases (tickets, 5), activity (meetings, 6), crmuser (users, 9), task (10), crmorder (orders, 13), product (14), contract (28), accountproduct (assets, 33), project (46), campaign (67), article (76), invoiceno (invoices, 81), calllog (phone calls, 100), activitylog (102), note, or a custom object's number. Example: account.
- `page_number` (`integer`, optional): Page number, up to 10. Defaults to 1; use fireberry_records_query for larger result sets. Example: 1.
- `page_size` (`integer`, optional): Records per page, up to 50. Defaults to 50. Example: 50.

Example input: `{"object":"<object>"}`

### `fireberry_records_query`

Query Records · Read-only

Search any object with filters, sorting, grouping, aggregation and paging (up to 500 per page).
Returns data with the matching records (or grouped results) and paging info.
Use fireberry_records_query to find records by field values. Use the *_list tools only to page through everything.

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

Inputs:

- `fields` (`array`, required): Fields to return, each {"name": <field>} and, with group_by, an optional aggrFunc (SUM, COUNT, MIN, MAX) and alias. Related fields use lookup_field, for example ownerid_fullname. Example: [{"name": "accountname"}, {"name": "ownerid_fullname"}].
- `object_type` (`integer`, required): Numeric object type to query: 1 account, 2 contact, 4 opportunity, 5 ticket, 6 meeting, 9 user, 10 task, 13 order, 14 product, 46 project, 100 phone call, or a custom object number. Example: 1.
- `filter` (`array`, optional): Condition groups joined with AND. Each group is {"type": "AND" or "OR", "conditions": [{"fieldName", "operator", "value"}]}; operators include eq, ne, gt, lt, start-with, contains, eq-in, not-in, between, is-null, is-not-null. Example: [{"type": "AND", "conditions": [{"fieldName": "accountname", "operator": "start-with", "value": "A"}]}].
- `group_by` (`array`, optional): Fields to group by, each {"name": <field>}; needed for aggregation. Example: [{"name": "statuscode"}].
- `order_by` (`array`, optional): Sort fields, each {"name": <field>, "direction": "asc" or "desc"}. Example: [{"name": "createdon", "direction": "desc"}].
- `page_number` (`integer`, optional): Page number. Defaults to 1. Example: 1.
- `page_size` (`integer`, optional): Records per page, 1 to 500. Defaults to 25. Example: 100.

Example input: `{"fields":[{"name":"accountname"},{"name":"ownerid_fullname"}],"object_type":1}`

### `fireberry_related_records_list`

List Related Records · Read-only

List the records of one object that are linked to a record, for example the contacts of an account.
Returns data with Records[] and paging info.
Use fireberry_related_records_list to walk relationships.

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

Inputs:

- `id` (`string`, required): GUID of the parent record. Example: 8f1e2d3c-4b5a-6978-8a9b-0c1d2e3f4a5b.
- `object_type` (`integer`, required): Object number of the parent record, for example 1 for account. Example: 1.
- `related_object_type` (`integer`, required): Object number of the related records to list, for example 2 for contacts. Example: 2.
- `page_number` (`integer`, optional): Page number, up to 10. Defaults to 1; use fireberry_records_query for larger result sets. Example: 1.
- `page_size` (`integer`, optional): Records per page, up to 50. Defaults to 50. Example: 50.

Example input: `{"id":"<id>","object_type":1,"related_object_type":2}`

### `fireberry_task_get`

Get Task · Read-only

Get one task by GUID.
Returns data with all of the record's fields.
Use fireberry_task_get when you have the GUID.

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

Inputs:

- `id` (`string`, required): GUID of the task. Example: 8f1e2d3c-4b5a-6978-8a9b-0c1d2e3f4a5b.

Example input: `{"id":"<id>"}`

### `fireberry_tasks_list`

List Tasks · Read-only

List tasks (object 10) a page at a time, up to 50 per page and 10 pages.
Returns data with Records[], Total_Records, Page_Size and Page_Number.
Use fireberry_tasks_list to browse. Use fireberry_records_query to filter or sort.

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

Inputs:

- `page_number` (`integer`, optional): Page number, up to 10. Defaults to 1; use fireberry_records_query for larger result sets. Example: 1.
- `page_size` (`integer`, optional): Records per page, up to 50. Defaults to 50. Example: 50.

Example input: `{}`

### `fireberry_ticket_get`

Get Ticket · Read-only

Get one ticket by GUID.
Returns data with all of the record's fields.
Use fireberry_ticket_get when you have the GUID.

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

Inputs:

- `id` (`string`, required): GUID of the ticket. Example: 8f1e2d3c-4b5a-6978-8a9b-0c1d2e3f4a5b.

Example input: `{"id":"<id>"}`

### `fireberry_tickets_list`

List Tickets · Read-only

List tickets (object 5) a page at a time, up to 50 per page and 10 pages.
Returns data with Records[], Total_Records, Page_Size and Page_Number.
Use fireberry_tickets_list to browse. Use fireberry_records_query to filter or sort. Tickets use the system name cases.

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

Inputs:

- `page_number` (`integer`, optional): Page number, up to 10. Defaults to 1; use fireberry_records_query for larger result sets. Example: 1.
- `page_size` (`integer`, optional): Records per page, up to 50. Defaults to 50. Example: 50.

Example input: `{}`

### `fireberry_users_list`

List Users · Read-only

List the system users (object 9).
Returns data with Records[] of users with GUID, full name and email.
Use fireberry_users_list to get owner GUIDs for ownerid and assignedtoid.

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

Inputs:

- `page_number` (`integer`, optional): Page number, up to 10. Defaults to 1; use fireberry_records_query for larger result sets. Example: 1.
- `page_size` (`integer`, optional): Records per page, up to 50. Defaults to 50. Example: 50.

Example input: `{}`

### `fireberry_account_create`

Create Account · Write

Create a account.
Returns data with the new record, including its GUID.
Use fireberry_account_create to add a account; set extra or custom fields with custom_fields.

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

Inputs:

- `accountname` (`string`, required): Name of the account (Primary). Example: Acme Ltd.
- `accountnumber` (`string`, optional): Used for identification, unique values are recommended. Example: ACC-1001.
- `accounttypecode` (`integer`, optional): Account type (Picklist). Example: 1.
- `billingcity` (`string`, optional): Billing city. Example: Tel Aviv.
- `billingcountry` (`string`, optional): Billing country. Example: Israel.
- `billingstreet` (`string`, optional): Billing street. Example: Rothschild 1.
- `billingzipcode` (`string`, optional): Billing zip code. Example: 6688101.
- `custom_fields` (`object`, optional): Extra fields to set, keyed by field name, such as custom pcf fields or picklist codes not listed above. Get field names from fireberry_object_fields_list. Example: {"pcfsystemfield12": "Gold"}.
- `description` (`string`, optional): Description of up to 4,000 characters. Example: Key account, renewal due in Q1.
- `emailaddress1` (`string`, optional): Primary email address, must be in email format. Example: info@acme.example.
- `firstname` (`string`, optional): First name. Example: Dana.
- `industrycode` (`integer`, optional): Industry (Picklist). Example: 1.
- `lastname` (`string`, optional): Last name. Example: Levi.
- `originatingleadcode` (`integer`, optional): Lead source (Picklist). Example: 1.
- `ownerid` (`string`, optional): GUID of the user who owns the record; defaults to the token's user. Example: 3b6b3b37-41fa-413e-bb42-f802128cc092.
- `parentaccountid` (`string`, optional): The parent account's GUID. Example: 8f1e2d3c-4b5a-6978-8a9b-0c1d2e3f4a5b.
- `primarycontactid` (`string`, optional): The primary contact's GUID. Example: 8f1e2d3c-4b5a-6978-8a9b-0c1d2e3f4a5b.
- `statuscode` (`integer`, optional): Status of the account (Picklist). Example: 1.
- `telephone1` (`string`, optional): Primary phone number, contains exclusively numbers. Example: +97231234567.

Example input: `{"accountname":"<accountname>"}`

### `fireberry_account_update`

Update Account · Write

Update a account; fields you leave out keep their values, but the reference requires the primary field on every update.
Returns data with the updated record.
Use fireberry_account_update to change fields; set custom fields with custom_fields.

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

Inputs:

- `accountname` (`string`, required): Name of the account (Primary). Example: Acme Ltd.
- `id` (`string`, required): GUID of the account. Example: 8f1e2d3c-4b5a-6978-8a9b-0c1d2e3f4a5b.
- `accountnumber` (`string`, optional): Used for identification, unique values are recommended. Example: ACC-1001.
- `accounttypecode` (`integer`, optional): Account type (Picklist). Example: 1.
- `billingcity` (`string`, optional): Billing city. Example: Tel Aviv.
- `billingcountry` (`string`, optional): Billing country. Example: Israel.
- `billingstreet` (`string`, optional): Billing street. Example: Rothschild 1.
- `billingzipcode` (`string`, optional): Billing zip code. Example: 6688101.
- `custom_fields` (`object`, optional): Extra fields to set, keyed by field name, such as custom pcf fields or picklist codes not listed above. Get field names from fireberry_object_fields_list. Example: {"pcfsystemfield12": "Gold"}.
- `description` (`string`, optional): Description of up to 4,000 characters. Example: Key account, renewal due in Q1.
- `emailaddress1` (`string`, optional): Primary email address, must be in email format. Example: info@acme.example.
- `firstname` (`string`, optional): First name. Example: Dana.
- `industrycode` (`integer`, optional): Industry (Picklist). Example: 1.
- `lastname` (`string`, optional): Last name. Example: Levi.
- `originatingleadcode` (`integer`, optional): Lead source (Picklist). Example: 1.
- `ownerid` (`string`, optional): GUID of the user who owns the record; defaults to the token's user. Example: 3b6b3b37-41fa-413e-bb42-f802128cc092.
- `parentaccountid` (`string`, optional): The parent account's GUID. Example: 8f1e2d3c-4b5a-6978-8a9b-0c1d2e3f4a5b.
- `primarycontactid` (`string`, optional): The primary contact's GUID. Example: 8f1e2d3c-4b5a-6978-8a9b-0c1d2e3f4a5b.
- `statuscode` (`integer`, optional): Status of the account (Picklist). Example: 1.
- `telephone1` (`string`, optional): Primary phone number, contains exclusively numbers. Example: +97231234567.

Example input: `{"accountname":"<accountname>","id":"<id>"}`

### `fireberry_contact_create`

Create Contact · Write

Create a contact.
Returns data with the new record, including its GUID.
Use fireberry_contact_create to add a contact; set extra or custom fields with custom_fields.

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

Inputs:

- `firstname` (`string`, required): First name of the contact. Example: Dana.
- `accountid` (`string`, optional): The related account's GUID. Example: 8f1e2d3c-4b5a-6978-8a9b-0c1d2e3f4a5b.
- `billingcity` (`string`, optional): Billing city. Example: Tel Aviv.
- `billingcountry` (`string`, optional): Billing country. Example: Israel.
- `billingstreet` (`string`, optional): Billing street. Example: Rothschild 1.
- `companyname` (`string`, optional): Company name. Example: Acme Ltd.
- `custom_fields` (`object`, optional): Extra fields to set, keyed by field name, such as custom pcf fields or picklist codes not listed above. Get field names from fireberry_object_fields_list. Example: {"pcfsystemfield12": "Gold"}.
- `department` (`string`, optional): Department. Example: Finance.
- `description` (`string`, optional): Description of up to 4,000 characters. Example: Key account, renewal due in Q1.
- `emailaddress1` (`string`, optional): Primary email address, must be in email format. Example: info@acme.example.
- `gendercode` (`integer`, optional): Gender of the contact (Picklist). Example: 1.
- `jobtitle` (`string`, optional): Job title. Example: CFO.
- `lastname` (`string`, optional): Last name. Example: Levi.
- `mobilephone1` (`string`, optional): Primary mobile phone number. Example: +972501234567.
- `ownerid` (`string`, optional): GUID of the user who owns the record; defaults to the token's user. Example: 3b6b3b37-41fa-413e-bb42-f802128cc092.
- `telephone1` (`string`, optional): Primary phone number, contains exclusively numbers. Example: +97231234567.
- `websiteurl` (`string`, optional): Website of the contact in URL format. Example: https://acme.example.

Example input: `{"firstname":"<firstname>"}`

### `fireberry_contact_update`

Update Contact · Write

Update a contact; fields you leave out keep their values, but the reference requires the primary field on every update.
Returns data with the updated record.
Use fireberry_contact_update to change fields; set custom fields with custom_fields.

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

Inputs:

- `firstname` (`string`, required): First name of the contact. Example: Dana.
- `id` (`string`, required): GUID of the contact. Example: 8f1e2d3c-4b5a-6978-8a9b-0c1d2e3f4a5b.
- `accountid` (`string`, optional): The related account's GUID. Example: 8f1e2d3c-4b5a-6978-8a9b-0c1d2e3f4a5b.
- `billingcity` (`string`, optional): Billing city. Example: Tel Aviv.
- `billingcountry` (`string`, optional): Billing country. Example: Israel.
- `billingstreet` (`string`, optional): Billing street. Example: Rothschild 1.
- `companyname` (`string`, optional): Company name. Example: Acme Ltd.
- `custom_fields` (`object`, optional): Extra fields to set, keyed by field name, such as custom pcf fields or picklist codes not listed above. Get field names from fireberry_object_fields_list. Example: {"pcfsystemfield12": "Gold"}.
- `department` (`string`, optional): Department. Example: Finance.
- `description` (`string`, optional): Description of up to 4,000 characters. Example: Key account, renewal due in Q1.
- `emailaddress1` (`string`, optional): Primary email address, must be in email format. Example: info@acme.example.
- `gendercode` (`integer`, optional): Gender of the contact (Picklist). Example: 1.
- `jobtitle` (`string`, optional): Job title. Example: CFO.
- `lastname` (`string`, optional): Last name. Example: Levi.
- `mobilephone1` (`string`, optional): Primary mobile phone number. Example: +972501234567.
- `ownerid` (`string`, optional): GUID of the user who owns the record; defaults to the token's user. Example: 3b6b3b37-41fa-413e-bb42-f802128cc092.
- `telephone1` (`string`, optional): Primary phone number, contains exclusively numbers. Example: +97231234567.
- `websiteurl` (`string`, optional): Website of the contact in URL format. Example: https://acme.example.

Example input: `{"firstname":"<firstname>","id":"<id>"}`

### `fireberry_meeting_create`

Create Meeting · Write

Create a meeting.
Returns data with the new record, including its GUID.
Use fireberry_meeting_create to add a meeting; set extra or custom fields with custom_fields.

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

Inputs:

- `subject` (`string`, required): The subject of the meeting (Primary). Example: Follow up on the proposal.
- `activitytypecode` (`integer`, optional): The type of activity (Picklist). Example: 1.
- `custom_fields` (`object`, optional): Extra fields to set, keyed by field name, such as custom pcf fields or picklist codes not listed above. Get field names from fireberry_object_fields_list. Example: {"pcfsystemfield12": "Gold"}.
- `description` (`string`, optional): Description of up to 4,000 characters. Example: Key account, renewal due in Q1.
- `location` (`string`, optional): Location. Example: Acme HQ.
- `objectid` (`string`, optional): The GUID of the record related to the meeting. Example: 8f1e2d3c-4b5a-6978-8a9b-0c1d2e3f4a5b.
- `objecttypecode` (`integer`, optional): Object number of the object the related record belongs to. If you set the objectid field, you MUST set this field as well. Example: 1.
- `ownerid` (`string`, optional): GUID of the user who owns the record; defaults to the token's user. Example: 3b6b3b37-41fa-413e-bb42-f802128cc092.
- `prioritycode` (`integer`, optional): Priority of the meeting (Picklist). Example: 2.
- `scheduledend` (`string`, optional): Date and time the meeting ends. Example: 2026-12-02T10:00:00.
- `scheduledstart` (`string`, optional): Date and time the meeting starts. Example: 2026-12-02T09:00:00.
- `statuscode` (`integer`, optional): Status (Picklist). Example: 1.

Example input: `{"subject":"<subject>"}`

### `fireberry_meeting_update`

Update Meeting · Write

Update a meeting; fields you leave out keep their values, but the reference requires the primary field on every update.
Returns data with the updated record.
Use fireberry_meeting_update to change fields; set custom fields with custom_fields.

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

Inputs:

- `id` (`string`, required): GUID of the meeting. Example: 8f1e2d3c-4b5a-6978-8a9b-0c1d2e3f4a5b.
- `subject` (`string`, required): The subject of the meeting (Primary). Example: Follow up on the proposal.
- `activitytypecode` (`integer`, optional): The type of activity (Picklist). Example: 1.
- `custom_fields` (`object`, optional): Extra fields to set, keyed by field name, such as custom pcf fields or picklist codes not listed above. Get field names from fireberry_object_fields_list. Example: {"pcfsystemfield12": "Gold"}.
- `description` (`string`, optional): Description of up to 4,000 characters. Example: Key account, renewal due in Q1.
- `location` (`string`, optional): Location. Example: Acme HQ.
- `objectid` (`string`, optional): The GUID of the record related to the meeting. Example: 8f1e2d3c-4b5a-6978-8a9b-0c1d2e3f4a5b.
- `objecttypecode` (`integer`, optional): Object number of the object the related record belongs to. If you set the objectid field, you MUST set this field as well. Example: 1.
- `ownerid` (`string`, optional): GUID of the user who owns the record; defaults to the token's user. Example: 3b6b3b37-41fa-413e-bb42-f802128cc092.
- `prioritycode` (`integer`, optional): Priority of the meeting (Picklist). Example: 2.
- `scheduledend` (`string`, optional): Date and time the meeting ends. Example: 2026-12-02T10:00:00.
- `scheduledstart` (`string`, optional): Date and time the meeting starts. Example: 2026-12-02T09:00:00.
- `statuscode` (`integer`, optional): Status (Picklist). Example: 1.

Example input: `{"id":"<id>","subject":"<subject>"}`

### `fireberry_note_create`

Create Note · Write

Create a note.
Returns data with the new record, including its GUID.
Use fireberry_note_create to add a note; set extra or custom fields with custom_fields.

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

Inputs:

- `notetext` (`string`, required): Content of the note, to format use HTML (Primary). Example: Customer asked for a discount.
.
- `custom_fields` (`object`, optional): Extra fields to set, keyed by field name, such as custom pcf fields or picklist codes not listed above. Get field names from fireberry_object_fields_list. Example: {"pcfsystemfield12": "Gold"}.
- `objectid` (`string`, optional): The GUID of the record related to the note. Example: 8f1e2d3c-4b5a-6978-8a9b-0c1d2e3f4a5b.
- `objecttypecode` (`integer`, optional): Object number of the object the related record belongs to. If you set the objectid field, you MUST set this field as well. Example: 1.

Example input: `{"notetext":"<notetext>"}`

### `fireberry_opportunity_create`

Create Opportunity · Write

Create a opportunity.
Returns data with the new record, including its GUID.
Use fireberry_opportunity_create to add a opportunity; set extra or custom fields with custom_fields.

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

Inputs:

- `accountid` (`string`, required): The related account's GUID. Example: 8f1e2d3c-4b5a-6978-8a9b-0c1d2e3f4a5b.
- `name` (`string`, required): Name of the opportunity (Primary). Example: Acme renewal 2027.
- `closeprobability` (`number`, optional): Probability the opportunity will close successfully. Example: 60.
- `contacttid` (`string`, optional): The related contact's GUID. Example: 8f1e2d3c-4b5a-6978-8a9b-0c1d2e3f4a5b.
- `custom_fields` (`object`, optional): Extra fields to set, keyed by field name, such as custom pcf fields or picklist codes not listed above. Get field names from fireberry_object_fields_list. Example: {"pcfsystemfield12": "Gold"}.
- `description` (`string`, optional): Description of up to 4,000 characters. Example: Key account, renewal due in Q1.
- `estimatedclosedate` (`string`, optional): Estimated date and time the deal will be closed by. Example: 2026-12-31T00:00:00.
- `estimatedvalue` (`number`, optional): Estimated total value of the deal. Example: 25000.
- `ownerid` (`string`, optional): GUID of the user who owns the record; defaults to the token's user. Example: 3b6b3b37-41fa-413e-bb42-f802128cc092.
- `statuscode` (`integer`, optional): Status (Picklist). Example: 1.

Example input: `{"accountid":"<accountid>","name":"<name>"}`

### `fireberry_opportunity_update`

Update Opportunity · Write

Update a opportunity; fields you leave out keep their values, but the reference requires the primary field on every update.
Returns data with the updated record.
Use fireberry_opportunity_update to change fields; set custom fields with custom_fields.

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

Inputs:

- `accountid` (`string`, required): The related account's GUID. Example: 8f1e2d3c-4b5a-6978-8a9b-0c1d2e3f4a5b.
- `id` (`string`, required): GUID of the opportunity. Example: 8f1e2d3c-4b5a-6978-8a9b-0c1d2e3f4a5b.
- `name` (`string`, required): Name of the opportunity (Primary). Example: Acme renewal 2027.
- `closeprobability` (`number`, optional): Probability the opportunity will close successfully. Example: 60.
- `contacttid` (`string`, optional): The related contact's GUID. Example: 8f1e2d3c-4b5a-6978-8a9b-0c1d2e3f4a5b.
- `custom_fields` (`object`, optional): Extra fields to set, keyed by field name, such as custom pcf fields or picklist codes not listed above. Get field names from fireberry_object_fields_list. Example: {"pcfsystemfield12": "Gold"}.
- `description` (`string`, optional): Description of up to 4,000 characters. Example: Key account, renewal due in Q1.
- `estimatedclosedate` (`string`, optional): Estimated date and time the deal will be closed by. Example: 2026-12-31T00:00:00.
- `estimatedvalue` (`number`, optional): Estimated total value of the deal. Example: 25000.
- `ownerid` (`string`, optional): GUID of the user who owns the record; defaults to the token's user. Example: 3b6b3b37-41fa-413e-bb42-f802128cc092.
- `statuscode` (`integer`, optional): Status (Picklist). Example: 1.

Example input: `{"accountid":"<accountid>","id":"<id>","name":"<name>"}`

### `fireberry_phone_call_create`

Create Phone Call · Write

Create a phone call.
Returns data with the new record, including its GUID.
Use fireberry_phone_call_create to add a phone call; set extra or custom fields with custom_fields.

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

Inputs:

- `ivruniqueid` (`string`, required): The ID of the phone call. Example: call-2026-11-16-0001.
- `accountid` (`string`, optional): The related account's GUID. Example: 8f1e2d3c-4b5a-6978-8a9b-0c1d2e3f4a5b.
- `callerid` (`string`, optional): The phone number the call originated from (Primary). Example: +97231234567.
- `contactid` (`string`, optional): The related contact's GUID. Example: 8f1e2d3c-4b5a-6978-8a9b-0c1d2e3f4a5b.
- `custom_fields` (`object`, optional): Extra fields to set, keyed by field name, such as custom pcf fields or picklist codes not listed above. Get field names from fireberry_object_fields_list. Example: {"pcfsystemfield12": "Gold"}.
- `duration` (`number`, optional): The duration of the call in seconds, does not include the dial time. Example: 180.
- `ownerid` (`string`, optional): GUID of the user who owns the record; defaults to the token's user. Example: 3b6b3b37-41fa-413e-bb42-f802128cc092.
- `recordurl` (`string`, optional): A link to a recording of the call, must be in URL format. Example: https://recordings.example.com/0001.mp3.
- `status` (`integer`, optional): The status of the call, use 1 for Answered, 2 for Busy, 3 for Missed, 4 for Cancelled, 5 for Disconnected Number, and 7 for Left Message. Example: 1.
- `targetid` (`string`, optional): The phone number receiving the call. Example: +97237654321.
- `type` (`integer`, optional): The type of the call, use 1 for Incoming, 2 for Outgoing, and 3 for Internal. Example: 1.

Example input: `{"ivruniqueid":"<ivruniqueid>"}`

### `fireberry_phone_call_update`

Update Phone Call · Write

Update a phone call; fields you leave out keep their values, but the reference requires the primary field on every update.
Returns data with the updated record.
Use fireberry_phone_call_update to change fields; set custom fields with custom_fields.

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

Inputs:

- `id` (`string`, required): GUID of the phone call. Example: 8f1e2d3c-4b5a-6978-8a9b-0c1d2e3f4a5b.
- `ivruniqueid` (`string`, required): The ID of the phone call. Example: call-2026-11-16-0001.
- `accountid` (`string`, optional): The related account's GUID. Example: 8f1e2d3c-4b5a-6978-8a9b-0c1d2e3f4a5b.
- `callerid` (`string`, optional): The phone number the call originated from (Primary). Example: +97231234567.
- `contactid` (`string`, optional): The related contact's GUID. Example: 8f1e2d3c-4b5a-6978-8a9b-0c1d2e3f4a5b.
- `custom_fields` (`object`, optional): Extra fields to set, keyed by field name, such as custom pcf fields or picklist codes not listed above. Get field names from fireberry_object_fields_list. Example: {"pcfsystemfield12": "Gold"}.
- `duration` (`number`, optional): The duration of the call in seconds, does not include the dial time. Example: 180.
- `ownerid` (`string`, optional): GUID of the user who owns the record; defaults to the token's user. Example: 3b6b3b37-41fa-413e-bb42-f802128cc092.
- `recordurl` (`string`, optional): A link to a recording of the call, must be in URL format. Example: https://recordings.example.com/0001.mp3.
- `status` (`integer`, optional): The status of the call, use 1 for Answered, 2 for Busy, 3 for Missed, 4 for Cancelled, 5 for Disconnected Number, and 7 for Left Message. Example: 1.
- `targetid` (`string`, optional): The phone number receiving the call. Example: +97237654321.
- `type` (`integer`, optional): The type of the call, use 1 for Incoming, 2 for Outgoing, and 3 for Internal. Example: 1.

Example input: `{"id":"<id>","ivruniqueid":"<ivruniqueid>"}`

### `fireberry_product_create`

Create Product · Write

Create a product.
Returns data with the new record, including its GUID.
Use fireberry_product_create to add a product; set extra or custom fields with custom_fields.

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

Inputs:

- `name` (`string`, required): Name of the product (Primary). Example: Acme renewal 2027.
- `catalognumber` (`string`, optional): Catalog Number. Example: SKU-100.
- `categorycode` (`integer`, optional): The category the product belongs to (Picklist). Example: 1.
- `custom_fields` (`object`, optional): Extra fields to set, keyed by field name, such as custom pcf fields or picklist codes not listed above. Get field names from fireberry_object_fields_list. Example: {"pcfsystemfield12": "Gold"}.
- `description` (`string`, optional): Description of up to 4,000 characters. Example: Key account, renewal due in Q1.
- `itemprice` (`number`, optional): The price of one unit of the product. Example: 199.9.
- `ownerid` (`string`, optional): GUID of the user who owns the record; defaults to the token's user. Example: 3b6b3b37-41fa-413e-bb42-f802128cc092.
- `statuscode` (`integer`, optional): Status of the product. If set to inactive, this product will not appear in the list of products in orders and invoices. Example: 1.
- `vendorname` (`string`, optional): Name of the vendor. Example: Acme Supplies.

Example input: `{"name":"<name>"}`

### `fireberry_product_update`

Update Product · Write

Update a product; fields you leave out keep their values, but the reference requires the primary field on every update.
Returns data with the updated record.
Use fireberry_product_update to change fields; set custom fields with custom_fields.

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

Inputs:

- `id` (`string`, required): GUID of the product. Example: 8f1e2d3c-4b5a-6978-8a9b-0c1d2e3f4a5b.
- `name` (`string`, required): Name of the product (Primary). Example: Acme renewal 2027.
- `catalognumber` (`string`, optional): Catalog Number. Example: SKU-100.
- `categorycode` (`integer`, optional): The category the product belongs to (Picklist). Example: 1.
- `custom_fields` (`object`, optional): Extra fields to set, keyed by field name, such as custom pcf fields or picklist codes not listed above. Get field names from fireberry_object_fields_list. Example: {"pcfsystemfield12": "Gold"}.
- `description` (`string`, optional): Description of up to 4,000 characters. Example: Key account, renewal due in Q1.
- `itemprice` (`number`, optional): The price of one unit of the product. Example: 199.9.
- `ownerid` (`string`, optional): GUID of the user who owns the record; defaults to the token's user. Example: 3b6b3b37-41fa-413e-bb42-f802128cc092.
- `statuscode` (`integer`, optional): Status of the product. If set to inactive, this product will not appear in the list of products in orders and invoices. Example: 1.
- `vendorname` (`string`, optional): Name of the vendor. Example: Acme Supplies.

Example input: `{"id":"<id>","name":"<name>"}`

### `fireberry_project_create`

Create Project · Write

Create a project.
Returns data with the new record, including its GUID.
Use fireberry_project_create to add a project; set extra or custom fields with custom_fields.

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

Inputs:

- `projectname` (`string`, required): Name of the project (Primary). Example: Website relaunch.
- `accountid` (`string`, optional): The related account's GUID. Example: 8f1e2d3c-4b5a-6978-8a9b-0c1d2e3f4a5b.
- `budget` (`number`, optional): Budget. Example: 50000.
- `custom_fields` (`object`, optional): Extra fields to set, keyed by field name, such as custom pcf fields or picklist codes not listed above. Get field names from fireberry_object_fields_list. Example: {"pcfsystemfield12": "Gold"}.
- `duedate` (`string`, optional): Date the project must be completed by. Example: 2027-03-01T00:00:00.
- `ownerid` (`string`, optional): GUID of the user who owns the record; defaults to the token's user. Example: 3b6b3b37-41fa-413e-bb42-f802128cc092.
- `priority` (`integer`, optional): Priority (Picklist). Example: 1.
- `statuscode` (`integer`, optional): Status (Picklist). Example: 1.

Example input: `{"projectname":"<projectname>"}`

### `fireberry_record_create`

Create Record of Any Object · Write

Create a record of any object, including custom objects, from a fields object.
Returns data with the new record and its GUID.
Use fireberry_record_create for objects without a dedicated create tool; get field names from fireberry_object_fields_list.

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

Inputs:

- `fields` (`object`, required): Field values keyed by field name. Example: {"name": "Gold membership", "pcfsystemfield3": "2027-01-01"}.
- `object` (`string`, required): Object system name or number: account (1), contact (2), opportunity (4), cases (tickets, 5), activity (meetings, 6), crmuser (users, 9), task (10), crmorder (orders, 13), product (14), contract (28), accountproduct (assets, 33), project (46), campaign (67), article (76), invoiceno (invoices, 81), calllog (phone calls, 100), activitylog (102), note, or a custom object's number. Example: account.

Example input: `{"fields":{"name":"Gold membership","pcfsystemfield3":"2027-01-01"},"object":"<object>"}`

### `fireberry_record_update`

Update Record of Any Object · Write

Update a record of any object; only the fields you send change.
Returns data with the updated record.
Use fireberry_record_update for objects without a dedicated update tool.

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

Inputs:

- `fields` (`object`, required): Field values to change, keyed by field name. Example: {"statuscode": 2}.
- `id` (`string`, required): GUID of the record. Example: 8f1e2d3c-4b5a-6978-8a9b-0c1d2e3f4a5b.
- `object` (`string`, required): Object system name or number: account (1), contact (2), opportunity (4), cases (tickets, 5), activity (meetings, 6), crmuser (users, 9), task (10), crmorder (orders, 13), product (14), contract (28), accountproduct (assets, 33), project (46), campaign (67), article (76), invoiceno (invoices, 81), calllog (phone calls, 100), activitylog (102), note, or a custom object's number. Example: account.

Example input: `{"fields":{"statuscode":2},"id":"<id>","object":"<object>"}`

### `fireberry_task_create`

Create Task · Write

Create a task.
Returns data with the new record, including its GUID.
Use fireberry_task_create to add a task; set extra or custom fields with custom_fields.

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

Inputs:

- `subject` (`string`, required): Subject of the task (Primary). Example: Follow up on the proposal.
- `custom_fields` (`object`, optional): Extra fields to set, keyed by field name, such as custom pcf fields or picklist codes not listed above. Get field names from fireberry_object_fields_list. Example: {"pcfsystemfield12": "Gold"}.
- `description` (`string`, optional): Description of up to 4,000 characters. Example: Key account, renewal due in Q1.
- `objectid` (`string`, optional): The related record's GUID. Can belong to any editable system object type. Example: 8f1e2d3c-4b5a-6978-8a9b-0c1d2e3f4a5b.
- `objecttypecode` (`integer`, optional): Object number of the object the related record belongs to. If you set the objectid field, you MUST set this field as well. Example: 1.
- `ownerid` (`string`, optional): GUID of the user who owns the record; defaults to the token's user. Example: 3b6b3b37-41fa-413e-bb42-f802128cc092.
- `prioritycode` (`integer`, optional): Priority (Picklist). Example: 2.
- `reminderdate` (`string`, optional): Date and time the owner will be reminded of the task. Example: 2026-12-01T09:00:00.
- `scheduledend` (`string`, optional): Date and time the task is scheduled to be completed by. Example: 2026-12-02T10:00:00.
- `statuscode` (`integer`, optional): Status (Picklist). Example: 1.
- `tasktypecode` (`integer`, optional): Type (Picklist). Example: 1.

Example input: `{"subject":"<subject>"}`

### `fireberry_task_update`

Update Task · Write

Update a task; fields you leave out keep their values, but the reference requires the primary field on every update.
Returns data with the updated record.
Use fireberry_task_update to change fields; set custom fields with custom_fields.

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

Inputs:

- `id` (`string`, required): GUID of the task. Example: 8f1e2d3c-4b5a-6978-8a9b-0c1d2e3f4a5b.
- `subject` (`string`, required): Subject of the task (Primary). Example: Follow up on the proposal.
- `custom_fields` (`object`, optional): Extra fields to set, keyed by field name, such as custom pcf fields or picklist codes not listed above. Get field names from fireberry_object_fields_list. Example: {"pcfsystemfield12": "Gold"}.
- `description` (`string`, optional): Description of up to 4,000 characters. Example: Key account, renewal due in Q1.
- `objectid` (`string`, optional): The related record's GUID. Can belong to any editable system object type. Example: 8f1e2d3c-4b5a-6978-8a9b-0c1d2e3f4a5b.
- `objecttypecode` (`integer`, optional): Object number of the object the related record belongs to. If you set the objectid field, you MUST set this field as well. Example: 1.
- `ownerid` (`string`, optional): GUID of the user who owns the record; defaults to the token's user. Example: 3b6b3b37-41fa-413e-bb42-f802128cc092.
- `prioritycode` (`integer`, optional): Priority (Picklist). Example: 2.
- `reminderdate` (`string`, optional): Date and time the owner will be reminded of the task. Example: 2026-12-01T09:00:00.
- `scheduledend` (`string`, optional): Date and time the task is scheduled to be completed by. Example: 2026-12-02T10:00:00.
- `statuscode` (`integer`, optional): Status (Picklist). Example: 1.
- `tasktypecode` (`integer`, optional): Type (Picklist). Example: 1.

Example input: `{"id":"<id>","subject":"<subject>"}`

### `fireberry_ticket_create`

Create Ticket · Write

Create a ticket.
Returns data with the new record, including its GUID.
Use fireberry_ticket_create to add a ticket; set extra or custom fields with custom_fields.

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

Inputs:

- `title` (`string`, required): Ticket title (Primary). Example: Cannot log in to the portal.
- `accountid` (`string`, optional): The related account's GUID. Example: 8f1e2d3c-4b5a-6978-8a9b-0c1d2e3f4a5b.
- `assignedtoid` (`string`, optional): The GUID of the system user the task is assigned to. Example: 3b6b3b37-41fa-413e-bb42-f802128cc092.
- `casesourcecode` (`integer`, optional): Ticket source (Picklist). Example: 1.
- `casetypecode` (`integer`, optional): Ticket type (Picklist). Example: 1.
- `contactid` (`string`, optional): The related contact's GUID. Example: 8f1e2d3c-4b5a-6978-8a9b-0c1d2e3f4a5b.
- `custom_fields` (`object`, optional): Extra fields to set, keyed by field name, such as custom pcf fields or picklist codes not listed above. Get field names from fireberry_object_fields_list. Example: {"pcfsystemfield12": "Gold"}.
- `description` (`string`, optional): Description of up to 4,000 characters. Example: Key account, renewal due in Q1.
- `ownerid` (`string`, optional): GUID of the user who owns the record; defaults to the token's user. Example: 3b6b3b37-41fa-413e-bb42-f802128cc092.
- `prioritycode` (`integer`, optional): Priority (PIcklist). Example: 2.
- `statuscode` (`integer`, optional): Status (Picklist). Example: 1.

Example input: `{"title":"<title>"}`

### `fireberry_ticket_update`

Update Ticket · Write

Update a ticket; fields you leave out keep their values, but the reference requires the primary field on every update.
Returns data with the updated record.
Use fireberry_ticket_update to change fields; set custom fields with custom_fields.

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

Inputs:

- `id` (`string`, required): GUID of the ticket. Example: 8f1e2d3c-4b5a-6978-8a9b-0c1d2e3f4a5b.
- `title` (`string`, required): Ticket title (Primary). Example: Cannot log in to the portal.
- `accountid` (`string`, optional): The related account's GUID. Example: 8f1e2d3c-4b5a-6978-8a9b-0c1d2e3f4a5b.
- `assignedtoid` (`string`, optional): The GUID of the system user the task is assigned to. Example: 3b6b3b37-41fa-413e-bb42-f802128cc092.
- `casesourcecode` (`integer`, optional): Ticket source (Picklist). Example: 1.
- `casetypecode` (`integer`, optional): Ticket type (Picklist). Example: 1.
- `contactid` (`string`, optional): The related contact's GUID. Example: 8f1e2d3c-4b5a-6978-8a9b-0c1d2e3f4a5b.
- `custom_fields` (`object`, optional): Extra fields to set, keyed by field name, such as custom pcf fields or picklist codes not listed above. Get field names from fireberry_object_fields_list. Example: {"pcfsystemfield12": "Gold"}.
- `description` (`string`, optional): Description of up to 4,000 characters. Example: Key account, renewal due in Q1.
- `ownerid` (`string`, optional): GUID of the user who owns the record; defaults to the token's user. Example: 3b6b3b37-41fa-413e-bb42-f802128cc092.
- `prioritycode` (`integer`, optional): Priority (PIcklist). Example: 2.
- `statuscode` (`integer`, optional): Status (Picklist). Example: 1.

Example input: `{"id":"<id>","title":"<title>"}`

### `fireberry_account_delete`

Delete Account · Destructive

Delete a account.
Returns success.
Use fireberry_account_delete to remove a record permanently.

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

Inputs:

- `id` (`string`, required): GUID of the account. Example: 8f1e2d3c-4b5a-6978-8a9b-0c1d2e3f4a5b.

Example input: `{"id":"<id>"}`

### `fireberry_contact_delete`

Delete Contact · Destructive

Delete a contact.
Returns success.
Use fireberry_contact_delete to remove a record permanently.

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

Inputs:

- `id` (`string`, required): GUID of the contact. Example: 8f1e2d3c-4b5a-6978-8a9b-0c1d2e3f4a5b.

Example input: `{"id":"<id>"}`

### `fireberry_meeting_delete`

Delete Meeting · Destructive

Delete a meeting.
Returns success.
Use fireberry_meeting_delete to remove a record permanently.

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

Inputs:

- `id` (`string`, required): GUID of the meeting. Example: 8f1e2d3c-4b5a-6978-8a9b-0c1d2e3f4a5b.

Example input: `{"id":"<id>"}`

### `fireberry_note_delete`

Delete Note · Destructive

Delete a note.
Returns success.
Use fireberry_note_delete to remove a record permanently.

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

Inputs:

- `id` (`string`, required): GUID of the note. Example: 8f1e2d3c-4b5a-6978-8a9b-0c1d2e3f4a5b.

Example input: `{"id":"<id>"}`

### `fireberry_opportunity_delete`

Delete Opportunity · Destructive

Delete a opportunity.
Returns success.
Use fireberry_opportunity_delete to remove a record permanently.

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

Inputs:

- `id` (`string`, required): GUID of the opportunity. Example: 8f1e2d3c-4b5a-6978-8a9b-0c1d2e3f4a5b.

Example input: `{"id":"<id>"}`

### `fireberry_record_delete`

Delete Record of Any Object · Destructive

Delete a record of any object.
Returns success.
Use fireberry_record_delete for objects without a dedicated delete tool.

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

Inputs:

- `id` (`string`, required): GUID of the record. Example: 8f1e2d3c-4b5a-6978-8a9b-0c1d2e3f4a5b.
- `object` (`string`, required): Object system name or number: account (1), contact (2), opportunity (4), cases (tickets, 5), activity (meetings, 6), crmuser (users, 9), task (10), crmorder (orders, 13), product (14), contract (28), accountproduct (assets, 33), project (46), campaign (67), article (76), invoiceno (invoices, 81), calllog (phone calls, 100), activitylog (102), note, or a custom object's number. Example: account.

Example input: `{"id":"<id>","object":"<object>"}`

### `fireberry_task_delete`

Delete Task · Destructive

Delete a task.
Returns success.
Use fireberry_task_delete to remove a record permanently.

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

Inputs:

- `id` (`string`, required): GUID of the task. Example: 8f1e2d3c-4b5a-6978-8a9b-0c1d2e3f4a5b.

Example input: `{"id":"<id>"}`

### `fireberry_ticket_delete`

Delete Ticket · Destructive

Delete a ticket.
Returns success.
Use fireberry_ticket_delete to remove a record permanently.

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

Inputs:

- `id` (`string`, required): GUID of the ticket. Example: 8f1e2d3c-4b5a-6978-8a9b-0c1d2e3f4a5b.

Example input: `{"id":"<id>"}`

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