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

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

**Authentication:** API Key
**Categories:** CRM & Sales
**Tools:** 58: 32 read, 17 write, 9 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=ESPOCRM)

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

   In **AgentKit > Connections**, create an EspoCRM 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 = 'espocrm'
   const identifier = 'user_123'

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

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

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

   ```bash
   python quickstart.py
   ```

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

**Python**

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

### `espocrm_account_cases_list`

List Account Cases · Read-only

List the Case records linked to an account.
Returns total and list of records.
Use this to see an account's cases. Get the account ID from espocrm_accounts_list.

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

Inputs:

- `id` (`string`, required): Account record ID, from espocrm_accounts_list. Example: 6650f1a2b3c4d5e6f.
- `max_size` (`integer`, optional): Maximum records to return, up to 200. Example: 20.
- `offset` (`integer`, optional): Number of records to skip, for paging. Example: 0.
- `order` (`string`, optional): Sort direction. Example: desc. One of: `asc`, `desc`.
- `order_by` (`string`, optional): Field to sort by. Example: createdAt.

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

### `espocrm_account_contacts_list`

List Account Contacts · Read-only

List the Contact records linked to an account.
Returns total and list of records.
Use this to see an account's contacts. Get the account ID from espocrm_accounts_list.

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

Inputs:

- `id` (`string`, required): Account record ID, from espocrm_accounts_list. Example: 6650f1a2b3c4d5e6f.
- `max_size` (`integer`, optional): Maximum records to return, up to 200. Example: 20.
- `offset` (`integer`, optional): Number of records to skip, for paging. Example: 0.
- `order` (`string`, optional): Sort direction. Example: desc. One of: `asc`, `desc`.
- `order_by` (`string`, optional): Field to sort by. Example: createdAt.

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

### `espocrm_account_get`

Get Account · Read-only

Get one Account record by ID.
Returns all of its fields, including related IDs and names.
Use espocrm_accounts_list to find the ID.

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

Inputs:

- `id` (`string`, required): Account record ID, from espocrm_accounts_list. Example: 6650f1a2b3c4d5e6f.

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

### `espocrm_account_opportunities_list`

List Account Opportunities · Read-only

List the Opportunity records linked to an account.
Returns total and list of records.
Use this to see an account's opportunities. Get the account ID from espocrm_accounts_list.

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

Inputs:

- `id` (`string`, required): Account record ID, from espocrm_accounts_list. Example: 6650f1a2b3c4d5e6f.
- `max_size` (`integer`, optional): Maximum records to return, up to 200. Example: 20.
- `offset` (`integer`, optional): Number of records to skip, for paging. Example: 0.
- `order` (`string`, optional): Sort direction. Example: desc. One of: `asc`, `desc`.
- `order_by` (`string`, optional): Field to sort by. Example: createdAt.

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

### `espocrm_accounts_list`

List Accounts · Read-only

List Account records, with optional text search, built-in filter, sorting and paging.
Returns total and list, with each record's id and fields.
Use this to find a account ID. Use espocrm_account_get for one record's full details.

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

Inputs:

- `attribute_select` (`array`, optional): Fields to return, to make the response smaller. Omit for all fields. Example: ["id", "name"]
- `max_size` (`integer`, optional): Maximum records to return, up to 200. Example: 20.
- `offset` (`integer`, optional): Number of records to skip, for paging. Example: 0.
- `order` (`string`, optional): Sort direction. Example: desc. One of: `asc`, `desc`.
- `order_by` (`string`, optional): Field to sort by, for example createdAt, modifiedAt or name. Example: createdAt.
- `primary_filter` (`string`, optional): Built-in filter: customers, resellers, partners, recentlyCreated. Example: customers. One of: `customers`, `resellers`, `partners`, `recentlyCreated`.
- `text_filter` (`string`, optional): Text search across the main fields. * is a wildcard. Example: acme*.

Example input: `{}`

### `espocrm_call_get`

Get Call · Read-only

Get one Call record by ID.
Returns all of its fields, including related IDs and names.
Use espocrm_calls_list to find the ID.

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

Inputs:

- `id` (`string`, required): Call record ID, from espocrm_calls_list. Example: 6650f1a2b3c4d5e6f.

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

### `espocrm_calls_list`

List Calls · Read-only

List Call records, with optional text search, built-in filter, sorting and paging.
Returns total and list, with each record's id and fields.
Use this to find a call ID. Use espocrm_call_get for one record's full details.

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

Inputs:

- `attribute_select` (`array`, optional): Fields to return, to make the response smaller. Omit for all fields. Example: ["id", "name"]
- `max_size` (`integer`, optional): Maximum records to return, up to 200. Example: 20.
- `offset` (`integer`, optional): Number of records to skip, for paging. Example: 0.
- `order` (`string`, optional): Sort direction. Example: desc. One of: `asc`, `desc`.
- `order_by` (`string`, optional): Field to sort by, for example createdAt, modifiedAt or name. Example: createdAt.
- `primary_filter` (`string`, optional): Built-in filter: planned, held, todays. Example: planned. One of: `planned`, `held`, `todays`.
- `text_filter` (`string`, optional): Text search across the main fields. * is a wildcard. Example: acme*.

Example input: `{}`

### `espocrm_campaign_get`

Get Campaign · Read-only

Get one Campaign record by ID, with all its fields.
Returns the full record.
Get the ID from espocrm_campaigns_list.

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

Inputs:

- `id` (`string`, required): Campaign record ID, from espocrm_campaigns_list. Example: 6650f1a2b3c4d5e6f.

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

### `espocrm_campaigns_list`

List Campaigns · Read-only

List marketing campaigns (name, status, type, dates, sent, opened and clicked counts), with optional text search, sorting and paging.
Returns total and list of records.
Use this to find an ID. Use espocrm_campaign_get for one record's full content.

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

Inputs:

- `attribute_select` (`array`, optional): Fields to return, to make the response smaller. Omit for all fields. Example: ["id", "name"]
- `max_size` (`integer`, optional): Maximum records to return, up to 200. Example: 20.
- `offset` (`integer`, optional): Number of records to skip, for paging. Example: 0.
- `order` (`string`, optional): Sort direction. Example: desc. One of: `asc`, `desc`.
- `order_by` (`string`, optional): Field to sort by, for example createdAt, modifiedAt or name. Example: createdAt.
- `primary_filter` (`string`, optional): Built-in filter: active. Example: active. One of: `active`.
- `text_filter` (`string`, optional): Text search across the main fields. * is a wildcard. Example: acme*.

Example input: `{}`

### `espocrm_case_get`

Get Case · Read-only

