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

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

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

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

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

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

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

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

   ```bash
   python quickstart.py
   ```

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

**Python**

```python
result = actions.execute_tool(
    tool_name="centralstationcrm_activities_list",
    tool_input={},
    connection_name="centralstationcrm",
    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.

### `centralstationcrm_activities_list`

List Activities · Read-only

List the activity stream, optionally for one person, company, deal, project or user.
Returns each activity's type, change, user and time.
Use it to see recent changes and history.

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

Inputs:

- `company_id` (`integer`, optional): Only activities for this company. Example: 234567.
- `deal_id` (`integer`, optional): Only activities for this deal. Example: 345678.
- `includes` (`string`, optional): Related data to embed, separated by spaces. Request only what you need; avoid all. Example: attachable.
- `order` (`string`, optional): Sort order. Example: date-desc.
- `page` (`integer`, optional): Page number, starting at 1. Example: 1.
- `perpage` (`integer`, optional): Records per page, up to 250. Example: 50.
- `person_id` (`integer`, optional): Only activities for this person. Example: 1234567.
- `project_id` (`integer`, optional): Only activities for this project. Example: 456789.
- `user_id` (`integer`, optional): Only activities by this user. Example: 12345.

Example input: `{}`

### `centralstationcrm_calendar_event_get`

Get Calendar Event · Read-only

Get one calendar event by ID.
Returns the event's name, start, end, location, status, description and linked record.

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

Inputs:

- `calendar_event_id` (`string`, required): ID of the calendar event. Get it from centralstationcrm_calendar_events_list. Example: 1234567.
- `includes` (`string`, optional): Related data to embed, separated by spaces. Request only what you need; avoid all. Example: tags.

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

### `centralstationcrm_calendar_events_list`

List Calendar Events · Read-only

List calendar events, with paging, a state filter and a date window.
Returns each event's ID, name, start, end, location, status and linked record.

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

Inputs:

- `after` (`string`, optional): Only events after this date, YYYY-MM-DD. Example: 2026-01-01.
- `before` (`string`, optional): Only events before this date, YYYY-MM-DD. Example: 2026-12-31.
- `includes` (`string`, optional): Related data to embed, separated by spaces. Request only what you need; avoid all. Example: attachable.
- `order` (`string`, optional): Sort order. Example: date-asc.
- `page` (`integer`, optional): Page number, starting at 1. Example: 1.
- `perpage` (`integer`, optional): Records per page, up to 250. Example: 50.
- `state` (`string`, optional): Event state filter. Example: upcoming.

Example input: `{}`

### `centralstationcrm_comments_list`

List Comments · Read-only

List comments on records in the account.
Returns each comment's ID, text, author and linked record.

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

Inputs:

- `order` (`string`, optional): Sort order. Example: date-desc.
- `page` (`integer`, optional): Page number, starting at 1. Example: 1.
- `perpage` (`integer`, optional): Records per page, up to 250. Example: 50.

Example input: `{}`

### `centralstationcrm_companies_list`

List Companies · Read-only

List companies, with paging, ordering and an optional tag filter.
Returns each company's ID, name, background and owner, plus any includes.
Use centralstationcrm_companies_search to find a company by name.

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

Inputs:

- `includes` (`string`, optional): Related data to embed, separated by spaces. Request only what you need; avoid all. Example: people tags.
- `order` (`string`, optional): Sort order. Example: update-desc. One of: `date-asc`, `date-desc`, `new-asc`, `new-desc`, `update-asc`, `update-desc`, `abc-asc`, `abc-desc`.
- `page` (`integer`, optional): Page number, starting at 1. Example: 1.
- `perpage` (`integer`, optional): Records per page, up to 250. Example: 50.
- `tag_id` (`integer`, optional): Only companies with this tag ID. Example: 5678.
- `tag_name` (`string`, optional): Only companies with this tag name. Example: Customer.

Example input: `{}`

### `centralstationcrm_companies_search`

Search Companies · Read-only

Search companies by name.
Returns matching companies with ID, name and any includes.
Use it to find a company ID.

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

Inputs:

- `includes` (`string`, optional): Related data to embed, separated by spaces. Request only what you need; avoid all. Example: people.
- `name` (`string`, optional): Company name to match. Example: Acme.
- `page` (`integer`, optional): Page number, starting at 1. Example: 1.
- `perpage` (`integer`, optional): Records per page, up to 250. Example: 50.

Example input: `{}`

### `centralstationcrm_company_get`

Get Company · Read-only

Get one company by ID.
Returns the company's name, background, owner and any includes such as people, addresses and deals.
Use centralstationcrm_companies_search to find the ID.

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

Inputs:

- `company_id` (`integer`, required): ID of the company. Get it from centralstationcrm_companies_search. Example: 1234567.
- `includes` (`string`, optional): Related data to embed, separated by spaces. Request only what you need; avoid all. Example: people addrs tels emails deals.

Example input: `{"company_id":1234567}`

### `centralstationcrm_connection_check`

Check Connection · Read-only

Check that the API key works for this CentralStationCRM account.
Returns the connection status.
Run it first to confirm the connection.

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

Inputs: none.

Example input: `{}`

### `centralstationcrm_current_user_get`

Get Current User · Read-only

Get the CentralStationCRM user the API key belongs to.
Returns the user's ID, name, email and role.
Use centralstationcrm_users_list for every user in the account.

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

Inputs: none.

Example input: `{}`

### `centralstationcrm_custom_field_types_list`

List Custom Field Types · Read-only

List the custom field types defined in the account.
Returns each type's ID, name and record type.

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

Inputs:

- `order` (`string`, optional): Ordering of records using one of the following order options: `id-asc`, `id-desc`. Example: example.
- `page` (`integer`, optional): Page number, starting at 1. Example: 1.
- `perpage` (`integer`, optional): Records per page, up to 250. Example: 50.

Example input: `{}`

### `centralstationcrm_deal_get`

Get Deal · Read-only

Get one deal by ID.
Returns the deal's name, value, currency, state or pipeline stage, target date, owner and any includes.
Use centralstationcrm_deals_search to find the ID.

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

Inputs:

- `deal_id` (`integer`, required): ID of the deal. Get it from centralstationcrm_deals_search. Example: 1234567.
- `includes` (`string`, optional): Related data to embed, separated by spaces. Request only what you need; avoid all. Example: people company tasks tags.

Example input: `{"deal_id":1234567}`

### `centralstationcrm_deal_type_get`

Get Deal Pipeline · Read-only

Get one deal pipeline with its stages.
Returns the pipeline name and each stage's ID, name and default probability.
Use the stage IDs as deal_type_stage_id in centralstationcrm_deal_create.

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

Inputs:

- `deal_type_id` (`integer`, required): ID of the deal pipeline. Get it from centralstationcrm_deal_types_list. Example: 1234567.

Example input: `{"deal_type_id":1234567}`

### `centralstationcrm_deal_types_list`

List Deal Pipelines · Read-only

List the deal pipelines (deal types) in the account.
Returns each pipeline's ID and name.
Use centralstationcrm_deal_type_get for a pipeline's stages.

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

Inputs: none.

Example input: `{}`

### `centralstationcrm_deals_list`

List Deals · Read-only

List deals, with paging, ordering and an optional tag filter.
Returns each deal's ID, name, value, state, pipeline stage and target date.
Use centralstationcrm_deals_search to find a deal by name.

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

Inputs:

- `includes` (`string`, optional): Related data to embed, separated by spaces. Request only what you need; avoid all. Example: people company tags.
- `order` (`string`, optional): Sort order. Example: update-desc. One of: `date-asc`, `date-desc`, `new-asc`, `new-desc`, `update-asc`, `update-desc`, `abc-asc`, `abc-desc`, `value-asc`, `value-desc`, `state-asc`, `state-desc`.
- `page` (`integer`, optional): Page number, starting at 1. Example: 1.
- `perpage` (`integer`, optional): Records per page, up to 250. Example: 50.
- `tag_id` (`integer`, optional): Only deals with this tag ID. Example: 5678.
- `tag_name` (`string`, optional): Only deals with this tag name. Example: Q3.

Example input: `{}`

### `centralstationcrm_deals_search`

Search Deals · Read-only

Search deals by name.
Returns matching deals with ID, name, value and state.
Use it to find a deal ID.

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

Inputs:

- `includes` (`string`, optional): Related data to embed, separated by spaces. Request only what you need; avoid all. Example: company.
- `name` (`string`, optional): Deal name to match. Example: Website relaunch.
- `page` (`integer`, optional): Page number, starting at 1. Example: 1.
- `perpage` (`integer`, optional): Records per page, up to 250. Example: 50.

Example input: `{}`

### `centralstationcrm_group_calendars_list`

List Group Calendars · Read-only

List the group calendars in the account.
Returns each calendar's ID and name.
Use the ID as group_calendar_id in centralstationcrm_calendar_event_create.

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

Inputs:

- `includes` (`string`, optional): Related data to embed, separated by spaces. Request only what you need; avoid all. Example: tags.
- `order` (`string`, optional): Ordering of records using one of the following order options: `id-asc`, `id-desc`. Example: example.
- `page` (`integer`, optional): Page number, starting at 1. Example: 1.
- `perpage` (`integer`, optional): Records per page, up to 250. Example: 50.

Example input: `{}`

### `centralstationcrm_note_get`

Get Note · Read-only

Get one note (protocol) by ID.
Returns the note's type, title, content, date and linked records.

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

Inputs:

- `note_id` (`string`, required): ID of the note. Get it from centralstationcrm_notes_list. Example: 1234567.
- `includes` (`string`, optional): Related data to embed, separated by spaces. Request only what you need; avoid all. Example: tags.

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

### `centralstationcrm_notes_list`

List Notes · Read-only

List notes (protocols) such as call notes and meeting notes, optionally for one person, company, deal or project.
Returns each note's ID, type, title, content and date.
Use centralstationcrm_note_get for one note.

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

Inputs:

- `company_id` (`integer`, optional): Only notes linked to this company. Example: 234567.
- `deal_id` (`integer`, optional): Only notes linked to this deal. Example: 345678.
- `includes` (`string`, optional): Related data to embed, separated by spaces. Request only what you need; avoid all. Example: people companies.
- `order` (`string`, optional): Sort order. Example: date-desc.
- `page` (`integer`, optional): Page number, starting at 1. Example: 1.
- `perpage` (`integer`, optional): Records per page, up to 250. Example: 50.
- `person_id` (`integer`, optional): Only notes linked to this person. Example: 1234567.
- `project_id` (`integer`, optional): Only notes linked to this project. Example: 456789.

Example input: `{}`

### `centralstationcrm_people_count`

Count People · Read-only

Count the people in the account.
Returns the total number of people.

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

Inputs:

- `tag_id` (`integer`, optional): Optionally submit a tag ID in order to only see people tagged with the submitted tag. Example: 1.
- `tag_name` (`string`, optional): Optionally submit a tag name in order to only see people tagged with the submitted tag. Example: example.

Example input: `{}`

### `centralstationcrm_people_list`

List People · Read-only

List people (contacts), with paging, ordering and an optional tag filter.
Returns each person's ID, name, title, background and owner, plus any includes.
Use centralstationcrm_people_search to find people by name, email or phone.

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

Inputs:

- `includes` (`string`, optional): Related data to embed, separated by spaces. Request only what you need; avoid all. Example: positions companies tags.
- `order` (`string`, optional): Sort order. Example: update-desc. One of: `date-asc`, `date-desc`, `new-asc`, `new-desc`, `update-asc`, `update-desc`, `abc-asc`, `abc-desc`.
- `page` (`integer`, optional): Page number, starting at 1. Example: 1.
- `perpage` (`integer`, optional): Records per page, up to 250. Example: 50.
- `tag_id` (`integer`, optional): Only people with this tag ID. Example: 5678.
- `tag_name` (`string`, optional): Only people with this tag name. Example: VIP.

Example input: `{}`

### `centralstationcrm_people_search`

Search People · Read-only

Search people by name, first name, email or phone.
Returns matching people with ID, name and any includes.
Use it to find a person ID. Use centralstationcrm_search to search every record type.

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

Inputs:

- `email` (`string`, optional): Email address to match. Example: anna.miller@example.com.
- `first_name` (`string`, optional): First name to match. Example: Anna.
- `includes` (`string`, optional): Related data to embed, separated by spaces. Request only what you need; avoid all. Example: positions companies.
- `name` (`string`, optional): Last name to match. Example: Miller.
- `page` (`integer`, optional): Page number, starting at 1. Example: 1.
- `perpage` (`integer`, optional): Records per page, up to 250. Example: 50.
- `phone` (`string`, optional): Phone number to match. Example: +49 30 1234567.

Example input: `{}`

### `centralstationcrm_person_contact_details_list`

List Person Contact Details · Read-only

List a person's contact details: phone numbers, emails, websites and messenger handles.
Returns each detail's ID, type and value.

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

Inputs:

- `person_id` (`integer`, required): ID of the person. Get it from centralstationcrm_people_search. Example: 1234567.
- `order` (`string`, optional): Ordering of records using one of the following order options: `id-asc`, `id-desc`. Example: example.
- `page` (`integer`, optional): Page number, starting at 1. Example: 1.
- `perpage` (`integer`, optional): Records per page, up to 250. Example: 50.

Example input: `{"person_id":1234567}`

### `centralstationcrm_person_get`

Get Person · Read-only

Get one person by ID.
Returns the person's name, title, gender, background, owner and any includes such as emails, phone numbers and positions.
Use centralstationcrm_people_search to find the ID.

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

Inputs:

- `person_id` (`integer`, required): ID of the person. Get it from centralstationcrm_people_search. Example: 1234567.
- `includes` (`string`, optional): Related data to embed, separated by spaces, such as emails tels positions companies tags. Example: emails tels positions companies tags.

Example input: `{"person_id":1234567}`

### `centralstationcrm_person_positions_list`

List Person Positions · Read-only

List a person's positions (job roles at companies).
Returns each position's company, job title and department.

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

Inputs:

- `person_id` (`integer`, required): ID of the person. Get it from centralstationcrm_people_search. Example: 1234567.
- `includes` (`string`, optional): Related data to embed, separated by spaces. Request only what you need; avoid all. Example: tags.
- `order` (`string`, optional): Ordering of records using one of the following order options: `id-asc`, `id-desc`. Example: example.
- `page` (`integer`, optional): Page number, starting at 1. Example: 1.
- `perpage` (`integer`, optional): Records per page, up to 250. Example: 50.

Example input: `{"person_id":1234567}`

### `centralstationcrm_project_get`

Get Project · Read-only

Get one project by ID.
Returns the project's name, state, target date, owner, background and any includes.

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

Inputs:

- `project_id` (`integer`, required): ID of the project. Get it from centralstationcrm_projects_search. Example: 1234567.
- `includes` (`string`, optional): Related data to embed, separated by spaces. Request only what you need; avoid all. Example: people company tasks.

Example input: `{"project_id":1234567}`

### `centralstationcrm_projects_list`

List Projects · Read-only

List projects, with paging, ordering and an optional tag filter.
Returns each project's ID, name, state, target date and owner.
Use centralstationcrm_projects_search to find a project by name.

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

Inputs:

- `includes` (`string`, optional): Related data to embed, separated by spaces. Request only what you need; avoid all. Example: people company tags.
- `order` (`string`, optional): Sort order. Example: update-desc. One of: `date-asc`, `date-desc`, `new-asc`, `new-desc`, `update-asc`, `update-desc`, `abc-asc`, `abc-desc`.
- `page` (`integer`, optional): Page number, starting at 1. Example: 1.
- `perpage` (`integer`, optional): Records per page, up to 250. Example: 50.
- `tag_id` (`integer`, optional): Only projects with this tag ID. Example: 5678.
- `tag_name` (`string`, optional): Only projects with this tag name. Example: Onboarding.

Example input: `{}`

### `centralstationcrm_projects_search`

Search Projects · Read-only

Search projects by name.
Returns matching projects with ID, name and state.
Use it to find a project ID.

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

Inputs:

- `includes` (`string`, optional): Related data to embed, separated by spaces. Request only what you need; avoid all. Example: company.
- `name` (`string`, optional): Project name to match. Example: Onboarding.
- `page` (`integer`, optional): Page number, starting at 1. Example: 1.
- `perpage` (`integer`, optional): Records per page, up to 250. Example: 50.

Example input: `{}`

### `centralstationcrm_search`

Search All Records · Read-only

Search people, companies, deals and projects at once by a term.
Returns matching records grouped by type.
Use it when the record type is unknown. Use the type-specific search tools to filter by type.

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

Inputs:

- `term` (`string`, required): Text to search for, such as a name or email. Example: Miller.

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

### `centralstationcrm_tags_list`

List Tags · Read-only

List tags, optionally only those on one person, company, deal or project.
Returns each tag's ID, name and the record it is attached to.

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

Inputs:

- `company_id` (`integer`, optional): Only tags on this company. Example: 234567.
- `deal_id` (`integer`, optional): Only tags on this deal. Example: 345678.
- `order` (`string`, optional): Sort order. Example: abc-asc.
- `page` (`integer`, optional): Page number, starting at 1. Example: 1.
- `perpage` (`integer`, optional): Records per page, up to 250. Example: 50.
- `person_id` (`integer`, optional): Only tags on this person. Example: 1234567.
- `project_id` (`integer`, optional): Only tags on this project. Example: 456789.

Example input: `{}`

### `centralstationcrm_task_get`

Get Task · Read-only

Get one task by ID.
Returns the task's name, due time, finished flag, owner and linked record.

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

Inputs:

- `task_id` (`string`, required): ID of the task. Get it from centralstationcrm_tasks_list. Example: 1234567.
- `includes` (`string`, optional): Related data to embed, separated by spaces. Request only what you need; avoid all. Example: tags.

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

### `centralstationcrm_tasks_list`

List Tasks · Read-only

List tasks, with paging, a state filter and a due-date window.
Returns each task's ID, name, due time, finished flag, owner and linked record.
Use centralstationcrm_task_get for one task.

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

Inputs:

- `after` (`string`, optional): Only tasks due after this date, YYYY-MM-DD. Example: 2026-01-01.
- `before` (`string`, optional): Only tasks due before this date, YYYY-MM-DD. Example: 2026-12-31.
- `includes` (`string`, optional): Related data to embed, separated by spaces. Request only what you need; avoid all. Example: attachable.
- `order` (`string`, optional): Sort order. Example: date-asc.
- `page` (`integer`, optional): Page number, starting at 1. Example: 1.
- `perpage` (`integer`, optional): Records per page, up to 250. Example: 50.
- `state` (`string`, optional): Task state filter, such as open or finished. Example: open.
- `user_id` (`string`, optional): Only tasks of this user. Example: 12345.

Example input: `{}`

### `centralstationcrm_users_list`

List Users · Read-only

List the users of the CentralStationCRM account.
Returns each user's ID, name, email and active flag.
Use it to find a user_id to assign records or tasks to.

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

Inputs:

- `active` (`string`, optional): Set to true for active users only. Example: true.
- `page` (`integer`, optional): Page number, starting at 1. Example: 1.
- `perpage` (`integer`, optional): Records per page, up to 250. Example: 50.

Example input: `{}`

### `centralstationcrm_calendar_event_create`

Create Calendar Event · Write

Create a calendar event for a user in a group calendar, optionally linked to a record.
Returns the new event with its ID.
Use centralstationcrm_group_calendars_list for group_calendar_id.

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

Inputs:

- `ends_at` (`string`, required): End, ISO 8601. Example: 2026-06-02T11:00:00+02:00.
- `group_calendar_id` (`string`, required): ID of the group calendar. Get it from centralstationcrm_group_calendars_list. Example: 3.
- `name` (`string`, required): Name. Example: Demo with Acme.
- `starts_at` (`string`, required): Start, ISO 8601. Example: 2026-06-02T10:00:00+02:00.
- `status` (`string`, required): Event status, such as confirmed or tentative. Example: confirmed.
- `user_id` (`integer`, required): ID of the user the event belongs to. Example: 12345.
- `all_day` (`boolean`, optional): true for an all-day event. Example: false.
- `attachable_id` (`integer`, optional): ID of the linked record. Example: 234567.
- `attachable_type` (`string`, optional): Type of the linked record: Person, Company, Deal or Project. Example: Company. One of: `Person`, `Company`, `Deal`, `Project`.
- `description` (`string`, optional): details regarding the event, e.g. agenda. Example: Product demo.
- `email_invitations` (`boolean`, optional): true to email invitations to attendees. Example: false.
- `includes` (`string`, optional): Related data to embed, separated by spaces. Request only what you need; avoid all. Example: tags.
- `location` (`string`, optional): description of the location, can be an address, a Meeting room id or left blank. Example: Online.

Example input: `{"ends_at":"<ends_at>","group_calendar_id":"<group_calendar_id>","name":"<name>","starts_at":"<starts_at>","status":"<status>","user_id":12345}`

### `centralstationcrm_calendar_event_update`

Update Calendar Event · Write

Update a calendar event's name, time, location or status.
Returns the updated event.
Only the fields you pass change.

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

Inputs:

- `calendar_event_id` (`string`, required): ID of the calendar event. Get it from centralstationcrm_calendar_events_list. Example: 1234567.
- `all_day` (`boolean`, optional): set to true for events that last the whole day (e.g. holidays). Example: false.
- `attachable_id` (`integer`, optional): id of the record the cal event belongs to (e.g. a person). Example: 234567.
- `attachable_type` (`string`, optional): Type of the linked record: Person, Company, Deal or Project. Example: Company. One of: `Person`, `Company`, `Deal`, `Project`.
- `description` (`string`, optional): details regarding the event, e.g. agenda. Example: Product demo.
- `email_invitations` (`boolean`, optional): set to true and CSCRM will send out email invitations to all attendees. Example: false.
- `ends_at` (`string`, optional): End, ISO 8601. Example: 2026-06-02T11:00:00+02:00.
- `group_calendar_id` (`string`, optional): Group Calendar ID. Example: 3.
- `location` (`string`, optional): description of the location, can be an address, a Meeting room id or left blank. Example: Online.
- `name` (`string`, optional): Name. Example: Demo with Acme.
- `starts_at` (`string`, optional): Start, ISO 8601. Example: 2026-06-02T10:00:00+02:00.
- `status` (`string`, optional): can be new, confirmed, tentative or cancelled. Example: confirmed.
- `user_id` (`integer`, optional): User ID. Example: 12345.

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

### `centralstationcrm_comment_create`

Create Comment · Write

Add a comment to a record such as a note, task or calendar event.
Returns the new comment.

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

Inputs:

- `name` (`string`, required): Comment text. Example: Thanks, I'll follow up.
- `attachable_id` (`string`, optional): ID of the record to comment on. Example: 998877.
- `attachable_type` (`string`, optional): Type of the record to comment on. Example: Protocol. One of: `Attachment`, `CalEvent`, `Protocol`, `ExternalEmail`, `Task`.

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

### `centralstationcrm_company_contact_detail_create`

Add Company Contact Detail · Write

Add a phone number, email or other contact detail to a company.
Returns the new contact detail.
Set attachable_type to Company and attachable_id to the same ID as company_id.

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

Inputs:

- `attachable_id` (`integer`, required): ID of the company; the same value as company_id. Example: 234567.
- `attachable_type` (`string`, required): Record type the detail belongs to: Company. Example: Company. One of: `Company`.
- `atype` (`string`, required): Kind of detail: office, office_hq, mobile, fax, private, voip, skype or other. Example: office. One of: `office`, `office_hq`, `mobile`, `fax`, `private`, `voip`, `skype`, `other`.
- `company_id` (`integer`, required): ID of the company. Get it from centralstationcrm_companies_search. Example: 234567.
- `name` (`string`, required): The phone number or address itself. Example: +49 30 1234567.

Example input: `{"attachable_id":234567,"attachable_type":"Company","atype":"office","company_id":234567,"name":"<name>"}`

### `centralstationcrm_company_create`

Create Company · Write

Create a company.
Returns the new company with its ID.
Link people to it with centralstationcrm_person_position_create.

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

Inputs:

- `name` (`string`, required): Company name. Example: Acme GmbH.
- `background` (`string`, optional): Background notes about the company. Example: Wholesale partner since 2024.
- `group_id` (`integer`, optional): ID of the group. Example: 10.
- `includes` (`string`, optional): Related data to embed, separated by spaces. Request only what you need; avoid all. Example: tags.
- `user_id` (`integer`, optional): ID of the responsible user. Get it from centralstationcrm_users_list. Example: 12345.

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

### `centralstationcrm_company_update`

Update Company · Write

Update a company's name, background or owner.
Returns the updated company.
Only the fields you pass change.

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

Inputs:

- `company_id` (`string`, required): ID of the company. Get it from centralstationcrm_companies_search. Example: 1234567.
- `background` (`string`, optional): Background notes. Example: Wholesale partner since 2024.
- `group_id` (`integer`, optional): ID of the group. Example: 10.
- `name` (`string`, optional): Company name. Example: Acme GmbH.
- `user_id` (`integer`, optional): ID of the responsible user. Example: 12345.

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

### `centralstationcrm_deal_create`

Create Deal · Write

Create a deal in a pipeline.
Returns the new deal with its ID.
Use centralstationcrm_deal_types_list to find the pipeline (deal_type_id) and stage IDs.

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

Inputs:

- `name` (`string`, required): Name. Example: Website relaunch.
- `background` (`string`, optional): details about the deal e.g. history. Example: Inbound lead from webinar.
- `company_id` (`integer`, optional): ID of the company. Get it from centralstationcrm_companies_search. Example: 234567.
- `currency` (`string`, optional): currency of the deal, either EUR, CHF or USD. Default is EUR. Example: EUR.
- `deal_type_id` (`integer`, optional): ID of the pipeline. Get it from centralstationcrm_deal_types_list. Example: 1.
- `deal_type_stage_id` (`integer`, optional): ID of the stage in the pipeline. Get it from centralstationcrm_deal_type_get. Example: 2.
- `group_id` (`integer`, optional): Group ID. Example: 10.
- `includes` (`string`, optional): Related data to embed, separated by spaces. Request only what you need; avoid all. Example: tags.
- `probability` (`integer`, optional): Chance of winning in percent, 0 to 100. Example: 25.
- `target_date` (`string`, optional): The date when the deal shall be won. Example: 2026-12-31.
- `user_id` (`integer`, optional): ID of the responsible user. Get it from centralstationcrm_users_list. Example: 12345.
- `value` (`string`, optional): The monetary value of the deal; can be null depending on the pipeline configuration. Example: 15000.
- `value_count` (`string`, optional): Only relevant if the value_type is other than total. Example: 1.
- `value_type` (`string`, optional): The type of billing, either `total`, `monthly`, `hourly` or `daily`. Can be null depending on the pipeline configuration. Example: total.

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

### `centralstationcrm_deal_update`

Update Deal · Write

Update a deal's name, value, stage, probability, target date or owner.
Returns the updated deal.
Only the fields you pass change.

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

Inputs:

- `deal_id` (`string`, required): ID of the deal. Get it from centralstationcrm_deals_search. Example: 1234567.
- `background` (`string`, optional): details about the deal e.g. history. Example: Inbound lead from webinar.
- `company_id` (`integer`, optional): Company ID. Example: 234567.
- `currency` (`string`, optional): currency of the deal, either EUR, CHF or USD. Default is EUR. Example: EUR.
- `current_state` (`string`, optional): Set to won or lost to close the deal; open0, open25, open50 or open75 for an open deal without pipeline stages. Example: won. One of: `open0`, `open25`, `open50`, `open75`, `won`, `lost`.
- `deal_type_id` (`integer`, optional): ID of the pipeline. Example: 1.
- `deal_type_stage_id` (`integer`, optional): ID of the stage in the pipeline. Example: 2.
- `group_id` (`integer`, optional): Group ID. Example: 10.
- `name` (`string`, optional): Name. Example: Website relaunch.
- `probability` (`integer`, optional): Chance of winning in percent, 0 to 100. Example: 25.
- `target_date` (`string`, optional): The date when the deal shall be won. Example: 2026-12-31.
- `user_id` (`integer`, optional): User ID. Example: 12345.
- `value` (`string`, optional): The monetary value of the deal; can be null depending on the pipeline configuration. Example: 15000.
- `value_count` (`string`, optional): Only relevant if the value_type is other than total. Example: 1.
- `value_type` (`string`, optional): The type of billing, either `total`, `monthly`, `hourly` or `daily`. Can be null depending on the pipeline configuration. Example: total.

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

### `centralstationcrm_note_create`

Create Note · Write

Create a note (protocol), such as a call or meeting note, linked to people, companies, deals or projects.
Returns the new note with its ID.

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

Inputs:

- `content` (`string`, required): Text of the note. Example: Discussed the offer; follow up next week.
- `badge` (`string`, optional): DEPRECATED: Use conversion_step_names instead. Protocols created in the web interface always have the badge note, the type chosen there (e.g. call or meeting) is stored as a conversion step. Read it via the methods parameter (`methods=conversion_step_names`) and set it via `conversion_step_names` in the protocol object. For a ProtocolEmail the badge can only be email, for a ProtocolObjectNote it can be one of note, call, email, meeting or other. Example: call.
- `company_ids` (`array`, optional): An array of the company ids the protocol shall be assigned to. Example: [234567].
- `confidential` (`boolean`, optional): true to hide the note from other users. Example: false.
- `conversion_step_names` (`array`, optional): An array of conversion step names the protocol shall be assigned to. Leading and trailing whitespace is removed, then each name has to match an existing conversion step exactly. This is the type chosen in the web interface (e.g. call or meeting). Example: ["meeting"].
- `deal_ids` (`array`, optional): An array of the deal ids the protocol shall be assigned to. Example: [345678].
- `format` (`string`, optional): Content format. Example: markdown.
- `includes` (`string`, optional): Related data to embed, separated by spaces. Request only what you need; avoid all. Example: tags.
- `name` (`string`, optional): Title of the note. Example: Call with Anna.
- `occurred_at` (`string`, optional): When it happened, ISO 8601. Example: 2026-05-20T14:00:00+02:00.
- `person_ids` (`array`, optional): An array of the person ids the protocol shall be assigned to. Example: [1234567].
- `project_ids` (`array`, optional): An array of the project ids the protocol shall be assigned to. Example: [456789].
- `type` (`string`, optional): Note type, such as call, meeting or note. Example: call.

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

### `centralstationcrm_note_update`

Update Note · Write

Update a note's title, content, date or links.
Returns the updated note.
Only the fields you pass change.

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

Inputs:

- `note_id` (`string`, required): ID of the note. Get it from centralstationcrm_notes_list. Example: 1234567.
- `badge` (`string`, optional): DEPRECATED: Use conversion_step_names instead. Protocols created in the web interface always have the badge note, the type chosen there (e.g. call or meeting) is stored as a conversion step. Read it via the methods parameter (`methods=conversion_step_names`) and set it via `conversion_step_names` in the protocol object. For a ProtocolEmail the badge can only be email, for a ProtocolObjectNote it can be one of note, call, email, meeting or other. Example: call.
- `company_ids` (`array`, optional): An array of the company ids the protocol shall be assigned to. Example: [234567].
- `confidential` (`boolean`, optional): set to true and this protocol will only be visible for users that have at least poweruser rights. Example: false.
- `content` (`string`, optional): Text of the note. Example: Discussed the offer; follow up next week.
- `conversion_step_names` (`array`, optional): An array of conversion step names the protocol shall be assigned to. Leading and trailing whitespace is removed, then each name has to match an existing conversion step exactly. This is the type chosen in the web interface (e.g. call or meeting). Example: ["example"].
- `deal_ids` (`array`, optional): An array of the deal ids the protocol shall be assigned to. Example: [345678].
- `format` (`string`, optional): Decides how the content will be interpreted. Can be either `plaintext` or `markdown`. Example: markdown.
- `name` (`string`, optional): Title of the note. Example: Call with Anna.
- `occurred_at` (`string`, optional): When the documented event took place (shown as the date of the protocol in the activity stream). Defaults to the time of creation. Set it e.g. when importing historic notes. In contrast, `created_at` is always the time the protocol was created in CentralStationCRM and cannot be changed. Example: 2026-05-20T14:00:00+02:00.
- `person_ids` (`array`, optional): An array of the person ids the protocol shall be assigned to. Example: [1234567].
- `project_ids` (`array`, optional): An array of the project ids the protocol shall be assigned to. Example: [456789].
- `type` (`string`, optional): type of the protocol can be one of ProtocolObjectNote, ProtocolExternal or ProtocolEmail. Example: call.

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

### `centralstationcrm_person_address_create`

Add Person Address · Write

Add a postal address to a person.
Returns the new address.
Set attachable_type to Person and attachable_id to the same ID as person_id.

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

Inputs:

- `attachable_id` (`integer`, required): ID of the person; the same value as person_id. Example: 1234567.
- `attachable_type` (`string`, required): Record type the address belongs to: Person. Example: Person. One of: `Person`.
- `city` (`string`, required): The city name. Either the city or the country_code is mandatory. Example: Berlin.
- `person_id` (`integer`, required): ID of the person. Get it from centralstationcrm_people_search. Example: 1234567.
- `atype` (`string`, optional): Kind of address, such as work, private or delivery. Example: work.
- `country_code` (`string`, optional): Two-letter country code, such as DE. Example: DE.
- `primary` (`boolean`, optional): true to make it the primary address. Example: true.
- `state_code` (`string`, optional): State or region code. Example: BE.
- `street` (`string`, optional): The street including the house number or other details (building, c/o). Example: Hauptstrasse 1.
- `zip` (`string`, optional): The zip code. Example: 10115.

Example input: `{"attachable_id":1234567,"attachable_type":"Person","city":"<city>","person_id":1234567}`

### `centralstationcrm_person_contact_detail_create`

Add Person Contact Detail · Write

Add a phone number, email or other contact detail to a person.
Returns the new contact detail.
Set attachable_type to Person and attachable_id to the same ID as person_id.

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

Inputs:

- `attachable_id` (`integer`, required): ID of the person; the same value as person_id. Example: 1234567.
- `attachable_type` (`string`, required): Record type the detail belongs to: Person. Example: Person. One of: `Person`.
- `atype` (`string`, required): Kind of detail: office, office_hq, mobile, fax, private, voip, skype or other. Example: mobile. One of: `office`, `office_hq`, `mobile`, `fax`, `private`, `voip`, `skype`, `other`.
- `name` (`string`, required): The phone number or address itself. Example: +49 170 1234567.
- `person_id` (`integer`, required): ID of the person. Get it from centralstationcrm_people_search. Example: 1234567.

Example input: `{"attachable_id":1234567,"attachable_type":"Person","atype":"office","name":"<name>","person_id":1234567}`

### `centralstationcrm_person_create`

Create Person · Write

Create a person (contact).
Returns the new person with its ID.
Add emails, phones and addresses afterwards with centralstationcrm_person_contact_detail_create and centralstationcrm_person_address_create.

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

Inputs:

- `name` (`string`, required): Last name of the person. Example: Miller.
- `background` (`string`, optional): Background notes about the person. Example: Met at the 2026 trade fair.
- `country_code` (`string`, optional): Two-letter country code, such as DE. Example: DE.
- `first_name` (`string`, optional): First name. Example: Anna.
- `gender` (`string`, optional): Gender. Example: female.
- `group_id` (`integer`, optional): ID of the group the person belongs to. Example: 10.
- `includes` (`string`, optional): Related data to embed, separated by spaces. Request only what you need; avoid all. Example: tags.
- `salutation` (`string`, optional): Salutation, such as Mr or Ms. Example: Ms.
- `title` (`string`, optional): Academic title, such as Dr. Example: Dr.
- `user_id` (`integer`, optional): ID of the user responsible for the person. Get it from centralstationcrm_users_list. Example: 12345.

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

### `centralstationcrm_person_position_create`

Add Person Position · Write

Link a person to a company with a job title and department.
Returns the new position.
Use centralstationcrm_companies_search to find the company ID.

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

Inputs:

- `company_id` (`integer`, required): ID of the company. Get it from centralstationcrm_companies_search. Example: 234567.
- `person_id` (`integer`, required): ID of the person. Get it from centralstationcrm_people_search. Example: 1234567.
- `company_name` (`string`, optional): Company name, if no company_id is given. Example: Acme GmbH.
- `department` (`string`, optional): Department. Example: Sales.
- `former` (`boolean`, optional): true if the person no longer holds this position. Example: false.
- `name` (`string`, optional): Job title. Example: Head of Sales.
- `primary_function` (`boolean`, optional): true if this is the person's main position. Example: true.

Example input: `{"company_id":234567,"person_id":1234567}`

### `centralstationcrm_person_update`

Update Person · Write

Update a person's name, title, background or owner.
Returns the updated person.
Only the fields you pass change.

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

Inputs:

- `person_id` (`string`, required): ID of the person. Get it from centralstationcrm_people_search. Example: 1234567.
- `background` (`string`, optional): Background notes about the person. Example: Met at the 2026 trade fair.
- `country_code` (`string`, optional): Two-letter country code, such as DE. Example: DE.
- `first_name` (`string`, optional): First name. Example: Anna.
- `gender` (`string`, optional): Gender. Example: female.
- `group_id` (`integer`, optional): ID of the group the person belongs to. Example: 10.
- `name` (`string`, optional): Last name of the person. Example: Miller.
- `salutation` (`string`, optional): Salutation, such as Mr or Ms. Example: Ms.
- `title` (`string`, optional): Academic title, such as Dr. Example: Dr.
- `user_id` (`integer`, optional): ID of the user responsible for the person. Get it from centralstationcrm_users_list. Example: 12345.

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

### `centralstationcrm_project_create`

Create Project · Write

Create a project.
Returns the new project with its ID.

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

Inputs:

- `name` (`string`, required): Name. Example: Acme onboarding.
- `target_date` (`string`, required): Planned end date, YYYY-MM-DD. Example: 2026-12-31.
- `background` (`string`, optional): details about the project e.g. history. Example: Kick-off in January.
- `company_id` (`integer`, optional): ID of the company. Example: 234567.
- `current_state` (`string`, optional): Project state, such as open or finished. Example: open.
- `deal_id` (`integer`, optional): ID of the related deal. Example: 345678.
- `finished_at` (`string`, optional): Date the project was finished, YYYY-MM-DD. Example: 2026-12-20.
- `group_id` (`integer`, optional): Group ID. Example: 10.
- `includes` (`string`, optional): Related data to embed, separated by spaces. Request only what you need; avoid all. Example: tags.
- `person_ids_set` (`string`, optional): assign people to the project by sending comma separated ids (e.g. `42,4711`). Example: example.
- `user_id` (`integer`, optional): ID of the responsible user. Example: 12345.

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

### `centralstationcrm_project_update`

Update Project · Write

Update a project's name, state, target date or owner.
Returns the updated project.
Only the fields you pass change.

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

Inputs:

- `project_id` (`string`, required): ID of the project. Get it from centralstationcrm_projects_search. Example: 1234567.
- `background` (`string`, optional): details about the project e.g. history. Example: Kick-off in January.
- `company_id` (`integer`, optional): Company ID. Example: 234567.
- `current_state` (`string`, optional): Project state, such as open or finished. Example: finished.
- `deal_id` (`integer`, optional): Deal ID. Example: 345678.
- `finished_at` (`string`, optional): Date the project was finished, YYYY-MM-DD. Example: 2026-12-20.
- `group_id` (`integer`, optional): Group ID. Example: 10.
- `name` (`string`, optional): Name. Example: Acme onboarding.
- `person_ids_set` (`string`, optional): assign people to the project by sending comma separated ids (e.g. `42,4711`). Example: example.
- `target_date` (`string`, optional): Planned end date, YYYY-MM-DD. Example: 2026-12-31.
- `user_id` (`integer`, optional): User ID. Example: 12345.

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

### `centralstationcrm_tag_create`

Add Tag · Write

Tag a person, company, deal or project.
Returns the new tag.
Use centralstationcrm_tags_list to see existing tag names.

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

Inputs:

- `attachable_id` (`integer`, required): ID of the record to tag. Example: 1234567.
- `attachable_type` (`string`, required): Type of the record to tag: Person, Company, Deal or Project. Example: Person. One of: `Person`, `Company`, `Deal`, `Project`.
- `name` (`string`, required): Tag name. Example: VIP.

Example input: `{"attachable_id":1234567,"attachable_type":"Person","name":"<name>"}`

### `centralstationcrm_task_create`

Create Task · Write

Create a task for a user, optionally linked to a person, company, deal or project.
Returns the new task with its ID.

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

Inputs:

- `name` (`string`, required): Task text. Example: Call Anna about the offer.
- `user_id` (`integer`, required): ID of the user the task is assigned to. Get it from centralstationcrm_users_list. Example: 12345.
- `attachable_id` (`integer`, optional): ID of the linked record. Example: 1234567.
- `attachable_type` (`string`, optional): Type of the linked record: Person, Company, Deal or Project. Example: Person. One of: `Person`, `Company`, `Deal`, `Project`.
- `badge` (`string`, optional): Task badge, such as call, email or meeting. Example: call.
- `finished` (`boolean`, optional): true if the task is already done. Example: false.
- `fuzzy` (`boolean`, optional): true if the due date has no exact time. Example: false.
- `includes` (`string`, optional): Related data to embed, separated by spaces. Request only what you need; avoid all. Example: tags.
- `precise_time` (`string`, optional): Due date and time, ISO 8601. Example: 2026-06-01T10:00:00+02:00.
- `task_list_id` (`integer`, optional): ID of a task list to add the task to. Example: 77.

Example input: `{"name":"<name>","user_id":12345}`

### `centralstationcrm_task_update`

Update Task · Write

Update a task's text, due time or owner, or mark it finished.
Returns the updated task.
Only the fields you pass change.

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

Inputs:

- `task_id` (`string`, required): ID of the task. Get it from centralstationcrm_tasks_list. Example: 1234567.
- `attachable_id` (`integer`, optional): id of the record the task belongs to (e.g. a person). Example: 1234567.
- `attachable_type` (`string`, optional): Type of the linked record: Person, Company, Deal or Project. Example: Person. One of: `Person`, `Company`, `Deal`, `Project`.
- `badge` (`string`, optional): can be task, call, email, visit, preparation or important. Default will be task. Example: call.
- `finished` (`boolean`, optional): true to mark the task done. Example: true.
- `fuzzy` (`boolean`, optional): set to true, if the precise_time hour and minutes are irrelevant, but the task may be done at any time during the day. Example: false.
- `name` (`string`, optional): Name. Example: Call Anna about the offer.
- `precise_time` (`string`, optional): Due date and time, ISO 8601. Example: 2026-06-01T10:00:00+02:00.
- `task_list_id` (`integer`, optional): id of the task list the task belongs to (has to be within the attachable record). Example: 77.
- `user_id` (`integer`, optional): User ID. Example: 12345.

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

### `centralstationcrm_calendar_event_delete`

Delete Calendar Event · Destructive

Delete a calendar event.
Returns an empty response on success.

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

Inputs:

- `calendar_event_id` (`string`, required): ID of the calendar event. Get it from centralstationcrm_calendar_events_list. Example: 1234567.

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

### `centralstationcrm_company_delete`

Delete Company · Destructive

Delete a company and the data attached to it.
Returns an empty response on success.

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

Inputs:

- `company_id` (`string`, required): ID of the company. Get it from centralstationcrm_companies_search. Example: 1234567.

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

### `centralstationcrm_deal_delete`

Delete Deal · Destructive

Delete a deal.
Returns an empty response on success.

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

Inputs:

- `deal_id` (`string`, required): ID of the deal. Get it from centralstationcrm_deals_search. Example: 1234567.

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

### `centralstationcrm_note_delete`

Delete Note · Destructive

Delete a note (protocol).
Returns an empty response on success.

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

Inputs:

- `note_id` (`string`, required): ID of the note. Get it from centralstationcrm_notes_list. Example: 1234567.

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

### `centralstationcrm_person_delete`

Delete Person · Destructive

Delete a person and the data attached to them.
Returns an empty response on success.

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

Inputs:

- `person_id` (`string`, required): ID of the person. Get it from centralstationcrm_people_search. Example: 1234567.

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

### `centralstationcrm_project_delete`

Delete Project · Destructive

Delete a project.
Returns an empty response on success.

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

Inputs:

- `project_id` (`string`, required): ID of the project. Get it from centralstationcrm_projects_search. Example: 1234567.

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

### `centralstationcrm_task_delete`

Delete Task · Destructive

Delete a task.
Returns an empty response on success.

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

Inputs:

- `task_id` (`string`, required): ID of the task. Get it from centralstationcrm_tasks_list. Example: 1234567.

Example input: `{"task_id":"<task_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 |