Get one Case record by ID.
Returns all of its fields, including related IDs and names.
Use espocrm_cases_list to find the ID.

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

Inputs:

- `id` (`string`, required): Case record ID, from espocrm_cases_list. Example: 6650f1a2b3c4d5e6f.

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

### `espocrm_cases_list`

List Cases · Read-only

List Case records, with optional text search, built-in filter, sorting and paging.
Returns total and list, with each record's id and fields.
Use this to find a case ID. Use espocrm_case_get for one record's full details.

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

Inputs:

- `attribute_select` (`array`, optional): Fields to return, to make the response smaller. Omit for all fields. Example: ["id", "name"]
- `max_size` (`integer`, optional): Maximum records to return, up to 200. Example: 20.
- `offset` (`integer`, optional): Number of records to skip, for paging. Example: 0.
- `order` (`string`, optional): Sort direction. Example: desc. One of: `asc`, `desc`.
- `order_by` (`string`, optional): Field to sort by, for example createdAt, modifiedAt or name. Example: createdAt.
- `primary_filter` (`string`, optional): Built-in filter: open, closed. Example: open. One of: `open`, `closed`.
- `text_filter` (`string`, optional): Text search across the main fields. * is a wildcard. Example: acme*.

Example input: `{}`

### `espocrm_contact_get`

Get Contact · Read-only

Get one Contact record by ID.
Returns all of its fields, including related IDs and names.
Use espocrm_contacts_list to find the ID.

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

Inputs:

- `id` (`string`, required): Contact record ID, from espocrm_contacts_list. Example: 6650f1a2b3c4d5e6f.

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

### `espocrm_contacts_list`

List Contacts · Read-only

List Contact records, with optional text search, built-in filter, sorting and paging.
Returns total and list, with each record's id and fields.
Use this to find a contact ID. Use espocrm_contact_get for one record's full details.

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

Inputs:

- `attribute_select` (`array`, optional): Fields to return, to make the response smaller. Omit for all fields. Example: ["id", "name"]
- `max_size` (`integer`, optional): Maximum records to return, up to 200. Example: 20.
- `offset` (`integer`, optional): Number of records to skip, for paging. Example: 0.
- `order` (`string`, optional): Sort direction. Example: desc. One of: `asc`, `desc`.
- `order_by` (`string`, optional): Field to sort by, for example createdAt, modifiedAt or name. Example: createdAt.
- `primary_filter` (`string`, optional): Built-in filter: portalUsers, notPortalUsers, accountActive. Example: portalUsers. One of: `portalUsers`, `notPortalUsers`, `accountActive`.
- `text_filter` (`string`, optional): Text search across the main fields. * is a wildcard. Example: acme*.

Example input: `{}`

### `espocrm_document_get`

Get Document · Read-only

Get one Document record by ID, with all its fields.
Returns the full record.
Get the ID from espocrm_documents_list.

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

Inputs:

- `id` (`string`, required): Document record ID, from espocrm_documents_list. Example: 6650f1a2b3c4d5e6f.

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

### `espocrm_documents_list`

List Documents · Read-only

List documents (name, type, status, publish and expiration dates, file), with optional text search, sorting and paging.
Returns total and list of records.
Use this to find an ID. Use espocrm_document_get for one record's full content.

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

Inputs:

- `attribute_select` (`array`, optional): Fields to return, to make the response smaller. Omit for all fields. Example: ["id", "name"]
- `max_size` (`integer`, optional): Maximum records to return, up to 200. Example: 20.
- `offset` (`integer`, optional): Number of records to skip, for paging. Example: 0.
- `order` (`string`, optional): Sort direction. Example: desc. One of: `asc`, `desc`.
- `order_by` (`string`, optional): Field to sort by, for example createdAt, modifiedAt or name. Example: createdAt.
- `primary_filter` (`string`, optional): Built-in filter: active, draft. Example: active. One of: `active`, `draft`.
- `text_filter` (`string`, optional): Text search across the main fields. * is a wildcard. Example: acme*.

Example input: `{}`

### `espocrm_email_get`

Get Email · Read-only

Get one Email record by ID, with all its fields.
Returns the full record.
Get the ID from espocrm_emails_list.

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

Inputs:

- `id` (`string`, required): Email record ID, from espocrm_emails_list. Example: 6650f1a2b3c4d5e6f.

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

### `espocrm_emails_list`

List Emails · Read-only

List emails archived or sent in EspoCRM (subject, from, to, status, date sent, parent record), with optional text search, sorting and paging.
Returns total and list of records.
Use this to find an ID. Use espocrm_email_get for one record's full content.

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

Inputs:

- `attribute_select` (`array`, optional): Fields to return, to make the response smaller. Omit for all fields. Example: ["id", "name"]
- `max_size` (`integer`, optional): Maximum records to return, up to 200. Example: 20.
- `offset` (`integer`, optional): Number of records to skip, for paging. Example: 0.
- `order` (`string`, optional): Sort direction. Example: desc. One of: `asc`, `desc`.
- `order_by` (`string`, optional): Field to sort by, for example createdAt, modifiedAt or name. Example: createdAt.
- `text_filter` (`string`, optional): Text search across the main fields. * is a wildcard. Example: acme*.

Example input: `{}`

### `espocrm_knowledge_base_article_get`

Get Knowledge Base Article · Read-only

Get one KnowledgeBaseArticle record by ID, with all its fields.
Returns the full record.
Get the ID from espocrm_knowledge_base_articles_list.

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

Inputs:

- `id` (`string`, required): KnowledgeBaseArticle record ID, from espocrm_knowledge_base_articles_list. Example: 6650f1a2b3c4d5e6f.

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

### `espocrm_knowledge_base_articles_list`

List Knowledge Base Articles · Read-only

List knowledge base articles (name, status, language, body), with optional text search, sorting and paging.
Returns total and list of records.
Use this to find an ID. Use espocrm_knowledge_base_article_get for one record's full content.

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

Inputs:

- `attribute_select` (`array`, optional): Fields to return, to make the response smaller. Omit for all fields. Example: ["id", "name"]
- `max_size` (`integer`, optional): Maximum records to return, up to 200. Example: 20.
- `offset` (`integer`, optional): Number of records to skip, for paging. Example: 0.
- `order` (`string`, optional): Sort direction. Example: desc. One of: `asc`, `desc`.
- `order_by` (`string`, optional): Field to sort by, for example createdAt, modifiedAt or name. Example: createdAt.
- `primary_filter` (`string`, optional): Built-in filter: published. Example: published. One of: `published`.
- `text_filter` (`string`, optional): Text search across the main fields. * is a wildcard. Example: acme*.

Example input: `{}`

### `espocrm_lead_get`

Get Lead · Read-only

Get one Lead record by ID.
Returns all of its fields, including related IDs and names.
Use espocrm_leads_list to find the ID.

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

Inputs:

- `id` (`string`, required): Lead record ID, from espocrm_leads_list. Example: 6650f1a2b3c4d5e6f.

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

### `espocrm_leads_list`

List Leads · Read-only

List Lead records, with optional text search, built-in filter, sorting and paging.
Returns total and list, with each record's id and fields.
Use this to find a lead ID. Use espocrm_lead_get for one record's full details.

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

Inputs:

- `attribute_select` (`array`, optional): Fields to return, to make the response smaller. Omit for all fields. Example: ["id", "name"]
- `max_size` (`integer`, optional): Maximum records to return, up to 200. Example: 20.
- `offset` (`integer`, optional): Number of records to skip, for paging. Example: 0.
- `order` (`string`, optional): Sort direction. Example: desc. One of: `asc`, `desc`.
- `order_by` (`string`, optional): Field to sort by, for example createdAt, modifiedAt or name. Example: createdAt.
- `primary_filter` (`string`, optional): Built-in filter: actual, active, converted. Example: actual. One of: `actual`, `active`, `converted`.
- `text_filter` (`string`, optional): Text search across the main fields. * is a wildcard. Example: acme*.

Example input: `{}`

### `espocrm_meeting_get`

Get Meeting · Read-only

Get one Meeting record by ID.
Returns all of its fields, including related IDs and names.
Use espocrm_meetings_list to find the ID.

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

Inputs:

- `id` (`string`, required): Meeting record ID, from espocrm_meetings_list. Example: 6650f1a2b3c4d5e6f.

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

### `espocrm_meetings_list`

List Meetings · Read-only

List Meeting records, with optional text search, built-in filter, sorting and paging.
Returns total and list, with each record's id and fields.
Use this to find a meeting ID. Use espocrm_meeting_get for one record's full details.

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

Inputs:

- `attribute_select` (`array`, optional): Fields to return, to make the response smaller. Omit for all fields. Example: ["id", "name"]
- `max_size` (`integer`, optional): Maximum records to return, up to 200. Example: 20.
- `offset` (`integer`, optional): Number of records to skip, for paging. Example: 0.
- `order` (`string`, optional): Sort direction. Example: desc. One of: `asc`, `desc`.
- `order_by` (`string`, optional): Field to sort by, for example createdAt, modifiedAt or name. Example: createdAt.
- `primary_filter` (`string`, optional): Built-in filter: planned, held, todays. Example: planned. One of: `planned`, `held`, `todays`.
- `text_filter` (`string`, optional): Text search across the main fields. * is a wildcard. Example: acme*.

Example input: `{}`

### `espocrm_opportunities_list`

List Opportunities · Read-only

List Opportunity records, with optional text search, built-in filter, sorting and paging.
Returns total and list, with each record's id and fields.
Use this to find a opportunity ID. Use espocrm_opportunity_get for one record's full details.

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

Inputs:

- `attribute_select` (`array`, optional): Fields to return, to make the response smaller. Omit for all fields. Example: ["id", "name"]
- `max_size` (`integer`, optional): Maximum records to return, up to 200. Example: 20.
- `offset` (`integer`, optional): Number of records to skip, for paging. Example: 0.
- `order` (`string`, optional): Sort direction. Example: desc. One of: `asc`, `desc`.
- `order_by` (`string`, optional): Field to sort by, for example createdAt, modifiedAt or name. Example: createdAt.
- `primary_filter` (`string`, optional): Built-in filter: open, won, lost. Example: open. One of: `open`, `won`, `lost`.
- `text_filter` (`string`, optional): Text search across the main fields. * is a wildcard. Example: acme*.

Example input: `{}`

### `espocrm_opportunity_get`

Get Opportunity · Read-only

Get one Opportunity record by ID.
Returns all of its fields, including related IDs and names.
Use espocrm_opportunities_list to find the ID.

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

Inputs:

- `id` (`string`, required): Opportunity record ID, from espocrm_opportunities_list. Example: 6650f1a2b3c4d5e6f.

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

### `espocrm_target_list_get`

Get Target List · Read-only

Get one TargetList record by ID, with all its fields.
Returns the full record.
Get the ID from espocrm_target_lists_list.

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

Inputs:

- `id` (`string`, required): TargetList record ID, from espocrm_target_lists_list. Example: 6650f1a2b3c4d5e6f.

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

### `espocrm_target_lists_list`

List Target Lists · Read-only

List target lists used by campaigns (name, entry count, opted-out count), with optional text search, sorting and paging.
Returns total and list of records.
Use this to find an ID. Use espocrm_target_list_get for one record's full content.

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

Inputs:

- `attribute_select` (`array`, optional): Fields to return, to make the response smaller. Omit for all fields. Example: ["id", "name"]
- `max_size` (`integer`, optional): Maximum records to return, up to 200. Example: 20.
- `offset` (`integer`, optional): Number of records to skip, for paging. Example: 0.
- `order` (`string`, optional): Sort direction. Example: desc. One of: `asc`, `desc`.
- `order_by` (`string`, optional): Field to sort by, for example createdAt, modifiedAt or name. Example: createdAt.
- `text_filter` (`string`, optional): Text search across the main fields. * is a wildcard. Example: acme*.

Example input: `{}`

### `espocrm_task_get`

Get Task · Read-only

Get one Task record by ID.
Returns all of its fields, including related IDs and names.
Use espocrm_tasks_list to find the ID.

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

Inputs:

- `id` (`string`, required): Task record ID, from espocrm_tasks_list. Example: 6650f1a2b3c4d5e6f.

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

### `espocrm_tasks_list`

List Tasks · Read-only

List Task records, with optional text search, built-in filter, sorting and paging.
Returns total and list, with each record's id and fields.
Use this to find a task ID. Use espocrm_task_get for one record's full details.

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

Inputs:

- `attribute_select` (`array`, optional): Fields to return, to make the response smaller. Omit for all fields. Example: ["id", "name"]
- `max_size` (`integer`, optional): Maximum records to return, up to 200. Example: 20.
- `offset` (`integer`, optional): Number of records to skip, for paging. Example: 0.
- `order` (`string`, optional): Sort direction. Example: desc. One of: `asc`, `desc`.
- `order_by` (`string`, optional): Field to sort by, for example createdAt, modifiedAt or name. Example: createdAt.
- `primary_filter` (`string`, optional): Built-in filter: actual, completed, deferred, todays, overdue. Example: actual. One of: `actual`, `completed`, `deferred`, `todays`, `overdue`.
- `text_filter` (`string`, optional): Text search across the main fields. * is a wildcard. Example: acme*.

Example input: `{}`

### `espocrm_teams_list`

List Teams · Read-only

List teams.
Returns each team's id and name.
Use this to find IDs for teams_ids.

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

Inputs:

- `max_size` (`integer`, optional): Maximum records to return, up to 200. Example: 50.
- `offset` (`integer`, optional): Number of records to skip. Example: 0.

Example input: `{}`

### `espocrm_user_get`

Get User · Read-only

Get one user by ID.
Returns the user's name, user name, email, teams and roles.
Get IDs from espocrm_users_list.

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

Inputs:

- `id` (`string`, required): User ID, from espocrm_users_list. Example: 6650f1a2b3c4d5e6f.

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

### `espocrm_users_list`

List Users · Read-only

List users of the EspoCRM instance.
Returns each user's id, name, user name, email and type.
Use this to find IDs for assigned_user_id.

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

Inputs:

- `max_size` (`integer`, optional): Maximum records to return, up to 200. Example: 50.
- `offset` (`integer`, optional): Number of records to skip. Example: 0.
- `text_filter` (`string`, optional): Text search on name, user name or email. * is a wildcard. Example: jane*.

Example input: `{}`

### `espocrm_account_contact_link`

Link Contact to Account · Write

Link an existing contact to an account.
Returns true on success.
Use espocrm_account_contact_unlink to remove the link.

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

Inputs:

- `contact_id` (`string`, required): ID of the contact to link, from espocrm_contacts_list. Example: 6650f1a2b3c4d5e6f.
- `id` (`string`, required): Account record ID, from espocrm_accounts_list. Example: 6650f1a2b3c4d5e6f.

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

### `espocrm_account_create`

Create Account · Write

Create a Account record.
Returns the created record with its id.
Use espocrm_account_update to change an existing record.

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

Inputs:

- `name` (`string`, required): Company name. Example: Acme Corporation.
- `assigned_user_id` (`string`, optional): ID of the user the record is assigned to, from espocrm_users_list. Example: 6650f1a2b3c4d5e6f.
- `billing_address_city` (`string`, optional): City. Example: Springfield.
- `billing_address_country` (`string`, optional): Country. Example: USA.
- `billing_address_postal_code` (`string`, optional): Postal code. Example: 62701.
- `billing_address_state` (`string`, optional): State or region. Example: IL.
- `billing_address_street` (`string`, optional): Street address. Example: 21 Main Street.
- `description` (`string`, optional): Free-text description. Example: Key account in the Midwest.
- `email_address` (`string`, optional): Primary email address. Example: info@acme.example.
- `industry` (`string`, optional): Industry, for example Computer, Finance, Healthcare or Retail (default values; your admin may have customised the list). Example: Computer.
- `phone_number` (`string`, optional): Primary phone number. Example: +1 555 0100.
- `teams_ids` (`array`, optional): IDs of the teams the record belongs to, from espocrm_teams_list. Example: ["6650f1a2b3c4d5e6f"]
- `type` (`string`, optional): Account type: Customer, Investor, Partner or Reseller (default values; your admin may have customised the list). Example: Customer.
- `website` (`string`, optional): Website URL. Example: https://acme.example.

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

### `espocrm_account_update`

Update Account · Write

Update fields of a Account record. Only the fields sent change.
Returns the updated record.
Get the ID from espocrm_accounts_list.

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

Inputs:

- `id` (`string`, required): Account record ID, from espocrm_accounts_list. Example: 6650f1a2b3c4d5e6f.
- `assigned_user_id` (`string`, optional): ID of the user the record is assigned to, from espocrm_users_list. Example: 6650f1a2b3c4d5e6f.
- `billing_address_city` (`string`, optional): City. Example: Springfield.
- `billing_address_country` (`string`, optional): Country. Example: USA.
- `billing_address_postal_code` (`string`, optional): Postal code. Example: 62701.
- `billing_address_state` (`string`, optional): State or region. Example: IL.
- `billing_address_street` (`string`, optional): Street address. Example: 21 Main Street.
- `description` (`string`, optional): Free-text description. Example: Key account in the Midwest.
- `email_address` (`string`, optional): Primary email address. Example: info@acme.example.
- `industry` (`string`, optional): Industry, for example Computer, Finance, Healthcare or Retail (default values; your admin may have customised the list). Example: Computer.
- `name` (`string`, optional): Company name. Example: Acme Corporation.
- `phone_number` (`string`, optional): Primary phone number. Example: +1 555 0100.
- `teams_ids` (`array`, optional): IDs of the teams the record belongs to, from espocrm_teams_list. Example: ["6650f1a2b3c4d5e6f"]
- `type` (`string`, optional): Account type: Customer, Investor, Partner or Reseller (default values; your admin may have customised the list). Example: Customer.
- `website` (`string`, optional): Website URL. Example: https://acme.example.

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

### `espocrm_call_create`

Create Call · Write

Create a Call record.
Returns the created record with its id.
Use espocrm_call_update to change an existing record.

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

Inputs:

- `assigned_user_id` (`string`, required): ID of the user the record is assigned to, from espocrm_users_list. Example: 6650f1a2b3c4d5e6f.
- `date_end` (`string`, required): End date-time in UTC, YYYY-MM-DD HH:mm:ss. Example: 2026-02-03 15:30:00.
- `date_start` (`string`, required): Start date-time in UTC, YYYY-MM-DD HH:mm:ss. Example: 2026-02-03 15:00:00.
- `name` (`string`, required): Call subject. Example: Discovery call.
- `contacts_ids` (`array`, optional): IDs of contacts on the call. Example: ["6650f1a2b3c4d5e6f"]
- `description` (`string`, optional): Call notes. Example: Discuss requirements.
- `direction` (`string`, optional): Direction: Outbound or Inbound. Example: Outbound.
- `leads_ids` (`array`, optional): IDs of leads on the call. Example: ["6650f1a2b3c4d5e6f"]
- `parent_id` (`string`, optional): ID of the related parent record (set with parentType). Example: 6650f1a2b3c4d5e6f.
- `parent_type` (`string`, optional): Type of the related parent record: Account, Contact, Lead, Opportunity or Case. Example: Account.
- `status` (`string`, optional): Status: Planned, Held or Not Held. Example: Planned.
- `teams_ids` (`array`, optional): IDs of the teams the record belongs to, from espocrm_teams_list. Example: ["6650f1a2b3c4d5e6f"]
- `users_ids` (`array`, optional): IDs of users on the call. Example: ["6650f1a2b3c4d5e6f"]

Example input: `{"assigned_user_id":"<assigned_user_id>","date_end":"<date_end>","date_start":"<date_start>","name":"<name>"}`

### `espocrm_call_update`

Update Call · Write

Update fields of a Call record. Only the fields sent change.
Returns the updated record.
Get the ID from espocrm_calls_list.

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

Inputs:

- `id` (`string`, required): Call record ID, from espocrm_calls_list. Example: 6650f1a2b3c4d5e6f.
- `assigned_user_id` (`string`, optional): ID of the user the record is assigned to, from espocrm_users_list. Example: 6650f1a2b3c4d5e6f.
- `contacts_ids` (`array`, optional): IDs of contacts on the call. Example: ["6650f1a2b3c4d5e6f"]
- `date_end` (`string`, optional): End date-time in UTC, YYYY-MM-DD HH:mm:ss. Example: 2026-02-03 15:30:00.
- `date_start` (`string`, optional): Start date-time in UTC, YYYY-MM-DD HH:mm:ss. Example: 2026-02-03 15:00:00.
- `description` (`string`, optional): Call notes. Example: Discuss requirements.
- `direction` (`string`, optional): Direction: Outbound or Inbound. Example: Outbound.
- `leads_ids` (`array`, optional): IDs of leads on the call. Example: ["6650f1a2b3c4d5e6f"]
- `name` (`string`, optional): Call subject. Example: Discovery call.
- `parent_id` (`string`, optional): ID of the related parent record (set with parentType). Example: 6650f1a2b3c4d5e6f.
- `parent_type` (`string`, optional): Type of the related parent record: Account, Contact, Lead, Opportunity or Case. Example: Account.
- `status` (`string`, optional): Status: Planned, Held or Not Held. Example: Planned.
- `teams_ids` (`array`, optional): IDs of the teams the record belongs to, from espocrm_teams_list. Example: ["6650f1a2b3c4d5e6f"]
- `users_ids` (`array`, optional): IDs of users on the call. Example: ["6650f1a2b3c4d5e6f"]

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

### `espocrm_case_create`

Create Case · Write

Create a Case record.
Returns the created record with its id.
Use espocrm_case_update to change an existing record.

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

Inputs:

- `name` (`string`, required): Case subject. Example: Cannot log in.
- `account_id` (`string`, optional): ID of the related account. Example: 6650f1a2b3c4d5e6f.
- `assigned_user_id` (`string`, optional): ID of the user the record is assigned to, from espocrm_users_list. Example: 6650f1a2b3c4d5e6f.
- `contact_id` (`string`, optional): ID of the primary contact. Example: 6650f1a2b3c4d5e6f.
- `description` (`string`, optional): Case details. Example: User gets an error after resetting their password.
- `lead_id` (`string`, optional): ID of the related lead. Example: 6650f1a2b3c4d5e6f.
- `priority` (`string`, optional): Priority: Low, Normal, High or Urgent. Example: High.
- `status` (`string`, optional): Status: New, Assigned, Pending, Closed, Rejected or Duplicate (default values; your admin may have customised the list). Example: New.
- `teams_ids` (`array`, optional): IDs of the teams the record belongs to, from espocrm_teams_list. Example: ["6650f1a2b3c4d5e6f"]
- `type` (`string`, optional): Type: Question, Incident or Problem (default values; your admin may have customised the list). Example: Incident.

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

### `espocrm_case_update`

Update Case · Write

Update fields of a Case record. Only the fields sent change.
Returns the updated record.
Get the ID from espocrm_cases_list.

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

Inputs:

- `id` (`string`, required): Case record ID, from espocrm_cases_list. Example: 6650f1a2b3c4d5e6f.
- `account_id` (`string`, optional): ID of the related account. Example: 6650f1a2b3c4d5e6f.
- `assigned_user_id` (`string`, optional): ID of the user the record is assigned to, from espocrm_users_list. Example: 6650f1a2b3c4d5e6f.
- `contact_id` (`string`, optional): ID of the primary contact. Example: 6650f1a2b3c4d5e6f.
- `description` (`string`, optional): Case details. Example: User gets an error after resetting their password.
- `lead_id` (`string`, optional): ID of the related lead. Example: 6650f1a2b3c4d5e6f.
- `name` (`string`, optional): Case subject. Example: Cannot log in.
- `priority` (`string`, optional): Priority: Low, Normal, High or Urgent. Example: High.
- `status` (`string`, optional): Status: New, Assigned, Pending, Closed, Rejected or Duplicate (default values; your admin may have customised the list). Example: New.
- `teams_ids` (`array`, optional): IDs of the teams the record belongs to, from espocrm_teams_list. Example: ["6650f1a2b3c4d5e6f"]
- `type` (`string`, optional): Type: Question, Incident or Problem (default values; your admin may have customised the list). Example: Incident.

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

### `espocrm_contact_create`

Create Contact · Write

Create a Contact record.
Returns the created record with its id.
Use espocrm_contact_update to change an existing record.

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

Inputs:

- `last_name` (`string`, required): Last name. Example: Doe.
- `account_id` (`string`, optional): ID of the contact's account, from espocrm_accounts_list. Example: 6650f1a2b3c4d5e6f.
- `address_city` (`string`, optional): City. Example: Springfield.
- `address_country` (`string`, optional): Country. Example: USA.
- `address_postal_code` (`string`, optional): Postal code. Example: 62701.
- `address_state` (`string`, optional): State or region. Example: IL.
- `address_street` (`string`, optional): Street address. Example: 21 Main Street.
- `assigned_user_id` (`string`, optional): ID of the user the record is assigned to, from espocrm_users_list. Example: 6650f1a2b3c4d5e6f.
- `description` (`string`, optional): Free-text description. Example: Met at the 2026 trade show.
- `do_not_call` (`boolean`, optional): Do not call this contact. Example: false.
- `email_address` (`string`, optional): Primary email address. Example: jane.doe@acme.example.
- `first_name` (`string`, optional): First name. Example: Jane.
- `phone_number` (`string`, optional): Primary phone number. Example: +1 555 0101.
- `salutation_name` (`string`, optional): Salutation: Mr., Ms., Mrs. or Dr. Example: Ms.
- `teams_ids` (`array`, optional): IDs of the teams the record belongs to, from espocrm_teams_list. Example: ["6650f1a2b3c4d5e6f"]
- `title` (`string`, optional): Job title. Example: VP Sales.

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

### `espocrm_contact_update`

Update Contact · Write

Update fields of a Contact record. Only the fields sent change.
Returns the updated record.
Get the ID from espocrm_contacts_list.

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

Inputs:

- `id` (`string`, required): Contact record ID, from espocrm_contacts_list. Example: 6650f1a2b3c4d5e6f.
- `account_id` (`string`, optional): ID of the contact's account, from espocrm_accounts_list. Example: 6650f1a2b3c4d5e6f.
- `address_city` (`string`, optional): City. Example: Springfield.
- `address_country` (`string`, optional): Country. Example: USA.
- `address_postal_code` (`string`, optional): Postal code. Example: 62701.
- `address_state` (`string`, optional): State or region. Example: IL.
- `address_street` (`string`, optional): Street address. Example: 21 Main Street.
- `assigned_user_id` (`string`, optional): ID of the user the record is assigned to, from espocrm_users_list. Example: 6650f1a2b3c4d5e6f.
- `description` (`string`, optional): Free-text description. Example: Met at the 2026 trade show.
- `do_not_call` (`boolean`, optional): Do not call this contact. Example: false.
- `email_address` (`string`, optional): Primary email address. Example: jane.doe@acme.example.
- `first_name` (`string`, optional): First name. Example: Jane.
- `last_name` (`string`, optional): Last name. Example: Doe.
- `phone_number` (`string`, optional): Primary phone number. Example: +1 555 0101.
- `salutation_name` (`string`, optional): Salutation: Mr., Ms., Mrs. or Dr. Example: Ms.
- `teams_ids` (`array`, optional): IDs of the teams the record belongs to, from espocrm_teams_list. Example: ["6650f1a2b3c4d5e6f"]
- `title` (`string`, optional): Job title. Example: VP Sales.

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

### `espocrm_lead_create`

Create Lead · Write

Create a Lead record.
Returns the created record with its id.
Use espocrm_lead_update to change an existing record.

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

Inputs:

- `account_name` (`string`, optional): Company name of the lead. Example: Globex.
- `address_city` (`string`, optional): City. Example: Springfield.
- `address_country` (`string`, optional): Country. Example: USA.
- `address_postal_code` (`string`, optional): Postal code. Example: 62701.
- `address_state` (`string`, optional): State or region. Example: IL.
- `address_street` (`string`, optional): Street address. Example: 21 Main Street.
- `assigned_user_id` (`string`, optional): ID of the user the record is assigned to, from espocrm_users_list. Example: 6650f1a2b3c4d5e6f.
- `description` (`string`, optional): Free-text description. Example: Asked for a demo.
- `email_address` (`string`, optional): Primary email address. Example: john@globex.example.
- `first_name` (`string`, optional): First name. Example: John.
- `industry` (`string`, optional): Industry (default values; your admin may have customised the list). Example: Computer.
- `last_name` (`string`, optional): Last name. Example: Smith.
- `opportunity_amount` (`number`, optional): Expected deal amount. Example: 25000.
- `opportunity_amount_currency` (`string`, optional): Currency code of opportunity_amount, as enabled in your instance. Example: USD.
- `phone_number` (`string`, optional): Primary phone number. Example: +1 555 0102.
- `source` (`string`, optional): Lead source: Call, Email, Existing Customer, Partner, Public Relations, Web Site, Campaign or Other (default values; your admin may have customised the list). Example: Web Site.
- `status` (`string`, optional): Lead status: New, Assigned, In Process, Converted, Recycled or Dead (default values; your admin may have customised the list). Example: New.
- `teams_ids` (`array`, optional): IDs of the teams the record belongs to, from espocrm_teams_list. Example: ["6650f1a2b3c4d5e6f"]
- `title` (`string`, optional): Job title. Example: CTO.
- `website` (`string`, optional): Website URL. Example: https://globex.example.

Example input: `{}`

### `espocrm_lead_update`

Update Lead · Write

Update fields of a Lead record. Only the fields sent change.
Returns the updated record.
Get the ID from espocrm_leads_list.

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

Inputs:

- `id` (`string`, required): Lead record ID, from espocrm_leads_list. Example: 6650f1a2b3c4d5e6f.
- `account_name` (`string`, optional): Company name of the lead. Example: Globex.
- `address_city` (`string`, optional): City. Example: Springfield.
- `address_country` (`string`, optional): Country. Example: USA.
- `address_postal_code` (`string`, optional): Postal code. Example: 62701.
- `address_state` (`string`, optional): State or region. Example: IL.
- `address_street` (`string`, optional): Street address. Example: 21 Main Street.
- `assigned_user_id` (`string`, optional): ID of the user the record is assigned to, from espocrm_users_list. Example: 6650f1a2b3c4d5e6f.
- `description` (`string`, optional): Free-text description. Example: Asked for a demo.
- `email_address` (`string`, optional): Primary email address. Example: john@globex.example.
- `first_name` (`string`, optional): First name. Example: John.
- `industry` (`string`, optional): Industry (default values; your admin may have customised the list). Example: Computer.
- `last_name` (`string`, optional): Last name. Example: Smith.
- `opportunity_amount` (`number`, optional): Expected deal amount. Example: 25000.
- `opportunity_amount_currency` (`string`, optional): Currency code of opportunity_amount, as enabled in your instance. Example: USD.
- `phone_number` (`string`, optional): Primary phone number. Example: +1 555 0102.
- `source` (`string`, optional): Lead source: Call, Email, Existing Customer, Partner, Public Relations, Web Site, Campaign or Other (default values; your admin may have customised the list). Example: Web Site.
- `status` (`string`, optional): Lead status: New, Assigned, In Process, Converted, Recycled or Dead (default values; your admin may have customised the list). Example: New.
- `teams_ids` (`array`, optional): IDs of the teams the record belongs to, from espocrm_teams_list. Example: ["6650f1a2b3c4d5e6f"]
- `title` (`string`, optional): Job title. Example: CTO.
- `website` (`string`, optional): Website URL. Example: https://globex.example.

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

### `espocrm_meeting_create`

Create Meeting · Write

Create a Meeting record.
Returns the created record with its id.
Use espocrm_meeting_update to change an existing record.

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

Inputs:

- `assigned_user_id` (`string`, required): ID of the user the record is assigned to, from espocrm_users_list. Example: 6650f1a2b3c4d5e6f.
- `date_end` (`string`, required): End date-time in UTC, YYYY-MM-DD HH:mm:ss. Example: 2026-02-10 15:00:00.
- `date_start` (`string`, required): Start date-time in UTC, YYYY-MM-DD HH:mm:ss. Example: 2026-02-10 14:00:00.
- `name` (`string`, required): Meeting subject. Example: Quarterly review.
- `contacts_ids` (`array`, optional): IDs of contacts invited. Example: ["6650f1a2b3c4d5e6f"]
- `description` (`string`, optional): Agenda or notes. Example: Review Q1 usage.
- `is_all_day` (`boolean`, optional): All-day meeting (then use dateStartDate and dateEndDate in the UI). Example: false.
- `join_url` (`string`, optional): Online meeting link. Example: https://meet.example.com/abc.
- `leads_ids` (`array`, optional): IDs of leads invited. Example: ["6650f1a2b3c4d5e6f"]
- `parent_id` (`string`, optional): ID of the related parent record (set with parentType). Example: 6650f1a2b3c4d5e6f.
- `parent_type` (`string`, optional): Type of the related parent record: Account, Contact, Lead, Opportunity or Case. Example: Account.
- `status` (`string`, optional): Status: Planned, Held or Not Held. Example: Planned.
- `teams_ids` (`array`, optional): IDs of the teams the record belongs to, from espocrm_teams_list. Example: ["6650f1a2b3c4d5e6f"]
- `users_ids` (`array`, optional): IDs of users invited. Example: ["6650f1a2b3c4d5e6f"]

Example input: `{"assigned_user_id":"<assigned_user_id>","date_end":"<date_end>","date_start":"<date_start>","name":"<name>"}`

### `espocrm_meeting_update`

Update Meeting · Write

Update fields of a Meeting record. Only the fields sent change.
Returns the updated record.
Get the ID from espocrm_meetings_list.

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

Inputs:

- `id` (`string`, required): Meeting record ID, from espocrm_meetings_list. Example: 6650f1a2b3c4d5e6f.
- `assigned_user_id` (`string`, optional): ID of the user the record is assigned to, from espocrm_users_list. Example: 6650f1a2b3c4d5e6f.
- `contacts_ids` (`array`, optional): IDs of contacts invited. Example: ["6650f1a2b3c4d5e6f"]
- `date_end` (`string`, optional): End date-time in UTC, YYYY-MM-DD HH:mm:ss. Example: 2026-02-10 15:00:00.
- `date_start` (`string`, optional): Start date-time in UTC, YYYY-MM-DD HH:mm:ss. Example: 2026-02-10 14:00:00.
- `description` (`string`, optional): Agenda or notes. Example: Review Q1 usage.
- `is_all_day` (`boolean`, optional): All-day meeting (then use dateStartDate and dateEndDate in the UI). Example: false.
- `join_url` (`string`, optional): Online meeting link. Example: https://meet.example.com/abc.
- `leads_ids` (`array`, optional): IDs of leads invited. Example: ["6650f1a2b3c4d5e6f"]
- `name` (`string`, optional): Meeting subject. Example: Quarterly review.
- `parent_id` (`string`, optional): ID of the related parent record (set with parentType). Example: 6650f1a2b3c4d5e6f.
- `parent_type` (`string`, optional): Type of the related parent record: Account, Contact, Lead, Opportunity or Case. Example: Account.
- `status` (`string`, optional): Status: Planned, Held or Not Held. Example: Planned.
- `teams_ids` (`array`, optional): IDs of the teams the record belongs to, from espocrm_teams_list. Example: ["6650f1a2b3c4d5e6f"]
- `users_ids` (`array`, optional): IDs of users invited. Example: ["6650f1a2b3c4d5e6f"]

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

### `espocrm_opportunity_create`

Create Opportunity · Write

Create a Opportunity record.
Returns the created record with its id.
Use espocrm_opportunity_update to change an existing record.

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

Inputs:

- `amount` (`number`, required): Deal amount. Example: 50000.
- `amount_currency` (`string`, required): Currency code of amount, as enabled in your instance. Example: USD.
- `close_date` (`string`, required): Expected close date, YYYY-MM-DD. Example: 2026-03-31.
- `name` (`string`, required): Opportunity name. Example: Acme - 50 seats.
- `account_id` (`string`, optional): ID of the account, from espocrm_accounts_list. Example: 6650f1a2b3c4d5e6f.
- `assigned_user_id` (`string`, optional): ID of the user the record is assigned to, from espocrm_users_list. Example: 6650f1a2b3c4d5e6f.
- `contacts_ids` (`array`, optional): IDs of related contacts. Example: ["6650f1a2b3c4d5e6f"]
- `description` (`string`, optional): Free-text description. Example: Renewal plus upsell.
- `lead_source` (`string`, optional): Lead source (default values; your admin may have customised the list). Example: Partner.
- `probability` (`integer`, optional): Win probability in percent (0 to 100). Example: 60.
- `stage` (`string`, optional): Sales stage: Prospecting, Qualification, Proposal, Negotiation, Closed Won or Closed Lost (default values; your admin may have customised the list). Example: Proposal.
- `teams_ids` (`array`, optional): IDs of the teams the record belongs to, from espocrm_teams_list. Example: ["6650f1a2b3c4d5e6f"]

Example input: `{"amount":50000,"amount_currency":"<amount_currency>","close_date":"<close_date>","name":"<name>"}`

### `espocrm_opportunity_update`

Update Opportunity · Write

Update fields of a Opportunity record. Only the fields sent change.
Returns the updated record.
Get the ID from espocrm_opportunities_list.

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

Inputs:

- `id` (`string`, required): Opportunity record ID, from espocrm_opportunities_list. Example: 6650f1a2b3c4d5e6f.
- `account_id` (`string`, optional): ID of the account, from espocrm_accounts_list. Example: 6650f1a2b3c4d5e6f.
- `amount` (`number`, optional): Deal amount. Example: 50000.
- `amount_currency` (`string`, optional): Currency code of amount, as enabled in your instance. Example: USD.
- `assigned_user_id` (`string`, optional): ID of the user the record is assigned to, from espocrm_users_list. Example: 6650f1a2b3c4d5e6f.
- `close_date` (`string`, optional): Expected close date, YYYY-MM-DD. Example: 2026-03-31.
- `contacts_ids` (`array`, optional): IDs of related contacts. Example: ["6650f1a2b3c4d5e6f"]
- `description` (`string`, optional): Free-text description. Example: Renewal plus upsell.
- `lead_source` (`string`, optional): Lead source (default values; your admin may have customised the list). Example: Partner.
- `name` (`string`, optional): Opportunity name. Example: Acme - 50 seats.
- `probability` (`integer`, optional): Win probability in percent (0 to 100). Example: 60.
- `stage` (`string`, optional): Sales stage: Prospecting, Qualification, Proposal, Negotiation, Closed Won or Closed Lost (default values; your admin may have customised the list). Example: Proposal.
- `teams_ids` (`array`, optional): IDs of the teams the record belongs to, from espocrm_teams_list. Example: ["6650f1a2b3c4d5e6f"]

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

### `espocrm_task_create`

Create Task · Write

Create a Task record.
Returns the created record with its id.
Use espocrm_task_update to change an existing record.

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

Inputs:

- `assigned_user_id` (`string`, required): ID of the user the record is assigned to, from espocrm_users_list. Example: 6650f1a2b3c4d5e6f.
- `name` (`string`, required): Task name. Example: Send proposal.
- `date_end` (`string`, optional): Due date-time in UTC, YYYY-MM-DD HH:mm:ss. Example: 2026-02-05 17:00:00.
- `date_start` (`string`, optional): Start date-time in UTC, YYYY-MM-DD HH:mm:ss. Example: 2026-02-02 09:00:00.
- `description` (`string`, optional): Task details. Example: Include the volume discount.
- `parent_id` (`string`, optional): ID of the related parent record (set with parentType). Example: 6650f1a2b3c4d5e6f.
- `parent_type` (`string`, optional): Type of the related parent record: Account, Contact, Lead, Opportunity or Case. Example: Account.
- `priority` (`string`, optional): Priority: Low, Normal, High or Urgent. Example: Normal.
- `status` (`string`, optional): Status: Not Started, Started, Completed, Canceled or Deferred (default values; your admin may have customised the list). Example: Not Started.
- `teams_ids` (`array`, optional): IDs of the teams the record belongs to, from espocrm_teams_list. Example: ["6650f1a2b3c4d5e6f"]

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

### `espocrm_task_update`

Update Task · Write

Update fields of a Task record. Only the fields sent change.
Returns the updated record.
Get the ID from espocrm_tasks_list.

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

Inputs:

- `id` (`string`, required): Task record ID, from espocrm_tasks_list. Example: 6650f1a2b3c4d5e6f.
- `assigned_user_id` (`string`, optional): ID of the user the record is assigned to, from espocrm_users_list. Example: 6650f1a2b3c4d5e6f.
- `date_end` (`string`, optional): Due date-time in UTC, YYYY-MM-DD HH:mm:ss. Example: 2026-02-05 17:00:00.
- `date_start` (`string`, optional): Start date-time in UTC, YYYY-MM-DD HH:mm:ss. Example: 2026-02-02 09:00:00.
- `description` (`string`, optional): Task details. Example: Include the volume discount.
- `name` (`string`, optional): Task name. Example: Send proposal.
- `parent_id` (`string`, optional): ID of the related parent record (set with parentType). Example: 6650f1a2b3c4d5e6f.
- `parent_type` (`string`, optional): Type of the related parent record: Account, Contact, Lead, Opportunity or Case. Example: Account.
- `priority` (`string`, optional): Priority: Low, Normal, High or Urgent. Example: Normal.
- `status` (`string`, optional): Status: Not Started, Started, Completed, Canceled or Deferred (default values; your admin may have customised the list). Example: Not Started.
- `teams_ids` (`array`, optional): IDs of the teams the record belongs to, from espocrm_teams_list. Example: ["6650f1a2b3c4d5e6f"]

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

### `espocrm_account_contact_unlink`

Unlink Contact from Account · Destructive

Remove the link between a contact and an account. Neither record is deleted.
Returns true on success.
Use espocrm_account_contacts_list to find linked contacts.

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

Inputs:

- `contact_id` (`string`, required): ID of the contact to unlink, from espocrm_account_contacts_list. Example: 6650f1a2b3c4d5e6f.
- `id` (`string`, required): Account record ID, from espocrm_accounts_list. Example: 6650f1a2b3c4d5e6f.

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

### `espocrm_account_delete`

Delete Account · Destructive

Delete a Account record (it can be restored from the admin's Deleted records only if your instance keeps them).
Returns true on success.
Get the ID from espocrm_accounts_list.

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

Inputs:

- `id` (`string`, required): Account record ID, from espocrm_accounts_list. Example: 6650f1a2b3c4d5e6f.

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

### `espocrm_call_delete`

Delete Call · Destructive

Delete a Call record (it can be restored from the admin's Deleted records only if your instance keeps them).
Returns true on success.
Get the ID from espocrm_calls_list.

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

Inputs:

- `id` (`string`, required): Call record ID, from espocrm_calls_list. Example: 6650f1a2b3c4d5e6f.

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

### `espocrm_case_delete`

Delete Case · Destructive

Delete a Case record (it can be restored from the admin's Deleted records only if your instance keeps them).
Returns true on success.
Get the ID from espocrm_cases_list.

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

Inputs:

- `id` (`string`, required): Case record ID, from espocrm_cases_list. Example: 6650f1a2b3c4d5e6f.

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

### `espocrm_contact_delete`

Delete Contact · Destructive

Delete a Contact record (it can be restored from the admin's Deleted records only if your instance keeps them).
Returns true on success.
Get the ID from espocrm_contacts_list.

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

Inputs:

- `id` (`string`, required): Contact record ID, from espocrm_contacts_list. Example: 6650f1a2b3c4d5e6f.

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

### `espocrm_lead_delete`

Delete Lead · Destructive

Delete a Lead record (it can be restored from the admin's Deleted records only if your instance keeps them).
Returns true on success.
Get the ID from espocrm_leads_list.

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

Inputs:

- `id` (`string`, required): Lead record ID, from espocrm_leads_list. Example: 6650f1a2b3c4d5e6f.

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

### `espocrm_meeting_delete`

Delete Meeting · Destructive

Delete a Meeting record (it can be restored from the admin's Deleted records only if your instance keeps them).
Returns true on success.
Get the ID from espocrm_meetings_list.

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

Inputs:

- `id` (`string`, required): Meeting record ID, from espocrm_meetings_list. Example: 6650f1a2b3c4d5e6f.

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

### `espocrm_opportunity_delete`

Delete Opportunity · Destructive

Delete a Opportunity record (it can be restored from the admin's Deleted records only if your instance keeps them).
Returns true on success.
Get the ID from espocrm_opportunities_list.

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

Inputs:

- `id` (`string`, required): Opportunity record ID, from espocrm_opportunities_list. Example: 6650f1a2b3c4d5e6f.

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

### `espocrm_task_delete`

Delete Task · Destructive

Delete a Task record (it can be restored from the admin's Deleted records only if your instance keeps them).
Returns true on success.
Get the ID from espocrm_tasks_list.

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

Inputs:

- `id` (`string`, required): Task record ID, from espocrm_tasks_list. Example: 6650f1a2b3c4d5e6f.

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 |
