# CentralStationCRM

CentralStationCRM is an easy-to-use CRM software focusing on collaboration and long-term customer relationships.

- **Category:** crm
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 201
- **Triggers:** 0
- **Slug:** `CENTRALSTATIONCRM`
- **Version:** 20260227_00

## Tools

### Check Connection

**Slug:** `CENTRALSTATIONCRM_CHECK_CONNECTION`

Tool to verify the connection status of the CentralStationCRM API key. Use when validating credentials before making other API calls.

#### Output

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

### Count Activities

**Slug:** `CENTRALSTATIONCRM_COUNT_ACTIVITIES`

Tool to retrieve activities count for a record, account, or user. Use when you need to get the total count of activities filtered by person, company, deal, project, or account.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Retrieve records of the given page. |
| `deal_id` | integer | No | ID of the desired deal activities. |
| `methods` | string | No | Possible methods are: attachable, responsible_user_natural_name separated by space. Receive all methods using the 'all' value. |
| `perpage` | integer | No | Elements per page, maximum of 250. |
| `includes` | string | No | Possible includes are: user, activity_receivers separated by space. Receive all includes using the 'all' value. |
| `person_id` | integer | No | ID of the desired person activities. |
| `account_id` | integer | No | ID of the desired account activities. |
| `company_id` | integer | No | ID of the desired company activities. |
| `project_id` | integer | No | ID of the desired project activities. |

#### Output

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

### Count Attachments

**Slug:** `CENTRALSTATIONCRM_COUNT_ATTACHMENTS`

Tool to retrieve the total count and total file size of attachments. Use when you need to know how many attachments exist and their combined size in the CentralStationCRM account.

#### Output

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

### Count Avatars

**Slug:** `CENTRALSTATIONCRM_COUNT_AVATARS`

Tool to retrieve the total count and total file size of avatars in the system. Use when you need statistics about avatar storage, such as total number of avatar files and their combined storage size.

#### Output

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

### Count Companies External Emails

**Slug:** `CENTRALSTATIONCRM_COUNT_COMPANIES_EXTERNAL_EMAILS`

Tool to retrieve the total amount of external emails for a specific company. Use when you need to count how many external emails are associated with a particular company in CentralStationCRM.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `company_id` | integer | Yes | ID of the company to retrieve external email count for |

#### Output

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

### Count Deals External Emails

**Slug:** `CENTRALSTATIONCRM_COUNT_DEALS_EXTERNAL_EMAILS`

Tool to retrieve the total amount of external emails for a specific deal. Use when you need to count how many external emails are associated with a particular deal in CentralStationCRM.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `deal_id` | integer | Yes | ID of the deal to retrieve external email count for |

#### Output

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

### Count External Emails

**Slug:** `CENTRALSTATIONCRM_COUNT_EXTERNAL_EMAILS`

Tool to retrieve the total amount of external emails. Use when you need to count all external emails in CentralStationCRM.

#### Output

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

### Count People with Filters

**Slug:** `CENTRALSTATIONCRM_COUNT_PEOPLE2`

Tool to retrieve the total count of people with optional filtering capabilities. Use when you need to count people by tags or specific attributes. Supports filtering by tag ID, tag name, or custom filter expressions.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `filter` | object | No | Optionally submit one of the people attributes in order to filter by them (e.g. { 'name': { 'equal': 'your-value' } }). Allowed filter modifiers are `smaller_than`, `larger_than`, `equal`, `between` or `in`. Whereas smaller_than, larger_than and equal expect one value, between expects exactly two values comma separated (e.g. `{ 'between': '2023-01-01,2023-02-01' }`) and `in` allows a list of comma separated options (e.g. `{ 'in': '23,42,99' }`). |
| `tag_id` | integer | No | Optionally submit a tag ID in order to only see people tagged with the submitted tag |
| `tag_name` | string | No | Optionally submit a tag name in order to only see people tagged with the submitted tag |

#### Output

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

### Count People External Emails

**Slug:** `CENTRALSTATIONCRM_COUNT_PEOPLE_EXTERNAL_EMAILS`

Tool to retrieve the total amount of external emails for a specific person. Use when you need to count how many external emails are associated with a particular person in CentralStationCRM.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `person_id` | integer | Yes | ID of the person to retrieve external email count for |

#### Output

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

### Count Projects External Emails

**Slug:** `CENTRALSTATIONCRM_COUNT_PROJECTS_EXTERNAL_EMAILS`

Tool to retrieve the total amount of external emails for a specific project. Use when you need to count how many external emails are associated with a particular project in CentralStationCRM.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `project_id` | integer | Yes | ID of the project to retrieve external email count for |

#### Output

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

### Count Protocols

**Slug:** `CENTRALSTATIONCRM_COUNT_PROTOCOLS`

Tool to retrieve the total number of protocols in the account. Use when you need the current total number of protocols in your CentralStationCRM account.

#### Output

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

### Create Attachments

**Slug:** `CENTRALSTATIONCRM_CREATE_ATTACHMENTS`

Tool to create a new attachment in CentralStationCRM. Use when you need to upload a Base64-encoded file to attach to records like people, companies, or deals.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `methods` | string | No | Additional methods to apply (space-separated): responsible_user_natural_name, attachment_category_name. Use 'all' for all methods. |
| `includes` | string | No | Related entities to include in response (space-separated): user, attachment_category, comments. Use 'all' for all includes. |
| `attachment` | object | Yes | Attachment object with filename, content type, and Base64 data |

#### Output

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

### Create Calendar Event

**Slug:** `CENTRALSTATIONCRM_CREATE_CAL_EVENT`

Tool to create a new calendar event in CentralStationCRM. Use when scheduling meetings, appointments, or other time-based events.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `no_log` | boolean | No | Set to true if you don't want to generate an activity for the stream |
| `includes` | string | No | Comma or space-separated list of related entities to include in response (e.g., 'user group_calendar people users cal_event_attendees comments'). Use 'all' to receive all available includes. |
| `cal_event` | object | Yes | Calendar event object containing all event details |

#### Output

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

### Create Calendar Event Attendee

**Slug:** `CENTRALSTATIONCRM_CREATE_CAL_EVENT_ATTENDEE`

Tool to create a calendar event attendee. Use when you need to add an attendee to an existing calendar event.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | No | Email address of the attending person or user. Invitations will be sent to this address if email_notifications is set to true for the related cal event |
| `status` | string ("new" | "invited" | "no_invite" | "accepted" | "rejected" | "perhaps" | "canceled") | Yes | Attendance status of the invitee |
| `user_id` | integer | No | ID of the related CSCRM user. Either person_id or user_id must be set to valid records |
| `person_id` | integer | No | ID of the related CSCRM person. Either person_id or user_id must be set to valid records |
| `cal_event_id` | string | Yes | The unique identifier of the calendar event to add the attendee to |

#### Output

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

### Create Comment

**Slug:** `CENTRALSTATIONCRM_CREATE_COMMENT`

Tool to create a new comment on an entity (task, event, protocol, etc.). Use when you need to add notes or feedback to existing CRM records.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `comment` | object | Yes | Comment object containing all comment details |
| `methods` | string | No | Optional methods parameter. Possible value: responsible_user_natural_name |

#### Output

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

### Create Company with Nested Attributes

**Slug:** `CENTRALSTATIONCRM_CREATE_COMPANIES`

Tool to create a company with nested attributes. Use when you need to add a company with associated contact details, custom fields, or avatar in a single request.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `no_log` | boolean | No | Set to true if you don't want to generate an activity for the stream |
| `company` | object | Yes | Company data including nested attributes |
| `methods` | string | No | Possible methods: responsible_user_natural_name, related_tasks, stream_updated_at, absolute_url (space-separated). Use 'all' for all methods. |
| `includes` | string | No | Possible includes: positions, deals, projects, tags, tasks, pending_tasks, cal_events, upcoming_cal_events, tels, emails, ims, sms, homepages, addrs, connections, custom_fields (space-separated). Use 'all' for all includes. |

#### Output

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

### Create Company Avatar

**Slug:** `CENTRALSTATIONCRM_CREATE_COMPANIES_AVATARS`

Tool to create an avatar for a company. Use when you need to add a profile image or logo to a company record.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `avatar` | object | Yes | Avatar data object containing filename, content type, and base64-encoded image data |
| `company_id` | string | Yes | Unique identifier of the company to add the avatar to |

#### Output

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

### Create Company Protocol Attachment

**Slug:** `CENTRALSTATIONCRM_CREATE_COMPANIES_PROTOCOLS_ATTACHMENTS`

Tool to create an attachment for a company protocol in CentralStationCRM. Use when you need to upload a Base64-encoded file to a specific protocol within a company.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `methods` | string | No | Additional methods to apply (space-separated): responsible_user_natural_name, attachment_category_name. Use 'all' for all methods. |
| `includes` | string | No | Related entities to include in response (space-separated): user, attachment_category, comments. Use 'all' for all includes. |
| `attachment` | object | Yes | Attachment object with filename, content type, and Base64 data |
| `company_id` | integer | Yes | ID of the company the protocol belongs to |
| `protocol_id` | integer | Yes | ID of the protocol to attach the file to |

#### Output

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

### Create Company Address

**Slug:** `CENTRALSTATIONCRM_CREATE_COMPANY_ADDRESS`

Tool to create a new address for a specific company. Use when you need to add postal details to a company record after confirming company ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `zip` | string | No | The postal code |
| `city` | string | Yes | The city name (required) |
| `atype` | string ("work_hq" | "work" | "invoice" | "delivery" | "private" | "other") | Yes | Address type. Must be one of work_hq, work, invoice, delivery, private or other. |
| `street` | string | No | The street including house number or other details (building, c/o) |
| `primary` | boolean | No | Decides ordering of addresses when the company has multiple addresses |
| `api_input` | boolean | No | States whether the address has been added via the API or some sort of integration |
| `company_id` | integer | Yes | The unique identifier of the company to add the address to |
| `state_code` | string | No | The state code (e.g. NW, BY). Must match the country code. |
| `country_code` | string | No | The country code (ISO 3166-1 alpha-2, e.g. DE, AT) |
| `attachable_id` | integer | Yes | The ID of the record the address belongs to. Will be auto set when using nested attributes. |
| `attachable_type` | string ("Person" | "Company") | Yes | The record type the address belongs to. Must be either Person or Company. |

#### Output

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

### Create Company Contact Detail

**Slug:** `CENTRALSTATIONCRM_CREATE_COMPANY_CONTACT_DETAIL`

Tool to create a new contact detail for a specific company. Use when adding a phone number after confirming the company's ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | The phone number or contact value. |
| `atype` | string ("office" | "office_hq" | "mobile" | "fax" | "private" | "voip" | "skype" | "other") | Yes | Phone type. Must be one of office, office_hq, mobile, fax, private, voip, skype or other. |
| `company_id` | integer | Yes | The unique identifier of the company to add the contact detail to |

#### Output

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

### Create Custom Field Type

**Slug:** `CENTRALSTATIONCRM_CREATE_CUSTOM_FIELDS_TYPE`

Tool to create a new custom field type in CentralStationCRM. Use when you need to define a new custom field that can be applied to Person, Company, Deal, or Project entities.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `custom_fields_type` | object | Yes | The custom field type data to create |

#### Output

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

### Create Deal Protocol Attachment

**Slug:** `CENTRALSTATIONCRM_CREATE_DEAL_PROTOCOL_ATTACHMENT`

Tool to create an attachment for a deal protocol. Use when you need to attach a file (document, image, etc.) to a specific protocol within a deal. The file content must be base64-encoded.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `deal_id` | integer | Yes | ID of the deal to which the protocol belongs |
| `methods` | string | No | Additional methods to include in response. Options: 'responsible_user_natural_name', 'attachment_category_name', or 'all' for all methods. Separate multiple values with spaces. |
| `includes` | string | No | Related entities to include in response. Options: 'user', 'attachment_category', 'comments', or 'all' for all includes. Separate multiple values with spaces. |
| `attachment` | object | Yes | Attachment data including filename, content type, and base64-encoded file content |
| `protocol_id` | integer | Yes | ID of the protocol to attach the file to |

#### Output

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

### Create Deal

**Slug:** `CENTRALSTATIONCRM_CREATE_DEALS`

Tool to create a new deal in CentralStationCRM. Use when you need to add a sales opportunity with details like name, value, pipeline, and associated contacts. Supports nested attributes like custom_fields_attributes and tags_attributes.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `deal` | object | Yes | Deal data to create |
| `no_log` | boolean | No | Set to true if you don't want to generate an activity for the stream |
| `methods` | string | No | Possible methods are: responsible_user_natural_name, people_ids, absolute_url, stream_updated_at separated by space. Receive all methods using the 'all' value |
| `includes` | string | No | Possible includes are: tags, people, company, task_lists, tasks, pending_tasks, cal_events, upcoming_cal_events, custom_fields separated by space. Receive all includes using the 'all' value |

#### Output

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

### Create Group Calendar

**Slug:** `CENTRALSTATIONCRM_CREATE_GROUP_CALENDARS`

Tool to create a new group calendar in CentralStationCRM. Use when setting up shared calendars for teams or specific purposes like holidays.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `group_calendar` | object | Yes | Group calendar object containing all calendar details |

#### Output

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

### Create Hook

**Slug:** `CENTRALSTATIONCRM_CREATE_HOOK`

Tool to create a webhook hook in CentralStationCRM. Use when you need to set up automatic notifications for create, update, or destroy events on Person, Company, Deal, or Project records.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `event` | string ("create" | "update" | "destroy") | Yes | Activity that shall trigger the hook (create, update, or destroy) |
| `model` | string ("Person" | "Company" | "Deal" | "Project") | Yes | Object type to be notified about (Person, Company, Deal, or Project) |
| `state` | string ("active" | "disabled") | No | Indicating if the hook is enabled or not. |
| `methods` | array | No | Methods depending on the hook model, e.g. salutation_official for Person |
| `includes` | string | No | Only relevant for object_types nested, api and hook_with_structure_and_record. Subrecords may be specified comma-separated and will be included within the webhooks data (e.g. tags, addrs, historic_events) |
| `hook_type` | string ("url") | Yes | Hook type - currently only 'url' is supported |
| `target_url` | string | Yes | URL to which the webhook should be sent |
| `object_type` | string ("nested" | "api" | "lean" | "hook_with_structure_and_record") | Yes | Data structure of the webhook (nested, api, lean, or hook_with_structure_and_record) |

#### Output

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

### Create People

**Slug:** `CENTRALSTATIONCRM_CREATE_PEOPLE`

Tool to create a person with nested attributes. Use when adding a person with contact details, custom fields, or other nested data in a single request.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `no_log` | boolean | No | Set to true if you don't want to generate an activity for the stream |
| `person` | object | Yes | The person data including nested attributes |
| `methods` | string | No | Possible methods are: responsible_user_natural_name, salutation_official, salutation_formal, salutation_informal, backlink, stream_updated_at, absolute_url, absolute_avatar_url separated by space. Receive all methods using the 'all' value. |
| `includes` | string | No | Possible includes are: positions, companies, deals, projects, tags, tasks, tasks_pending, pending_tasks, upcoming_cal_events, tels, emails, ims, sms, homepages, addrs, addrs_from_company, custom_fields, historic_events, assis, connections, user separated by space. Receive all includes using the 'all' value. |

#### Output

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

### Create People Custom Field

**Slug:** `CENTRALSTATIONCRM_CREATE_PEOPLE_CUSTOM_FIELD`

Tool to create a custom field for a person record. Use when you need to add custom metadata or attributes to a person.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `person_id` | integer | Yes | ID of the person the custom fields belong to |
| `custom_field` | object | Yes | The custom field object containing the field details |

#### Output

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

### Create People Positions

**Slug:** `CENTRALSTATIONCRM_CREATE_PEOPLE_POSITIONS`

Tool to create a new position for a specific person. Use when you need to associate a person with a company role or job position.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `position` | object | Yes | Position details to create |
| `person_id` | integer | Yes | The unique identifier of the person to add the position to |

#### Output

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

### Create Person Protocol Attachment

**Slug:** `CENTRALSTATIONCRM_CREATE_PEOPLE_PROTOCOLS_ATTACHMENTS`

Tool to create an attachment for a person protocol in CentralStationCRM. Use when you need to upload a Base64-encoded file to a specific protocol within a person record.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `methods` | string | No | Additional methods to apply (space-separated): responsible_user_natural_name, attachment_category_name. Use 'all' for all methods. |
| `includes` | string | No | Related entities to include in response (space-separated): user, attachment_category, comments. Use 'all' for all includes. |
| `person_id` | integer | Yes | ID of the person the protocol belongs to |
| `attachment` | object | Yes | Attachment object with filename, content type, and Base64 data |
| `protocol_id` | integer | Yes | ID of the protocol to attach the file to |

#### Output

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

### Create People Tags

**Slug:** `CENTRALSTATIONCRM_CREATE_PEOPLE_TAGS`

Tool to create a new tag for a specific person. Use when you need to categorize or label a person after confirming their ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tag` | object | Yes | The tag object containing the tag details |
| `person_id` | integer | Yes | The unique identifier of the person to add the tag to |

#### Output

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

### Create Person Address

**Slug:** `CENTRALSTATIONCRM_CREATE_PERSON_ADDRESS`

Tool to create a new address for a specific person. Use when you need to add or update postal details after confirming person ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `zip` | string | No | The postal code |
| `city` | string | Yes | The city name (required) |
| `atype` | string ("work_hq" | "work" | "invoice" | "delivery" | "private" | "other") | Yes | Address type. Must be one of work_hq, work, invoice, delivery, private or other. |
| `street` | string | No | The street including house number or other details (building, c/o) |
| `primary` | boolean | No | Decides ordering of addresses when the person has multiple addresses |
| `person_id` | integer | Yes | The unique identifier of the person to add the address to |
| `state_code` | string | No | The state code (e.g. NW, BY) |
| `country_code` | string | No | The country code (ISO 3166-1 alpha-2, e.g. DE, AT) |

#### Output

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

### Create Person Assistant

**Slug:** `CENTRALSTATIONCRM_CREATE_PERSON_ASSI`

Tool to create a new assistant (assi) entry for a specific person. Use after confirming the person ID when you need to manage assistant contacts.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tel` | string | No | Phone number of the assistant |
| `name` | string | Yes | Name of the assistant |
| `email` | string | No | Email address of the assistant |
| `primary` | boolean | No | Whether the assistant is the primary contact |
| `person_id` | integer | Yes | ID of the person to add the assistant to |

#### Output

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

### Create Person Avatar

**Slug:** `CENTRALSTATIONCRM_CREATE_PERSON_AVATAR`

Tool to create a new avatar for a specific person. Use when you need to attach a Base64-encoded image file after confirming the person's ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `avatar` | object | Yes | Avatar object with filename, content type, and Base64 data |
| `person_id` | integer | Yes | The ID of the person to attach the avatar to |

#### Output

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

### Create Person Contact Detail

**Slug:** `CENTRALSTATIONCRM_CREATE_PERSON_CONTACT_DETAIL`

Tool to create a new contact detail for a specific person. Use when adding a phone number after confirming the person's ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | The phone number or contact value. |
| `atype` | string ("office" | "office_hq" | "mobile" | "fax" | "private" | "voip" | "skype" | "other") | Yes | Phone type. Must be one of office, office_hq, mobile, fax, private, voip, skype or other. |
| `person_id` | integer | Yes | The unique identifier of the person to add the contact detail to |

#### Output

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

### Create Person Historic Event

**Slug:** `CENTRALSTATIONCRM_CREATE_PERSON_HISTORIC_EVENT`

Tool to create a new historic event for a specific person. Use after confirming person ID to record dates like birthdays, anniversaries, or other milestones.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `desc` | string | No | For atype 'other', an additional description may be provided. Ignored otherwise. |
| `name` | string | Yes | The date of the historic event in YYYY-MM-DD format. |
| `atype` | string ("birthday" | "anniversary" | "first_met" | "renewal" | "other") | Yes | Type of the historic event. Must be one of birthday, anniversary, first_met, renewal or other. |
| `person_id` | integer | Yes | The unique identifier of the person to add the historic event to |

#### Output

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

### Create Project

**Slug:** `CENTRALSTATIONCRM_CREATE_PROJECT`

Tool to create a new project record. Use when you need to add a project to your CRM with optional nested attributes like custom fields and tags.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Name of the project |
| `no_log` | boolean | No | Set to true if you don't want to generate an activity for the stream |
| `deal_id` | integer | No | ID of the deal associated with this project |
| `methods` | string | No | Possible methods are: responsible_user_natural_name, people_ids, absolute_url, stream_updated_at separated by space. Use 'all' to receive all methods. |
| `user_id` | integer | No | ID of the user responsible for this project |
| `group_id` | integer | No | ID of the group to which the project belongs |
| `includes` | string | No | Possible includes are: tags, people, company, task_lists, tasks, pending_tasks, cal_events, upcoming_cal_events, custom_fields separated by space. Use 'all' to receive all includes. |
| `background` | string | No | Additional background information about the project |
| `company_id` | integer | No | ID of the company associated with this project |
| `finished_at` | string | No | Date when the project was finished in YYYY-MM-DD format |
| `target_date` | string | Yes | Target completion date in YYYY-MM-DD format |
| `current_state` | string | No | Current state of the project |
| `person_ids_set` | string | No | Comma-separated person IDs to associate with the project (e.g., '42,4711') |
| `tags_attributes` | array | No | List of tag attributes to add to the project |
| `custom_fields_attributes` | array | No | List of custom field attributes to add to the project |

#### Output

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

### Create Project Protocol Attachment

**Slug:** `CENTRALSTATIONCRM_CREATE_PROJECTS_PROTOCOLS_ATTACHMENTS`

Tool to create an attachment for a project protocol in CentralStationCRM. Use when you need to upload a Base64-encoded file to a specific protocol within a project.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `methods` | string | No | Additional methods to apply (space-separated): responsible_user_natural_name, attachment_category_name. Use 'all' for all methods. |
| `includes` | string | No | Related entities to include in response (space-separated): user, attachment_category, comments. Use 'all' for all includes. |
| `attachment` | object | Yes | Attachment object with filename, content type, and Base64 data |
| `project_id` | integer | Yes | ID of the project the protocol belongs to |
| `protocol_id` | integer | Yes | ID of the protocol to attach the file to |

#### Output

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

### Create Protocol

**Slug:** `CENTRALSTATIONCRM_CREATE_PROTOCOL`

Tool to create a new protocol entry. Use when you need to log an activity, note, or communication related to people, companies, deals, or projects.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `methods` | string | No | Possible methods are: responsible_user_natural_name, absolute_url, conversion_step_names separated by space. Receive all methods using the 'all' value |
| `includes` | string | No | Possible option: comments |
| `protocol` | object | Yes | Protocol data to be created |
| `attachment` | object | No | Schema for optional attachment data when creating a protocol. |
| `only_object_logging` | boolean | No | Set to true if you want the new protocol only to show up on the object pages, not on the status stream |

#### Output

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

### Create Protocol Attachment

**Slug:** `CENTRALSTATIONCRM_CREATE_PROTOCOLS_ATTACHMENTS`

Tool to create an attachment for a protocol in CentralStationCRM. Use when you need to upload a Base64-encoded file to a specific protocol.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `methods` | string | No | Additional methods to apply (space-separated): responsible_user_natural_name, attachment_category_name. Use 'all' for all methods. |
| `includes` | string | No | Related entities to include in response (space-separated): user, attachment_category, comments. Use 'all' for all includes. |
| `attachment` | object | Yes | Attachment object with filename, content type, and Base64 data |
| `protocol_id` | integer | Yes | ID of the protocol to attach the file to |

#### Output

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

### Create Tag

**Slug:** `CENTRALSTATIONCRM_CREATE_TAGS`

Tool to create a new tag for a person, company, or deal. Use when you need to categorize or label CRM records.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Name of the tag to create (max 60 characters) |
| `api_input` | boolean | No | States whether or not the tag has been added via the API or some sort of integration |
| `attachable_id` | integer | Yes | ID of the record the tag belongs to (e.g., a person, company, or deal) |
| `attachable_type` | string | Yes | Type of record to attach the tag to. Must be one of: Person, Company, Deal |

#### Output

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

### Create Task

**Slug:** `CENTRALSTATIONCRM_CREATE_TASKS`

Tool to create a new task record. Use when you need to add a task to a user's workflow or attach it to an existing person, company, or deal.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `task` | object | Yes | Task data object containing all task properties |
| `methods` | string | No | Optional method to include: 'responsible_user_natural_name' |
| `includes` | string | No | Optional includes for the response: 'user', 'comments' separated by space, or 'all' for all includes |

#### Output

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

### Delete Attachments

**Slug:** `CENTRALSTATIONCRM_DELETE_ATTACHMENTS`

Tool to delete an attachment by ID. Use when you need to permanently remove an attachment after verifying the correct attachment ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Unique identifier of the attachment to delete. Must be a string (UUID format). |

#### Output

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

### Delete Avatar

**Slug:** `CENTRALSTATIONCRM_DELETE_AVATARS`

Tool to delete an avatar by its ID. Use when you need to remove an avatar from the system after confirming the avatar ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Unique identifier of the avatar to delete. Must be a string (e.g., UUID). |

#### Output

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

### Delete Calendar Event

**Slug:** `CENTRALSTATIONCRM_DELETE_CAL_EVENT`

Tool to delete a calendar event by ID. Use when you need to permanently remove a calendar event after verifying the correct ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Unique identifier of the calendar event to delete. UUID format. |
| `no_log` | boolean | No | Set to true if you don't want to generate an activity for the stream. |

#### Output

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

### Delete Calendar Event Attendee

**Slug:** `CENTRALSTATIONCRM_DELETE_CAL_EVENT_ATTENDEE`

Tool to delete a calendar event attendee by ID. Use when you need to remove an attendee from a calendar event.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Unique identifier of the calendar event attendee to delete. Must be a valid UUID string. |
| `cal_event_id` | string | Yes | Unique identifier of the calendar event. Must be a valid UUID string. |

#### Output

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

### Delete Comment

**Slug:** `CENTRALSTATIONCRM_DELETE_COMMENT`

Tool to delete a comment by its ID. Use when you need to permanently remove a comment after verifying the correct ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | Yes | Unique identifier of the comment to delete. Must be a positive integer. |

#### Output

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

### Delete Company Avatar

**Slug:** `CENTRALSTATIONCRM_DELETE_COMPANIES_AVATARS`

Tool to delete a company's avatar by its ID. Use when you need to remove an outdated or incorrect avatar after confirming the company_id and avatar ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Unique identifier of the avatar to delete (typically a UUID). |
| `company_id` | string | Yes | Unique identifier of the company to which the avatar belongs. |

#### Output

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

### Delete Company Contact Detail

**Slug:** `CENTRALSTATIONCRM_DELETE_COMPANIES_CONTACT_DETAIL`

Tool to delete a contact detail of a company. Use when you need to remove an outdated or incorrect contact detail after confirming the company_id and contact_detail_id.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | Yes | Unique identifier of the contact detail to delete. Must be a positive integer. |
| `company_id` | integer | Yes | Unique identifier of the company to which the contact detail belongs. Must be a positive integer. |

#### Output

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

### Delete Company Protocol Attachment

**Slug:** `CENTRALSTATIONCRM_DELETE_COMPANIES_PROTOCOLS_ATTACHMENTS`

Tool to delete a specific attachment from a company protocol. Use when you need to permanently remove an attachment from a protocol after verifying the correct company ID, protocol ID, and attachment ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Unique identifier of the attachment to delete (UUID format). |
| `company_id` | integer | Yes | ID of the company the protocol belongs to. |
| `protocol_id` | integer | Yes | ID of the protocol the attachment belongs to. |

#### Output

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

### Delete Company

**Slug:** `CENTRALSTATIONCRM_DELETE_COMPANY`

Tool to delete a company record by ID. Use when you need to permanently remove an organization after verifying the correct ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | Yes | Unique identifier of the company to delete. Must be a positive integer. |

#### Output

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

### Delete Company Address

**Slug:** `CENTRALSTATIONCRM_DELETE_COMPANY_ADDRESS`

Tool to delete a company's address by its ID. Use when you need to remove an outdated or incorrect address after confirming the company_id and address_id.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | Yes | Unique identifier of the address to delete. Must be a positive integer. |
| `company_id` | integer | Yes | Unique identifier of the company to which the address belongs. Must be a positive integer. |

#### Output

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

### Delete Custom Field Type

**Slug:** `CENTRALSTATIONCRM_DELETE_CUSTOM_FIELDS_TYPES`

Tool to delete a custom field type by ID. Use when you need to permanently remove a custom field definition after verifying the correct ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Unique identifier of the custom field type to delete. |

#### Output

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

### Delete Deal

**Slug:** `CENTRALSTATIONCRM_DELETE_DEALS`

Tool to delete a deal record by ID. Use when you need to permanently remove a deal after verifying the correct ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | Yes | Unique identifier of the deal to delete. Must be a positive integer. |
| `no_log` | boolean | No | Set to true if you don't want to generate an activity for the stream. |

#### Output

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

### Delete Deal Protocol Attachment

**Slug:** `CENTRALSTATIONCRM_DELETE_DEALS_PROTOCOLS_ATTACHMENTS`

Tool to delete a specific attachment from a deal protocol. Use when you need to permanently remove an attachment from a protocol after verifying the correct deal ID, protocol ID, and attachment ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Unique identifier of the attachment to delete (UUID format). |
| `deal_id` | integer | Yes | ID of the deal the protocol belongs to. |
| `protocol_id` | integer | Yes | ID of the protocol the attachment belongs to. |

#### Output

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

### Delete Group Calendar

**Slug:** `CENTRALSTATIONCRM_DELETE_GROUP_CALENDAR`

Tool to delete a group calendar by ID. Use when you need to permanently remove a group calendar after verifying the correct ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Unique identifier of the group calendar to delete. UUID format. |

#### Output

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

### Delete Hook

**Slug:** `CENTRALSTATIONCRM_DELETE_HOOKS`

Tool to delete a webhook by ID. Use when you need to destroy a hook after verifying the correct ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | Yes | Unique identifier of the hook to delete. Must be a positive integer. |

#### Output

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

### Delete People Custom Fields

**Slug:** `CENTRALSTATIONCRM_DELETE_PEOPLE_CUSTOM_FIELDS`

Tool to delete a person's custom field by its ID. Use when you need to remove a custom field after confirming the person_id and custom field id.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | Yes | Unique identifier of the custom field to delete. Must be a positive integer. |
| `person_id` | integer | Yes | Unique identifier of the person to which the custom field belongs. Must be a positive integer. |

#### Output

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

### Delete People Positions

**Slug:** `CENTRALSTATIONCRM_DELETE_PEOPLE_POSITIONS`

Tool to delete a position of a person by its ID. Use when you need to remove a job position or company affiliation after confirming the person_id and position_id.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `person_id` | integer | Yes | Unique identifier of the person to which the position belongs. Must be a positive integer. |
| `position_id` | integer | Yes | Unique identifier of the position to delete. Must be a positive integer. |

#### Output

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

### Delete Person Protocol Attachment

**Slug:** `CENTRALSTATIONCRM_DELETE_PEOPLE_PROTOCOLS_ATTACHMENTS`

Tool to delete a specific attachment from a person protocol. Use when you need to permanently remove an attachment from a protocol after verifying the correct person ID, protocol ID, and attachment ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Unique identifier of the attachment to delete (UUID format). |
| `person_id` | integer | Yes | ID of the person the protocol belongs to. |
| `protocol_id` | integer | Yes | ID of the protocol the attachment belongs to. |

#### Output

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

### Delete person

**Slug:** `CENTRALSTATIONCRM_DELETE_PERSON`

Tool to delete a person record by ID. Use when you need to permanently remove a contact after verifying the correct ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | Yes | Unique identifier of the person to delete. Must be a positive integer. |

#### Output

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

### Delete Person Address

**Slug:** `CENTRALSTATIONCRM_DELETE_PERSON_ADDRESS`

Tool to delete a person's address by its ID. Use when you need to remove an outdated or incorrect address after confirming the person_id and address_id.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `person_id` | integer | Yes | Unique identifier of the person to which the address belongs. Must be a positive integer. |
| `address_id` | integer | Yes | Unique identifier of the address to delete. Must be a positive integer. |

#### Output

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

### Delete Person Assi

**Slug:** `CENTRALSTATIONCRM_DELETE_PERSON_ASSI`

Tool to delete an assi entry of a person. Use when you need to remove an assistant record after confirming person_id and assi_id.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `assi_id` | integer | Yes | Unique identifier of the assi entry to delete. Must be a positive integer. |
| `person_id` | integer | Yes | Unique identifier of the person whose assi entry will be deleted. Must be a positive integer. |

#### Output

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

### Delete Person Avatar

**Slug:** `CENTRALSTATIONCRM_DELETE_PERSON_AVATAR`

Tool to delete a person's avatar by its ID. Use when you need to remove an outdated or incorrect avatar after confirming the person_id and avatar_id.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `avatar_id` | string | Yes | Unique identifier of the avatar to delete. Must be a string (e.g., UUID). |
| `person_id` | integer | Yes | Unique identifier of the person to which the avatar belongs. Must be a positive integer. |

#### Output

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

### Delete Person Contact Detail

**Slug:** `CENTRALSTATIONCRM_DELETE_PERSON_CONTACT_DETAIL`

Tool to delete a contact detail of a person. Use when you need to remove an outdated or incorrect contact detail after confirming the person_id and contact_detail_id.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `person_id` | integer | Yes | Unique identifier of the person to which the contact detail belongs. Must be a positive integer. |
| `contact_detail_id` | integer | Yes | Unique identifier of the contact detail to delete. Must be a positive integer. |

#### Output

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

### Delete Person Historic Event

**Slug:** `CENTRALSTATIONCRM_DELETE_PERSON_HISTORIC_EVENT`

Tool to delete a historic event of a person by its ID. Use when you need to remove outdated or incorrect milestone entries after confirming the person_id and historic_event_id.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `person_id` | integer | Yes | Unique identifier of the person to which the historic event belongs. Must be a positive integer. |
| `historic_event_id` | integer | Yes | Unique identifier of the historic event to delete. Must be a positive integer. |

#### Output

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

### Delete Person Tag

**Slug:** `CENTRALSTATIONCRM_DELETE_PERSON_TAG`

Tool to destroy a tag from a person by its ID. Use when you need to remove a tag association from a person's record after confirming the person_id and tag_id.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tag_id` | string | Yes | Unique identifier of the tag to delete from the person. |
| `person_id` | integer | Yes | Unique identifier of the person from which the tag will be removed. Must be a positive integer. |

#### Output

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

### Delete Project

**Slug:** `CENTRALSTATIONCRM_DELETE_PROJECTS`

Tool to delete a project record by ID. Use when you need to permanently remove a project after verifying the correct ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | Yes | Unique identifier of the project to delete. Must be a positive integer. |
| `no_log` | boolean | No | Set to true if you don't want to generate an activity for the stream. |

#### Output

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

### Delete Project Protocol Attachment

**Slug:** `CENTRALSTATIONCRM_DELETE_PROJECTS_PROTOCOLS_ATTACHMENTS`

Tool to delete a specific attachment from a project protocol. Use when you need to permanently remove an attachment from a protocol after verifying the correct project ID, protocol ID, and attachment ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Unique identifier of the attachment to delete (UUID format). |
| `project_id` | integer | Yes | ID of the project the protocol belongs to. |
| `protocol_id` | integer | Yes | ID of the protocol the attachment belongs to. |

#### Output

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

### Delete Protocol

**Slug:** `CENTRALSTATIONCRM_DELETE_PROTOCOL`

Tool to delete a protocol by ID. Use when you need to permanently remove a protocol record after verifying the correct ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | Yes | Unique identifier of the protocol to delete. Must be a positive integer. |

#### Output

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

### Delete Protocol Attachment

**Slug:** `CENTRALSTATIONCRM_DELETE_PROTOCOLS_ATTACHMENTS`

Tool to delete an attachment from a protocol. Use when you need to permanently remove an attachment from a protocol after verifying the correct protocol ID and attachment ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Unique identifier of the attachment to delete (UUID format). |
| `protocol_id` | integer | Yes | ID of the protocol the attachment belongs to. |

#### Output

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

### Delete Task

**Slug:** `CENTRALSTATIONCRM_DELETE_TASKS`

Tool to delete a task by its ID. Use when you need to permanently remove a task after verifying the correct ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | Yes | Unique identifier of the task to delete. Must be a positive integer. |

#### Output

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

### Get Activity

**Slug:** `CENTRALSTATIONCRM_GET_ACTIVITY`

Tool to retrieve details of a specific activity by its ID. Use when you have an activity ID and need its details.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Unique identifier of the activity to retrieve |
| `filter` | object | No | Optional filter object to filter by activity attributes. Supported modifiers: 'smaller_than', 'larger_than', 'equal', 'between', 'in'. |
| `methods` | string | No | Comma-separated list of computed methods to include. Possible values: 'attachable', 'responsible_user_natural_name'. Use 'all' to include all methods. |
| `includes` | string | No | Comma-separated list of related objects to include. Possible values: 'user', 'activity_receivers'. Use 'all' to include everything. |

#### Output

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

### Get API User Maildrop

**Slug:** `CENTRALSTATIONCRM_GET_API_USER_MAILDROP`

Tool to retrieve the current API user's maildrop for people and companies. Use after authenticating the API user.

#### Output

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

### Get Attachment

**Slug:** `CENTRALSTATIONCRM_GET_ATTACHMENT`

Tool to retrieve details of a specific attachment by its ID. Use when you have an attachment ID and need to fetch the attachment metadata or file data.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The unique ID of the attachment to retrieve (UUID format). |
| `methods` | string | No | Optional space-separated list of computed methods to include in the response. Valid values: 'responsible_user_natural_name' (returns the full name of the responsible user), 'attachment_category_name' (returns the category name as a string). Use 'all' to include all methods. Example: 'responsible_user_natural_name attachment_category_name' |
| `includes` | string | No | Optional space-separated list of related objects to include in the response. Valid values: 'user' (uploader user), 'attachment_category' (category info), 'comments' (associated comments). Use 'all' to include everything. Example: 'user attachment_category comments' |

#### Output

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

### Get Avatar

**Slug:** `CENTRALSTATIONCRM_GET_AVATARS`

Tool to retrieve a specific avatar by its ID from CentralStationCRM. Use when you know the avatar ID and need to fetch its details including Base64-encoded image data.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Unique identifier (UUID) of the avatar to retrieve |

#### Output

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

### Get Calendar Event

**Slug:** `CENTRALSTATIONCRM_GET_CAL_EVENT`

Tool to retrieve details of a specific calendar event by ID. Use when you have a calendar event ID and need its full details.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Unique identifier of the calendar event to retrieve (UUID format) |
| `includes` | string | No | Space-separated list of related objects to include in the response. Valid values: 'user', 'group_calendar', 'people', 'users', 'cal_event_attendees', 'comments'. Use 'all' to receive all includes. Example: 'user group_calendar people' |

#### Output

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

### Get Calendar Event Attendee

**Slug:** `CENTRALSTATIONCRM_GET_CAL_EVENT_ATTENDEE`

Tool to retrieve details of a specific calendar event attendee by ID. Use when you have both a calendar event ID and attendee ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Unique identifier of the calendar event attendee |
| `includes` | string | No | Space-separated list of related objects to include in the response. Possible values: 'user', 'person', 'cal_event'. Use 'all' to receive all includes. |
| `cal_event_id` | string | Yes | Unique identifier of the calendar event |

#### Output

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

### Get Comment

**Slug:** `CENTRALSTATIONCRM_GET_COMMENT`

Tool to retrieve details of a specific comment by its ID. Use when you need to fetch a comment's content and metadata.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Unique identifier of the comment to retrieve |
| `methods` | string | No | Optional computed methods to include in the response. Example: 'responsible_user_natural_name' returns the full name of the responsible user. These add extra fields to the response. |

#### Output

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

### Get Company Avatar

**Slug:** `CENTRALSTATIONCRM_GET_COMPANIES_AVATARS`

Tool to retrieve a specific avatar of a company by avatar ID. Use when you need to fetch the Base64-encoded image for a known company avatar.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Unique identifier (UUID) of the avatar to retrieve |
| `company_id` | string | Yes | Unique identifier of the company whose avatar is to be retrieved |

#### Output

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

### Get Company Protocol Attachment

**Slug:** `CENTRALSTATIONCRM_GET_COMPANIES_PROTOCOLS_ATTACHMENT`

Tool to retrieve a specific attachment from a company protocol by its ID. Use when you need to fetch attachment metadata or file data for a protocol attachment.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The unique ID of the attachment to retrieve (UUID format). |
| `methods` | string | No | Optional space-separated list of computed methods to include in the response. Valid values: 'responsible_user_natural_name' (returns the full name of the responsible user), 'attachment_category_name' (returns the category name as a string). Use 'all' to include all methods. |
| `includes` | string | No | Optional space-separated list of related objects to include in the response. Valid values: 'user' (uploader user), 'attachment_category' (category info), 'comments' (associated comments). Use 'all' to include everything. |
| `company_id` | integer | Yes | ID of the company that owns the protocol. |
| `protocol_id` | integer | Yes | ID of the protocol that contains the attachment. |

#### Output

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

### Get Company

**Slug:** `CENTRALSTATIONCRM_GET_COMPANY`

Tool to retrieve details of a specific company by ID from CentralStationCRM. Use after confirming the company ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `company_id` | integer | Yes | Unique identifier of the company to retrieve |

#### Output

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

### Get Company Address

**Slug:** `CENTRALSTATIONCRM_GET_COMPANY_ADDRESS`

Tool to retrieve a specific address of a company by address ID. Use after confirming company and address IDs. Example: "Fetch address #40909645 for company #1809535128."

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | Yes | ID of the address to retrieve |
| `company_id` | integer | Yes | ID of the company the address belongs to |

#### Output

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

### Get Company Contact Detail

**Slug:** `CENTRALSTATIONCRM_GET_COMPANY_CONTACT_DETAIL`

Tool to retrieve a specific contact detail by ID for a company. Use after confirming company and contact detail IDs. Example: "Fetch contact detail #104232123 for company #1809508479."

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | Yes | ID of the contact detail |
| `company_id` | integer | Yes | ID of the company the contact details belong to |

#### Output

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

### Get Custom Fields Type

**Slug:** `CENTRALSTATIONCRM_GET_CUSTOM_FIELDS_TYPE`

Tool to retrieve a custom field type by its ID. Use when you need details about a specific custom field configuration.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Unique identifier of the custom field type to retrieve |

#### Output

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

### Get Deal

**Slug:** `CENTRALSTATIONCRM_GET_DEAL`

Tool to retrieve details of a specific deal by its ID. Use when you have a confirmed deal ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `deal_id` | integer | Yes | Unique identifier of the deal to retrieve |

#### Output

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

### Get Deal Maildrop

**Slug:** `CENTRALSTATIONCRM_GET_DEALS_MAILDROP`

Tool to retrieve the maildrop email address for a specific deal. Use when you need to get the unique email address for sending emails to a deal.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `deal_id` | integer | Yes | ID of the deal the maildrop belongs to. Must be a positive integer. |

#### Output

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

### Get Deal Protocol Attachment

**Slug:** `CENTRALSTATIONCRM_GET_DEALS_PROTOCOLS_ATTACHMENTS`

Tool to retrieve a specific attachment from a deal protocol. Use when you need to fetch attachment details or file data associated with a protocol within a specific deal.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Unique identifier of the attachment to retrieve (UUID format) |
| `deal_id` | integer | Yes | Unique identifier of the deal |
| `methods` | string | No | Optional space-separated list of computed methods to include in the response. Valid values: 'responsible_user_natural_name' (returns the full name of the responsible user), 'attachment_category_name' (returns the category name as a string). Use 'all' to include all methods. Example: 'responsible_user_natural_name attachment_category_name' |
| `includes` | string | No | Optional space-separated list of related objects to include in the response. Valid values: 'user' (uploader user), 'attachment_category' (category info), 'comments' (associated comments). Use 'all' to include everything. Example: 'user attachment_category comments' |
| `protocol_id` | integer | Yes | Unique identifier of the protocol within the deal |

#### Output

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

### Get Group Calendar

**Slug:** `CENTRALSTATIONCRM_GET_GROUP_CALENDAR`

Tool to retrieve details of a specific group calendar by ID. Use when you have a group calendar ID and need its details.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Unique identifier of the group calendar to retrieve (UUID format) |
| `includes` | string | No | Optional related objects to include in the response. Valid value: 'cal_events' to include calendar events associated with this group calendar. |

#### Output

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

### Get Hook

**Slug:** `CENTRALSTATIONCRM_GET_HOOK`

Tool to retrieve details of a specific webhook/hook by ID. Use when you need to inspect hook configuration or verify hook setup.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The unique ID of the hook to retrieve. Can be a string or numeric identifier. |
| `includes` | string | No | Optional comma-separated list of related objects to include in the response. Valid value: 'filter_groups'. When included, the response will contain associated filter group data. |

#### Output

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

### Get People Positions

**Slug:** `CENTRALSTATIONCRM_GET_PEOPLE_POSITIONS`

Tool to retrieve a specific position for a person by ID. Use when you need to get details of a particular job position. Example: "Get position 32171509 for person 43058116."

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | Yes | Unique identifier of the position to retrieve |
| `includes` | string | No | Comma-separated list of related objects to include. Possible includes: 'person', 'company'. Use 'all' to receive all includes |
| `person_id` | integer | Yes | Unique identifier of the person |

#### Output

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

### Get Person Protocol Attachment

**Slug:** `CENTRALSTATIONCRM_GET_PEOPLE_PROTOCOLS_ATTACHMENTS`

Tool to retrieve a specific attachment from a person protocol. Use when you need to fetch attachment details or file data associated with a protocol within a specific person.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Unique identifier of the attachment to retrieve (UUID format) |
| `methods` | string | No | Optional space-separated list of computed methods to include in the response. Valid values: 'responsible_user_natural_name' (returns the full name of the responsible user), 'attachment_category_name' (returns the category name as a string). Use 'all' to include all methods. Example: 'responsible_user_natural_name attachment_category_name' |
| `includes` | string | No | Optional space-separated list of related objects to include in the response. Valid values: 'user' (uploader user), 'attachment_category' (category info), 'comments' (associated comments). Use 'all' to include everything. Example: 'user attachment_category comments' |
| `person_id` | integer | Yes | Unique identifier of the person |
| `protocol_id` | integer | Yes | Unique identifier of the protocol within the person |

#### Output

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

### Get People Tags

**Slug:** `CENTRALSTATIONCRM_GET_PEOPLE_TAGS`

Tool to retrieve a specific tag for a person by tag ID. Use when you need details about a particular tag associated with a person.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | Yes | ID of the tag to retrieve |
| `person_id` | integer | Yes | ID of the person the tag belongs to |

#### Output

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

### Get Person

**Slug:** `CENTRALSTATIONCRM_GET_PERSON`

Tool to retrieve details of a specific person by ID. Use when you have a person_id and need their full details.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `methods` | array | No | Optional list of computed methods to include in the response. Example: 'responsible_user_natural_name' returns the full name of the responsible user. Available methods are documented in the CentralStationCRM Swagger API documentation. These add extra fields to the response. |
| `includes` | array | No | Optional list of related objects to include in the response. Valid values: 'companies' (associated companies), 'tags' (associated tags). If included, the corresponding fields will be populated in the response. |
| `person_id` | integer | Yes | The unique ID of the person to retrieve. Must be a positive integer. |

#### Output

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

### Get Person Address

**Slug:** `CENTRALSTATIONCRM_GET_PERSON_ADDRESS`

Tool to retrieve a specific address of a person by address ID. Use after confirming person and address IDs. Example: "Fetch address for person #42, address #101."

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `methods` | string | No | Optional comma-separated list of methods to include additional information. Example: 'country_name' |
| `person_id` | integer | Yes | Unique identifier of the person whose address is to be retrieved |
| `address_id` | integer | Yes | Unique identifier of the address to retrieve |

#### Output

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

### Get Person Addresses

**Slug:** `CENTRALSTATIONCRM_GET_PERSON_ADDRESSES`

Tool to retrieve all addresses for a specific person. Use when you need to list a person’s addresses after confirming their ID. Example: "Get addresses for person with ID 42."

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number to retrieve |
| `methods` | string | No | Comma-separated list of methods to include additional information |
| `perpage` | integer | No | Number of entries per page (default is 50, max is 250) |
| `includes` | string | No | Comma-separated list of related objects to include in the response |
| `person_id` | integer | Yes | Unique identifier of the person whose addresses are to be retrieved |

#### Output

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

### Get Person Assi

**Slug:** `CENTRALSTATIONCRM_GET_PERSON_ASSI`

Tool to retrieve a specific assistant (assi) entry for a person by their IDs. Returns detailed assistant information including contact details (name, email, phone) and whether they are the primary contact. Use this when you need full details about a specific assistant after obtaining both the person_id and assi_id.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `assi_id` | integer | Yes | Unique identifier of the specific assistant entry to retrieve |
| `person_id` | integer | Yes | Unique identifier of the person whose assistant entry you want to retrieve |

#### Output

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

### Get Person Avatar

**Slug:** `CENTRALSTATIONCRM_GET_PERSON_AVATAR`

Tool to retrieve a specific avatar of a person by avatar ID. Use after you know both person_id and avatar_id to fetch the Base64-encoded image.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `avatar_id` | string | Yes | Unique identifier (UUID) of the avatar to retrieve |
| `person_id` | integer | Yes | Unique identifier of the person whose avatar is to be retrieved |

#### Output

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

### Get Person Contact Detail

**Slug:** `CENTRALSTATIONCRM_GET_PERSON_CONTACT_DETAIL`

Tool to retrieve a specific contact detail by ID for a person. Use after confirming person and contact detail IDs. Example: "Fetch contact detail #108 for person #42."

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `methods` | string | No | Optional comma-separated list of methods to include additional info, e.g., 'responsible_user_natural_name' |
| `person_id` | integer | Yes | Unique identifier of the person whose contact detail is to be retrieved |
| `contact_detail_id` | integer | Yes | Unique identifier of the contact detail to retrieve |

#### Output

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

### Get Person Custom Field

**Slug:** `CENTRALSTATIONCRM_GET_PERSON_CUSTOM_FIELD`

Tool to retrieve a specific custom field for a person by custom field ID. Use when you need details about a particular custom field associated with a person.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | Yes | ID of the custom field to retrieve |
| `includes` | string | No | Optional related data to include. Possible value: 'custom_fields_type' to include the custom field type definition |
| `person_id` | integer | Yes | ID of the person the custom field belongs to |

#### Output

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

### Get Person Historic Event

**Slug:** `CENTRALSTATIONCRM_GET_PERSON_HISTORIC_EVENT`

Tool to retrieve a specific historic event of a person by ID. Use after confirming both person and event IDs. Example: "Fetch historic event 101 for person 42."

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `methods` | string | No | Optional comma-separated list of methods to include additional information. |
| `event_id` | integer | Yes | Unique identifier of the historic event to retrieve. |
| `includes` | string | No | Optional comma-separated list of related resources to include. |
| `person_id` | integer | Yes | Unique identifier of the person. |

#### Output

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

### Get Project

**Slug:** `CENTRALSTATIONCRM_GET_PROJECT`

Tool to retrieve details of a specific project by ID from CentralStationCRM. Use after confirming the project ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | Yes | Unique identifier of the project to retrieve |
| `methods` | string | No | Space-separated list of additional methods to execute. Possible values: responsible_user_natural_name, people_ids, absolute_url, stream_updated_at. Use 'all' to receive all methods. |
| `includes` | string | No | Space-separated list of related data to include. Possible values: tags, people, company, task_lists, tasks, pending_tasks, cal_events, upcoming_cal_events, custom_fields. Use 'all' to receive all includes. |

#### Output

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

### Get Project Maildrop

**Slug:** `CENTRALSTATIONCRM_GET_PROJECTS_MAILDROP`

Tool to retrieve the maildrop email address for a specific project. Use when you need to get the unique email address for sending emails to a project.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `project_id` | integer | Yes | ID of the project the maildrop belongs to. Must be a positive integer. |

#### Output

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

### Get Project Protocol Attachment

**Slug:** `CENTRALSTATIONCRM_GET_PROJECTS_PROTOCOLS_ATTACHMENT`

Tool to retrieve a specific attachment from a project protocol by its ID. Use when you have a project ID, protocol ID, and attachment ID and need to fetch the attachment metadata or file data.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Unique identifier of the attachment to retrieve (UUID format). |
| `methods` | string | No | Optional space-separated list of computed methods to include in the response. Valid values: 'responsible_user_natural_name' (returns the full name of the responsible user), 'attachment_category_name' (returns the category name as a string). Use 'all' to include all methods. |
| `includes` | string | No | Optional space-separated list of related objects to include in the response. Valid values: 'user' (uploader user), 'attachment_category' (category info), 'comments' (associated comments). Use 'all' to include everything. |
| `project_id` | integer | Yes | ID of the project the protocol belongs to. |
| `protocol_id` | integer | Yes | ID of the protocol the attachment belongs to. |

#### Output

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

### Get Protocol Attachment

**Slug:** `CENTRALSTATIONCRM_GET_PROTOCOLS_ATTACHMENTS`

Tool to retrieve a specific attachment from a protocol by its ID. Use when you need to fetch attachment metadata or file data for a protocol attachment.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The unique ID of the attachment to retrieve (UUID format). |
| `methods` | string | No | Optional space-separated list of computed methods to include in the response. Valid values: 'responsible_user_natural_name' (returns the full name of the responsible user), 'attachment_category_name' (returns the category name as a string). Use 'all' to include all methods. |
| `includes` | string | No | Optional space-separated list of related objects to include in the response. Valid values: 'user' (uploader user), 'attachment_category' (category info), 'comments' (associated comments). Use 'all' to include everything. |
| `protocol_id` | integer | Yes | ID of the protocol that contains the attachment. |

#### Output

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

### Get Stats Companies

**Slug:** `CENTRALSTATIONCRM_GET_STATS_COMPANIES`

Retrieve statistics about companies in your CRM. Returns the total count of companies matching the specified criteria. Use this when you need a quick count without fetching full company records. Supports filtering by tags and various field criteria (user_id, created_by_user_id, account_id, group_id, etc.) using operators like 'equal', 'larger_than', 'smaller_than', 'between', and 'in'.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `filter` | object | No | Optionally submit one of the companies attributes in order to filter by them. Allowed filter modifiers are 'smaller_than', 'larger_than', 'equal', 'between' or 'in'. Whereas smaller_than, larger_than and equal expect one value, between expects exactly two values comma separated (e.g. {'between': '2023-01-01,2023-02-01'}) and 'in' allows a list of comma separated options (e.g. {'in': '23,42,99'}). Common filterable fields include: user_id, created_by_user_id, updated_by_user_id, group_id, account_id. Example: {'user_id': {'equal': 42}} or {'created_by_user_id': {'larger_than': 100}}. |
| `tag_id` | integer | No | Optionally submit a tag ID in order to only see companies tagged with the submitted tag. |
| `tag_name` | string | No | Optionally submit a tag name in order to only see companies tagged with the submitted tag. |

#### Output

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

### Get Stats Deals

**Slug:** `CENTRALSTATIONCRM_GET_STATS_DEALS`

Retrieve statistics about deals in your CRM. Returns the total count, currency, and sum of deals matching the specified criteria. Use this when you need aggregated deal metrics without fetching full deal records. Supports filtering by tags and various field criteria (user_id, created_by_user_id, account_id, group_id, etc.) using operators like 'equal', 'larger_than', 'smaller_than', 'between', and 'in'.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `filter` | object | No | Optionally submit one of the deals attributes in order to filter by them. Allowed filter modifiers are 'smaller_than', 'larger_than', 'equal', 'between' or 'in'. Whereas smaller_than, larger_than and equal expect one value, between expects exactly two values comma separated (e.g. {'between': '2023-01-01,2023-02-01'}) and 'in' allows a list of comma separated options (e.g. {'in': '23,42,99'}). Common filterable fields include: user_id, created_by_user_id, updated_by_user_id, group_id, account_id. Example: {'user_id': {'equal': 42}} or {'created_by_user_id': {'larger_than': 100}}. |
| `tag_id` | integer | No | Optionally submit a tag ID in order to only see deals tagged with the submitted tag. |
| `tag_name` | string | No | Optionally submit a tag name in order to only see deals tagged with the submitted tag. |

#### Output

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

### Get Stats Projects

**Slug:** `CENTRALSTATIONCRM_GET_STATS_PROJECTS`

Retrieve statistics about projects in your CRM. Returns the total count and size of projects matching the specified criteria. Use this when you need aggregated project metrics without fetching full project records. Supports filtering by tags and various field criteria (user_id, created_by_user_id, account_id, group_id, etc.) using operators like 'equal', 'larger_than', 'smaller_than', 'between', and 'in'.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `filter` | object | No | Optionally submit one of the projects attributes in order to filter by them. Allowed filter modifiers are 'smaller_than', 'larger_than', 'equal', 'between' or 'in'. Whereas smaller_than, larger_than and equal expect one value, between expects exactly two values comma separated (e.g. {'between': '2023-01-01,2023-02-01'}) and 'in' allows a list of comma separated options (e.g. {'in': '23,42,99'}). Common filterable fields include: user_id, created_by_user_id, updated_by_user_id, group_id, account_id. Example: {'user_id': {'equal': 42}} or {'created_by_user_id': {'larger_than': 100}}. |
| `tag_id` | integer | No | Optionally submit a tag ID in order to only see projects tagged with the submitted tag. |
| `tag_name` | string | No | Optionally submit a tag name in order to only see projects tagged with the submitted tag. |

#### Output

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

### Get Task

**Slug:** `CENTRALSTATIONCRM_GET_TASK`

Tool to retrieve details of a specific task by its ID. Use when you have a task ID and need its details.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Unique identifier of the task to retrieve |
| `methods` | string | No | Comma-separated list of computed methods to include. Possible option: 'responsible_user_natural_name'. |
| `includes` | string | No | Space-separated list of related objects to include. Possible values: 'user', 'comments'. Use 'all' to include everything. |

#### Output

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

### Get User

**Slug:** `CENTRALSTATIONCRM_GET_USER`

Tool to retrieve the current API user's details. Use when you need information about the authenticated user.

#### Output

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

### Get User By ID

**Slug:** `CENTRALSTATIONCRM_GET_USER_BY_ID`

Tool to retrieve details of a specific user by ID. Use when you need to fetch information about a particular user from CentralStationCRM.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The unique ID of the user to retrieve. Must be a valid user identifier. |

#### Output

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

### List Activities

**Slug:** `CENTRALSTATIONCRM_LIST_ACTIVITIES`

Tool to retrieve activities for records in CentralStationCRM. Use when you need to list activities with optional filtering by person, company, deal, project, user, or account. Supports pagination and includes additional data like user and activity receivers.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Retrieve records of the given page. |
| `order` | string ("id-asc" | "id-desc") | No | Ordering options for activity results. |
| `filter` | object | No | Filter activities by attributes. Example: {'user_id': {'equal': 42}}. Allowed modifiers: 'smaller_than', 'larger_than', 'equal', 'between', 'in'. |
| `deal_id` | integer | No | Optional ID of the desired deal activities. |
| `methods` | string | No | Possible methods are: 'attachable', 'responsible_user_natural_name' separated by space. Use 'all' to receive all methods. |
| `perpage` | integer | No | Elements per page, maximum of 250. |
| `user_id` | integer | No | ID of the desired user activities. |
| `includes` | string | No | Possible includes are: 'user', 'activity_receivers' separated by space. Use 'all' to receive all includes. |
| `person_id` | integer | No | ID of the desired person activities. |
| `account_id` | integer | No | ID of the desired account activities. |
| `company_id` | integer | No | Optional ID of the desired company activities. |
| `project_id` | integer | No | Optional ID of the desired project activities. |

#### Output

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

### List Attachments

**Slug:** `CENTRALSTATIONCRM_LIST_ATTACHMENTS`

Tool to retrieve a paginated list of all attachments from CentralStationCRM. Use when you need to list, browse, or search through attachments in the system.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number to retrieve (>=1). |
| `order` | string ("id-asc" | "id-desc") | No | Ordering options for attachment list. |
| `methods` | string | No | Additional methods to include in the response. Possible values: 'responsible_user_natural_name', 'attachment_category_name' (space-separated). Use 'all' to receive all methods. |
| `perpage` | integer | No | Number of elements per page (maximum 250). |
| `includes` | string | No | Additional related data to include in the response. Possible values: 'user', 'attachment_category', 'comments' (space-separated). Use 'all' to receive all includes. |

#### Output

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

### List Avatars

**Slug:** `CENTRALSTATIONCRM_LIST_AVATARS`

Tool to retrieve all avatars from CentralStationCRM. Use when you need to list all avatars in the system with pagination support.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number to retrieve (>=1). |
| `order` | string ("id-asc" | "id-desc") | No | Order options for listing avatars. |
| `perpage` | integer | No | Number of avatars per page (maximum 250). |

#### Output

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

### List Calendar Events

**Slug:** `CENTRALSTATIONCRM_LIST_CAL_EVENTS`

Tool to retrieve all calendar events from the account. Use when you need to list calendar events with optional filtering by date, state, or custom attributes. Supports pagination and includes for related data.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Retrieve records of the given page. |
| `after` | string | No | Date formatted YYYY-MM-DD to return only CalEvents after this date. |
| `order` | string ("id-asc" | "id-desc") | No | Ordering options for cal events. |
| `state` | string ("upcoming" | "old") | No | State filter for cal events. |
| `before` | string | No | Date formatted YYYY-MM-DD to return only CalEvents before this date. |
| `filter` | object | No | Filter by calevents attributes. Allowed modifiers: smaller_than, larger_than, equal, between (2 comma-separated values), in (comma-separated list). |
| `perpage` | integer | No | Elements per page, maximum of 250. |
| `includes` | string | No | Space-separated includes: user, group_calendar, people, users, cal_event_attendees, comments. Use 'all' for all includes. |

#### Output

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

### List Calendar Event Attendees

**Slug:** `CENTRALSTATIONCRM_LIST_CAL_EVENTS_CAL_EVENT_ATTENDEES`

Tool to retrieve all attendees for a specific calendar event. Use when you need to get the list of people attending a calendar event.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `order` | string ("id-asc" | "id-desc") | No | Ordering of records by ID: 'id-asc' for ascending, 'id-desc' for descending |
| `includes` | string | No | Related objects to include in the response. Possible values: 'user', 'person', 'cal_event' (space-separated). Use 'all' to receive all includes. |
| `cal_event_id` | string | Yes | Unique identifier of the calendar event to retrieve attendees for |

#### Output

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

### List Comments

**Slug:** `CENTRALSTATIONCRM_LIST_COMMENTS`

Tool to retrieve all comments from the account. Use when you need to list all comments with optional pagination and ordering support.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number to retrieve (>=1) |
| `order` | string ("id-asc" | "id-desc") | No | Ordering options for comment retrieval. |
| `methods` | string | No | Additional methods to include. Possible option: 'responsible_user_natural_name' |
| `perpage` | integer | No | Number of comments per page (maximum 250) |

#### Output

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

### List Companies

**Slug:** `CENTRALSTATIONCRM_LIST_COMPANIES`

Tool to retrieve a paginated list of all companies from CentralStationCRM. Use when you need to browse or search through companies with filtering and pagination support.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Retrieve records of the given page |
| `order` | string ("abc-asc" | "abc-desc" | "new-asc" | "new-desc" | "update-asc" | "update-desc") | No | Order options for company listing. |
| `filter` | object | No | Filter by company attributes using modifiers: smaller_than, larger_than, equal, between (expects two comma-separated values), or in (expects comma-separated list). Example: {'user_id': {'equal': 42}} |
| `tag_id` | integer | No | Optionally submit a tag ID to filter companies tagged with the submitted tag |
| `methods` | string | No | Additional methods to include. Options: responsible_user_natural_name, related_tasks, stream_updated_at, absolute_url (space-separated). Use 'all' to receive all methods. |
| `perpage` | integer | No | Elements per page, maximum of 250 |
| `includes` | string | No | Additional related data to include. Options: positions, deals, projects, tags, tasks, pending_tasks, cal_events, upcoming_cal_events, tels, emails, ims, sms, homepages, addrs, connections, custom_fields (space-separated). Use 'all' to receive all includes. |
| `tag_name` | string | No | Optionally submit a tag name to filter companies tagged with the submitted tag |
| `stream_updated_at_after` | string | No | Filter companies with activities within the stream later than the submitted point in time (ISO 8601 date or timestamp) |
| `stream_updated_at_before` | string | No | Filter companies with activities within the stream earlier than the submitted point in time (ISO 8601 date or timestamp) |

#### Output

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

### List Company Addresses

**Slug:** `CENTRALSTATIONCRM_LIST_COMPANIES_ADDRS`

Tool to retrieve all addresses for a specific company. Use when you need to list a company's addresses after confirming their ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Retrieve records of the given page |
| `order` | string | No | Ordering of records using one of the following order options: `id-asc`, `id-desc` |
| `perpage` | integer | No | Elements per page, maximum of 250 |
| `company_id` | integer | Yes | ID of the company the contact details belong to |

#### Output

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

### List Company Avatars

**Slug:** `CENTRALSTATIONCRM_LIST_COMPANIES_AVATARS`

Tool to retrieve all avatars for a specific company. Use when you need to list a company's avatars after confirming their ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Retrieve records of the given page |
| `perpage` | integer | No | Elements per page, maximum of 250 |
| `company_id` | string | Yes | Unique identifier of the company whose avatars are to be retrieved |

#### Output

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

### List Company Contact Details

**Slug:** `CENTRALSTATIONCRM_LIST_COMPANIES_CONTACT_DETAILS`

Tool to retrieve all contact details for a specific company. Use when you need to list contact information after confirming the company ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Retrieve records of the given page |
| `order` | string | No | Ordering of records using one of the following order options: `id-asc`, `id-desc` |
| `perpage` | integer | No | Elements per page, maximum of 250 |
| `company_id` | integer | Yes | ID of the company the contact details belong to |

#### Output

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

### List Companies External Emails

**Slug:** `CENTRALSTATIONCRM_LIST_COMPANIES_EXTERNAL_EMAILS`

Tool to retrieve all external emails for a specific company from CentralStationCRM. Use when you need to access email communications associated with a company.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Retrieve records of the given page |
| `perpage` | integer | No | Elements per page, maximum of 250 |
| `includes` | string | No | Additional related data to include. Possible option: comments |
| `company_id` | integer | Yes | ID of the company whose external emails are to be retrieved |

#### Output

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

### List Company Protocol Attachments

**Slug:** `CENTRALSTATIONCRM_LIST_COMPANIES_PROTOCOLS_ATTACHMENTS`

Tool to retrieve all attachments for a specific protocol within a company. Use when you need to list attachments associated with a company's protocol.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number to retrieve (>=1). |
| `methods` | string | No | Additional methods to include in the response. Possible values: 'responsible_user_natural_name', 'attachment_category_name' (space-separated). Use 'all' to receive all methods. |
| `perpage` | integer | No | Number of elements per page (maximum 250). |
| `includes` | string | No | Additional related data to include in the response. Possible values: 'user', 'attachment_category', 'comments' (space-separated). Use 'all' to receive all includes. |
| `company_id` | integer | Yes | ID of the company the protocol belongs to. |
| `protocol_id` | integer | Yes | ID of the protocol to retrieve attachments from. |

#### Output

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

### List Custom Fields Types

**Slug:** `CENTRALSTATIONCRM_LIST_CUSTOM_FIELDS_TYPES`

Tool to retrieve all custom field types of the account. Use when you need to understand what custom fields are available in the CRM system.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Retrieve records of the given page |
| `order` | string ("id-asc" | "id-desc") | No | Order options for custom field types listing. |
| `perpage` | integer | No | Elements per page, maximum of 250 |

#### Output

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

### List Deals

**Slug:** `CENTRALSTATIONCRM_LIST_DEALS`

Tool to retrieve all deals with advanced filtering, sorting, and pagination options. Use when you need to list deals with specific filters (tags, date ranges, custom attributes), ordering, or include related data like people, companies, tasks, and custom fields.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number to retrieve (>=1). |
| `order` | string ("date-asc" | "date-desc" | "new-asc" | "new-desc" | "update-asc" | "update-desc" | "value-asc" | "value-desc" | "state-asc" | "state-desc" | "abc-asc" | "abc-desc") | No | Ordering options for deal listings. |
| `filter` | object | No | Filter by deal attributes using modifiers: 'smaller_than', 'larger_than', 'equal', 'between' (expects two comma-separated values), or 'in' (expects comma-separated list). Example: {'user_id': {'equal': 42}} |
| `tag_id` | integer | No | Filter deals by tag ID - only returns deals tagged with the submitted tag. |
| `methods` | string | No | Comma or space-separated list of methods: responsible_user_natural_name, people_ids, absolute_url, stream_updated_at. Use 'all' to receive all methods. |
| `perpage` | integer | No | Number of deals per page, maximum of 250. |
| `includes` | string | No | Comma or space-separated list of includes: tags, people, company, task_lists, tasks, pending_tasks, cal_events, upcoming_cal_events, custom_fields. Use 'all' to receive all includes. |
| `tag_name` | string | No | Filter deals by tag name - only returns deals tagged with the submitted tag. |
| `stream_updated_at_after` | string | No | Filter deals with activities within the stream later than the submitted date or timestamp (ISO 8601 format). |
| `stream_updated_at_before` | string | No | Filter deals with activities within the stream earlier than the submitted date or timestamp (ISO 8601 format). |

#### Output

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

### List Deals External Emails

**Slug:** `CENTRALSTATIONCRM_LIST_DEALS_EXTERNAL_EMAILS`

Tool to retrieve all external emails for a specific deal from CentralStationCRM. Use when you need to access email communications associated with a deal.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Retrieve records of the given page |
| `order` | string ("id-asc" | "id-desc") | No | Enum for ordering options for external emails. |
| `deal_id` | integer | Yes | ID of the deal whose external emails are to be retrieved |
| `perpage` | integer | No | Elements per page, maximum of 250 |
| `includes` | string | No | Additional related data to include. Possible option: comments |

#### Output

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

### List Deal Protocol Attachments

**Slug:** `CENTRALSTATIONCRM_LIST_DEALS_PROTOCOLS_ATTACHMENTS`

Tool to retrieve all attachments for a specific protocol within a deal. Use when you need to list attachments associated with a deal's protocol.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number to retrieve (>=1). |
| `order` | string ("id-asc" | "id-desc") | No | Ordering options for attachment list. |
| `deal_id` | integer | Yes | ID of the deal the protocol belongs to. |
| `methods` | string | No | Additional methods to include in the response. Possible values: 'responsible_user_natural_name', 'attachment_category_name' (space-separated). Use 'all' to receive all methods. |
| `perpage` | integer | No | Number of elements per page (maximum 250). |
| `includes` | string | No | Additional related data to include in the response. Possible values: 'user', 'attachment_category', 'comments' (space-separated). Use 'all' to receive all includes. |
| `protocol_id` | integer | Yes | ID of the protocol to retrieve attachments from. |

#### Output

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

### List External Emails

**Slug:** `CENTRALSTATIONCRM_LIST_EXTERNAL_EMAILS`

Tool to retrieve all external emails from CentralStationCRM. Use when you need to access email communications across the system with pagination and filtering support.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Retrieve records of the given page |
| `order` | string ("id-asc" | "id-desc") | No | Order options for external emails listing. |
| `perpage` | integer | No | Elements per page, maximum of 250 |
| `includes` | string | No | Additional related data to include. Possible option: comments |

#### Output

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

### List Filter Groups

**Slug:** `CENTRALSTATIONCRM_LIST_FILTER_GROUPS`

Tool to retrieve all filter groups from CentralStationCRM. Use when you need to browse or list available filter groups with pagination and filtering support.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Retrieve records of the given page |
| `order` | string ("abc-asc" | "abc-desc" | "new-asc" | "new-desc" | "update-asc" | "update-desc" | "activity-asc" | "activity-desc") | No | Order options for filter group listing. |
| `filter` | object | No | Filter by filter group attributes using modifiers: smaller_than, larger_than, equal, between (expects two comma-separated values like '2023-01-01,2023-02-01'), or in (expects comma-separated list like '23,42,99'). Example: {'user_id': {'equal': 42}} |
| `perpage` | integer | No | Elements per page, maximum of 250 |

#### Output

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

### List Group Calendars

**Slug:** `CENTRALSTATIONCRM_LIST_GROUP_CALENDARS`

Tool to retrieve all group calendars from the account. Use when you need to list group calendars with optional pagination and includes for related calendar events.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Retrieve records of the given page. |
| `order` | string ("id-asc" | "id-desc") | No | Ordering options for group calendars. |
| `perpage` | integer | No | Elements per page, maximum of 250. |
| `includes` | string | No | Additional related data to include. Possible option: 'cal_events'. |

#### Output

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

### List Historic Events

**Slug:** `CENTRALSTATIONCRM_LIST_HISTORIC_EVENTS`

Tool to retrieve all historic events from the CentralStationCRM account. Use when you need to list historic events with optional filtering and pagination.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number to retrieve (>=1). |
| `order` | string ("id-asc" | "id-desc") | No | Ordering options for historic events. |
| `filter` | object | No | Filter by historic event attributes. Use modifiers like 'equal', 'smaller_than', 'larger_than', 'between' (expects two comma-separated values), or 'in' (expects comma-separated list). Example: {'user_id': {'equal': 42}} or {'created_at': {'between': '2023-01-01,2023-02-01'}}. |
| `date_to` | string | No | Filter historic events up to this date (format: YYYY-MM-DD). Must be used together with date_from parameter. |
| `perpage` | integer | No | Number of elements per page (maximum 250). |
| `date_from` | string | No | Filter historic events from this date onwards (format: YYYY-MM-DD). Must be used together with date_to parameter. |

#### Output

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

### List Hooks

**Slug:** `CENTRALSTATIONCRM_LIST_HOOKS`

Tool to retrieve all hooks of the account from CentralStationCRM. Use when you need to list, browse, or inspect webhook configurations in the system.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Retrieve records of the given page |
| `perpage` | integer | No | Elements per page, maximum of 250 |
| `includes` | string | No | Additional related data to include. Possible option: filter_groups |

#### Output

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

### List People

**Slug:** `CENTRALSTATIONCRM_LIST_PEOPLE`

Tool to retrieve a paginated list of all people from CentralStationCRM. Use when you need to browse or search through people with filtering and pagination support.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Retrieve records of the given page |
| `order` | string ("abc-asc" | "abc-desc" | "new-asc" | "new-desc" | "update-asc" | "update-desc") | No | Order options for people listing. |
| `filter` | object | No | Optionally submit one of the people attributes in order to filter by them. Allowed filter modifiers are: smaller_than, larger_than, equal, between (expects two comma-separated values), or in (expects comma-separated list). Example: {'name': {'equal': 'John Doe'}} or {'user_id': {'equal': 42}} |
| `tag_id` | integer | No | Optionally submit a tag ID in order to only see people tagged with the submitted tag |
| `methods` | string | No | Additional methods to include. Options: responsible_user_natural_name, salutation_official, salutation_formal, salutation_informal, backlink, stream_updated_at, absolute_url, absolute_avatar_url (space-separated). Use 'all' to receive all methods. |
| `perpage` | integer | No | Elements per page, maximum of 250 |
| `includes` | string | No | Additional related data to include. Options: positions, companies, deals, projects, tags, tasks, tasks_pending, pending_tasks, upcoming_cal_events, tels, emails, ims, sms, homepages, addrs, addrs_from_company, custom_fields, historic_events, assis, connections, user (space-separated). Use 'all' to receive all includes. |
| `tag_name` | string | No | Optionally submit a tag name in order to only see people tagged with the submitted tag |
| `custom_fields` | string | No | Optionally submit one or multiple custom field types to filter by their value. This shall be formatted like custom_fields[custom_field_type_id]=value |
| `stream_updated_at_after` | string | No | Optionally submit a date or timestamp (ISO 8601) in order to only see people with activities within the stream later than the submitted point in time. |
| `stream_updated_at_before` | string | No | Optionally submit a date or timestamp (ISO 8601) in order to only see people with activities within the stream earlier than the submitted point in time. |

#### Output

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

### List People Assis

**Slug:** `CENTRALSTATIONCRM_LIST_PEOPLE_ASSIS`

Tool to retrieve all assis of a person. Use when you need to list all assistant contacts associated with a specific person by their ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Retrieve records of the given page |
| `order` | string ("id-asc" | "id-desc") | No | Ordering options for assis results. |
| `perpage` | integer | No | Elements per page, maximum of 250 |
| `person_id` | integer | Yes | ID of the person the assi belong to |

#### Output

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

### List People Avatars

**Slug:** `CENTRALSTATIONCRM_LIST_PEOPLE_AVATARS`

Tool to retrieve all avatars for a specific person. Use when you need to list a person's avatar images with pagination support.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number to retrieve (>=1). |
| `perpage` | integer | No | Number of avatars per page (maximum 250). |
| `person_id` | string | Yes | Unique identifier of the person whose avatars are to be retrieved |

#### Output

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

### List People Contact Details

**Slug:** `CENTRALSTATIONCRM_LIST_PEOPLE_CONTACT_DETAILS`

Tool to retrieve all contact details for a specific person. Use when you need to list contact information after confirming the person ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Retrieve records of the given page |
| `order` | string ("id-asc" | "id-desc") | No | Ordering options for contact details. |
| `perpage` | integer | No | Elements per page, maximum of 250 |
| `person_id` | integer | Yes | ID of the person the contact details belong to |

#### Output

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

### List People Custom Fields

**Slug:** `CENTRALSTATIONCRM_LIST_PEOPLE_CUSTOM_FIELDS`

Tool to retrieve all custom fields for a specific person from the dedicated custom fields endpoint. Use when you need to list a person's custom fields after confirming their ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Retrieve records of the given page |
| `order` | string ("id-asc" | "id-desc") | No | Ordering options for custom fields list. |
| `perpage` | integer | No | Elements per page, maximum of 250 |
| `includes` | string | No | Possible option: custom_fields_type |
| `person_id` | integer | Yes | ID of the person whose custom fields are to be retrieved |

#### Output

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

### List People External Emails

**Slug:** `CENTRALSTATIONCRM_LIST_PEOPLE_EXTERNAL_EMAILS`

Tool to retrieve all external emails for a specific person from CentralStationCRM. Use when you need to access email communications associated with a person.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Retrieve records of the given page |
| `order` | string ("id-asc" | "id-desc") | No | Order options for listing external emails. |
| `perpage` | integer | No | Elements per page, maximum of 250 |
| `includes` | string | No | Additional related data to include. Possible option: comments |
| `person_id` | integer | Yes | ID of the person whose external emails are to be retrieved |

#### Output

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

### List People Historic Events

**Slug:** `CENTRALSTATIONCRM_LIST_PEOPLE_HISTORIC_EVENTS`

Tool to retrieve all historic events of a person. Use when you need to list all milestone dates (birthdays, anniversaries, etc.) recorded for a specific person.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Retrieve records of the given page |
| `order` | string ("id-asc" | "id-desc") | No | Order options for listing historic events. |
| `perpage` | integer | No | Elements per page, maximum of 250 |
| `person_id` | integer | Yes | ID of the person the historic event belong to |

#### Output

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

### List People Positions

**Slug:** `CENTRALSTATIONCRM_LIST_PEOPLE_POSITIONS`

Tool to retrieve all positions for a specific person. Use when you need to list a person's job positions or company affiliations. Example: "Get all positions for person with ID 43057993."

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number to retrieve |
| `order` | string ("id-asc" | "id-desc") | No | Order options for listing positions. |
| `perpage` | integer | No | Number of entries per page (maximum 250) |
| `includes` | string | No | Comma-separated list of related objects to include. Possible includes: 'person', 'company'. Use 'all' to receive all includes |
| `person_id` | integer | Yes | Unique identifier of the person whose positions are to be retrieved |

#### Output

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

### List People Protocol Attachments

**Slug:** `CENTRALSTATIONCRM_LIST_PEOPLE_PROTOCOLS_ATTACHMENTS`

Tool to retrieve all attachments for a specific protocol within a person. Use when you need to list attachments associated with a person's protocol.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number to retrieve (>=1). |
| `order` | string ("id-asc" | "id-desc") | No | Ordering options for attachment list. |
| `methods` | string | No | Additional methods to include in the response. Possible values: 'responsible_user_natural_name', 'attachment_category_name' (space-separated). Use 'all' to receive all methods. |
| `perpage` | integer | No | Number of elements per page (maximum 250). |
| `includes` | string | No | Additional related data to include in the response. Possible values: 'user', 'attachment_category', 'comments' (space-separated). Use 'all' to receive all includes. |
| `person_id` | integer | Yes | ID of the person the protocol belongs to. |
| `protocol_id` | integer | Yes | ID of the protocol to retrieve attachments from. |

#### Output

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

### List People Tags

**Slug:** `CENTRALSTATIONCRM_LIST_PEOPLE_TAGS`

Tool to retrieve all tags for a specific person. Use when you need to list a person's tags after confirming their ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number to retrieve (>=1) |
| `perpage` | integer | No | Number of entries per page (maximum 250) |
| `person_id` | integer | Yes | Unique identifier of the person whose tags are to be retrieved |

#### Output

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

### List Projects

**Slug:** `CENTRALSTATIONCRM_LIST_PROJECTS`

Tool to retrieve a paginated list of all projects from CentralStationCRM. Use when you need to browse or search through projects with filtering and pagination support.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Retrieve records of the given page |
| `order` | string ("date-asc" | "date-desc" | "new-asc" | "new-desc" | "update-asc" | "update-desc" | "state-asc" | "state-desc" | "abc-asc" | "abc-desc") | No | Order options for project listing. |
| `filter` | object | No | Filter by project attributes using modifiers: smaller_than, larger_than, equal, between (expects two comma-separated values), or in (expects comma-separated list). Example: {'user_id': {'equal': 42}} |
| `tag_id` | integer | No | Optionally submit a tag ID to filter projects tagged with the submitted tag |
| `methods` | string | No | Additional methods to include. Options: responsible_user_natural_name, people_ids, absolute_url, stream_updated_at (space-separated). Use 'all' to receive all methods. |
| `perpage` | integer | No | Elements per page, maximum of 250 |
| `includes` | string | No | Additional related data to include. Options: tags, people, company, task_lists, tasks, pending_tasks, cal_events, upcoming_cal_events, custom_fields (space-separated). Use 'all' to receive all includes. |
| `tag_name` | string | No | Optionally submit a tag name to filter projects tagged with the submitted tag |
| `stream_updated_at_after` | string | No | Filter projects with activities within the stream later than the submitted point in time (ISO 8601 date or timestamp) |
| `stream_updated_at_before` | string | No | Filter projects with activities within the stream earlier than the submitted point in time (ISO 8601 date or timestamp) |

#### Output

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

### List Projects External Emails

**Slug:** `CENTRALSTATIONCRM_LIST_PROJECTS_EXTERNAL_EMAILS`

Tool to retrieve all external emails for a specific project from CentralStationCRM. Use when you need to access email communications associated with a project.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Retrieve records of the given page |
| `order` | string ("id-asc" | "id-desc") | No | Ordering options for external emails. |
| `perpage` | integer | No | Elements per page, maximum of 250 |
| `includes` | string | No | Additional related data to include. Possible option: comments |
| `project_id` | integer | Yes | ID of the project whose external emails are to be retrieved |

#### Output

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

### List Project Protocol Attachments

**Slug:** `CENTRALSTATIONCRM_LIST_PROJECTS_PROTOCOLS_ATTACHMENTS`

Tool to retrieve all attachments for a specific protocol within a project. Use when you need to list attachments associated with a project's protocol.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number to retrieve (>=1). |
| `order` | string ("id-asc" | "id-desc") | No | Ordering options for attachment list. |
| `methods` | string | No | Additional methods to include in the response. Possible values: 'responsible_user_natural_name', 'attachment_category_name' (space-separated). Use 'all' to receive all methods. |
| `perpage` | integer | No | Number of elements per page (maximum 250). |
| `includes` | string | No | Additional related data to include in the response. Possible values: 'user', 'attachment_category', 'comments' (space-separated). Use 'all' to receive all includes. |
| `project_id` | integer | Yes | ID of the project the protocol belongs to. |
| `protocol_id` | integer | Yes | ID of the protocol to retrieve attachments from. |

#### Output

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

### List Protocols

**Slug:** `CENTRALSTATIONCRM_LIST_PROTOCOLS`

Tool to retrieve all protocols from CentralStationCRM. Use when you need to list protocols with optional filtering by person, company, deal, or project.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Retrieve records of the given page |
| `order` | string ("id-asc" | "id-desc") | No | Ordering options for protocols. |
| `deal_id` | integer | No | Optional ID of the desired deal protocols |
| `methods` | string | No | Possible methods are: responsible_user_natural_name, absolute_url, conversion_step_names separated by space. Receive all methods using the 'all' value. |
| `perpage` | integer | No | Elements per page, maximum of 250 |
| `includes` | string | No | Possible option: comments |
| `person_id` | integer | No | Optional ID of the desired person |
| `company_id` | integer | No | Optional ID of the desired company protocols |
| `project_id` | integer | No | Optional ID of the desired project protocols |

#### Output

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

### List Protocol Attachments

**Slug:** `CENTRALSTATIONCRM_LIST_PROTOCOLS_ATTACHMENTS`

Tool to retrieve all attachments for a specific protocol. Use when you need to list attachments associated with a protocol.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number to retrieve (>=1). |
| `order` | string ("id-asc" | "id-desc") | No | Ordering options for attachment list. |
| `methods` | string | No | Additional methods to include in the response. Possible values: 'responsible_user_natural_name', 'attachment_category_name' (space-separated). Use 'all' to receive all methods. |
| `perpage` | integer | No | Number of elements per page (maximum 250). |
| `includes` | string | No | Additional related data to include in the response. Possible values: 'user', 'attachment_category', 'comments' (space-separated). Use 'all' to receive all includes. |
| `protocol_id` | integer | Yes | ID of the protocol to retrieve attachments from. |

#### Output

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

### List Tags

**Slug:** `CENTRALSTATIONCRM_LIST_TAGS`

Tool to retrieve all tags from CentralStationCRM. Use when you need to browse tags with optional filtering by person, company, deal, or project.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Retrieve records of the given page |
| `order` | string ("id-asc" | "id-desc") | No | Order options for tag listing. |
| `filter` | object | No | Filter by tag attributes using modifiers: smaller_than, larger_than, equal, between (expects two comma-separated values like '2023-01-01,2023-02-01'), or in (expects comma-separated list like '23,42,99'). Example: {'user_id': {'equal': 42}} |
| `deal_id` | integer | No | Optional ID of the desired deal to filter tags by |
| `perpage` | integer | No | Elements per page, maximum of 250 |
| `person_id` | integer | No | Optional ID of the desired person to filter tags by |
| `company_id` | integer | No | Optional ID of the desired company to filter tags by |
| `project_id` | integer | No | Optional ID of the desired project to filter tags by |

#### Output

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

### List Tags 2

**Slug:** `CENTRALSTATIONCRM_LIST_TAGS2`

Tool to retrieve all tag names from CentralStationCRM. Use when you need a simple list of tag names (strings) with pagination support.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Retrieve records of the given page |
| `perpage` | integer | No | Elements per page, maximum of 250 |

#### Output

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

### List Tasks

**Slug:** `CENTRALSTATIONCRM_LIST_TASKS`

Tool to retrieve a paginated list of all tasks from CentralStationCRM. Use when you need to browse or search through tasks with filtering and pagination support.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Retrieve records of the given page |
| `after` | string | No | Filter tasks with dates after this date. Format: YYYY-MM-DD |
| `order` | string ("id-asc" | "id-desc") | No | Order options for task listing. |
| `state` | string ("open" | "closed") | No | State filter options for tasks. |
| `before` | string | No | Filter tasks with dates before this date. Format: YYYY-MM-DD |
| `methods` | string | No | Additional methods to include. Option: responsible_user_natural_name |
| `perpage` | integer | No | Elements per page, maximum of 250 |
| `user_id` | string | No | Filter tasks by user ID |
| `includes` | string | No | Additional related data to include. Options: user, comments (space-separated). Use 'all' to receive all includes. |

#### Output

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

### List Users

**Slug:** `CENTRALSTATIONCRM_LIST_USERS`

Tool to retrieve all users of the account from CentralStationCRM. Use when you need to list system users with pagination support.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Retrieve records of the given page |
| `active` | string | No | Optional parameter to only include currently active users. Set to "true" to filter active users. |
| `perpage` | integer | No | Elements per page, maximum of 250 |

#### Output

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

### Merge Companies

**Slug:** `CENTRALSTATIONCRM_MERGE_COMPANIES`

Tool to merge multiple companies into an existing company by ID. Use after identifying duplicate company records to consolidate them.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `no_log` | boolean | No | Set to true if you don't want to generate an activity for the stream |
| `group_id` | integer | No | Optional. New group ID to assign the merged company |
| `company_id` | integer | Yes | ID of the winner company that other companies will be merged into |
| `looser_ids` | array | Yes | List of company IDs to merge into the winner company |

#### Output

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

### Merge Person

**Slug:** `CENTRALSTATIONCRM_MERGE_PERSON`

Tool to merge another person into an existing person by ID. Use after identifying duplicate records to consolidate them. Example: merge person 42 with [43,44].

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `no_log` | boolean | No | Suppress creation of an activity log entry when merging |
| `group_id` | integer | No | Optional. New group ID to assign the merged person |
| `person_id` | integer | Yes | ID of the existing person into whom others will be merged |
| `looser_ids` | array | Yes | List of person IDs to merge into the target person |

#### Output

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

### Search Attachments

**Slug:** `CENTRALSTATIONCRM_SEARCH_ATTACHMENTS`

Search for attachments in CentralStationCRM by filename. Returns a list of attachments with their metadata including file details, timestamps, and optional related data such as user, category, and comments. Use when you need to find specific files or documents attached to CRM records.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `methods` | string | No | Possible methods are: responsible_user_natural_name, attachment_category_name separated by space. Receive all methods using the 'all' value. |
| `filename` | string | No | Find attachments where the filename includes or matches the given input. Supports partial matching. |
| `includes` | string | No | Possible includes are: user, attachment_category, comments separated by space. Receive all includes using the 'all' value. |

#### Output

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

### Search Companies

**Slug:** `CENTRALSTATIONCRM_SEARCH_COMPANIES`

Tool to search for companies in CentralStationCRM by name. Use when you need to find companies matching a specific name or retrieve a list of all companies with pagination support.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Retrieve companies by their name. Performs a search match. This parameter is required. |
| `page` | integer | No | Retrieve records of the given page. Must be >= 1. |
| `methods` | string | No | Space-separated list of methods to invoke. Possible values: responsible_user_natural_name, related_tasks, stream_updated_at, absolute_url. Use 'all' to invoke all methods. |
| `perpage` | integer | No | Elements per page, maximum of 250. Must be between 1 and 250. |
| `includes` | string | No | Space-separated list of related data to include. Possible values: positions, deals, projects, tags, tasks, pending_tasks, cal_events, upcoming_cal_events, tels, emails, ims, sms, homepages, addrs, connections, custom_fields. Use 'all' to include everything. |

#### Output

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

### Search Company Protocol Attachments

**Slug:** `CENTRALSTATIONCRM_SEARCH_COMPANIES_PROTOCOLS_ATTACHMENTS`

Tool to search for attachments within a specific protocol of a company. Use when you need to find specific attachments by filename within a company's protocol.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `methods` | string | No | Additional methods to include in the response. Possible values: 'responsible_user_natural_name', 'attachment_category_name' (space-separated). Use 'all' to receive all methods. |
| `filename` | string | No | Find attachments where the filename includes or matches the given input. Supports partial matching. |
| `includes` | string | No | Additional related data to include in the response. Possible values: 'user', 'attachment_category', 'comments' (space-separated). Use 'all' to receive all includes. |
| `company_id` | integer | Yes | ID of the company the protocol belongs to. |
| `protocol_id` | integer | Yes | ID of the protocol to search attachments in. |

#### Output

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

### Search Contact Details

**Slug:** `CENTRALSTATIONCRM_SEARCH_CONTACT_DETAILS`

Tool to search for contact details in CentralStationCRM by name, email, phone, or other criteria. Use when you need to find people or companies by their contact information such as email addresses or phone numbers.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Search term to match contact details. Searches across email addresses, phone numbers, and other contact information. |
| `page` | integer | No | Page number to retrieve (1-indexed). Must be >= 1. |
| `type` | string ("people" | "companies") | No | Contact type for search. |
| `perpage` | integer | No | Number of results per page. Maximum of 250. Must be between 1 and 250. |

#### Output

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

### Search Deals

**Slug:** `CENTRALSTATIONCRM_SEARCH_DEALS`

Tool to search for deals by name and retrieve matching results with pagination. Use when you need to find specific deals or filter the deal list by name.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | Retrieve deals by their name (partial match supported). |
| `page` | integer | No | Retrieve records of the given page. |
| `methods` | string | No | Possible methods are: responsible_user_natural_name, people_ids, absolute_url, stream_updated_at separated by space. Receive all methods using the 'all' value. |
| `perpage` | integer | No | Elements per page, maximum of 250. |
| `includes` | string | No | Possible includes are: tags, people, company, task_lists, tasks, pending_tasks, cal_events, upcoming_cal_events, custom_fields separated by space. Receive all includes using the 'all' value. |

#### Output

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

### Search Deal Protocol Attachments

**Slug:** `CENTRALSTATIONCRM_SEARCH_DEALS_PROTOCOLS_ATTACHMENTS`

Tool to search for attachments within a specific deal protocol in CentralStationCRM. Returns a list of attachments matching the search criteria with their metadata including file details, timestamps, and optional related data such as user, category, and comments. Use when you need to find specific files or documents attached to a deal protocol.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `deal_id` | integer | Yes | Unique identifier of the deal to search attachments in. |
| `methods` | string | No | Possible methods are: responsible_user_natural_name, attachment_category_name separated by space. Receive all methods using the 'all' value. |
| `filename` | string | No | Find attachments where the filename includes or matches the given input. Supports partial matching. |
| `includes` | string | No | Possible includes are: user, attachment_category, comments separated by space. Receive all includes using the 'all' value. |
| `protocol_id` | integer | Yes | Unique identifier of the protocol within the deal to search attachments in. |

#### Output

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

### Search People

**Slug:** `CENTRALSTATIONCRM_SEARCH_PEOPLE`

Search for people in CentralStationCRM by name, email, phone, or other text criteria. Returns a paginated list of people with their complete profile information including contact details, timestamps, and associated metadata. All parameters are optional; if no query is provided, returns all people with default pagination.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | 1-indexed page number of results, must be >= 1. |
| `query` | string | No | Text to search for in name, email, phone, etc. |
| `per_page` | integer | No | Number of results per page, must be >= 1. |

#### Output

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

### Search Person Protocol Attachments

**Slug:** `CENTRALSTATIONCRM_SEARCH_PEOPLE_PROTOCOLS_ATTACHMENTS`

Tool to search for attachments within a specific person protocol in CentralStationCRM. Returns a list of attachments matching the search criteria with their metadata including file details, timestamps, and optional related data such as user, category, and comments. Use when you need to find specific files or documents attached to a person protocol.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `methods` | string | No | Possible methods are: responsible_user_natural_name, attachment_category_name separated by space. Receive all methods using the 'all' value. |
| `filename` | string | No | Find attachments where the filename includes or matches the given input. Supports partial matching. |
| `includes` | string | No | Possible includes are: user, attachment_category, comments separated by space. Receive all includes using the 'all' value. |
| `person_id` | integer | Yes | Unique identifier of the person to search attachments in. |
| `protocol_id` | integer | Yes | Unique identifier of the protocol within the person to search attachments in. |

#### Output

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

### Search People V2

**Slug:** `CENTRALSTATIONCRM_SEARCH_PEOPLE_V2`

Tool to search for people in CentralStationCRM using specific criteria like name, email, or phone. Use when you need to find people by last name, first name, email address, or phone number. Supports pagination and optional includes for additional related data.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | Search people by their last name |
| `page` | integer | No | Retrieve records of the given page |
| `email` | string | No | Search people by their email address (mutually exclusive with phone) |
| `phone` | string | No | Search people by their phone number (mutually exclusive with email) |
| `methods` | string | No | Additional methods to call. Possible values: responsible_user_natural_name, salutation_official, salutation_formal, salutation_informal, backlink, stream_updated_at, absolute_url, absolute_avatar_url separated by space. Use 'all' to receive all methods. |
| `perpage` | integer | No | Elements per page, maximum of 250 |
| `includes` | string | No | Additional data to include. Possible values: positions, companies, deals, projects, tags, tasks, tasks_pending, pending_tasks, upcoming_cal_events, tels, emails, ims, sms, homepages, addrs, addrs_from_company, custom_fields, historic_events, assis, connections, user separated by space. Use 'all' to receive all includes. |
| `first_name` | string | No | Search people by their first name |

#### Output

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

### Search Projects

**Slug:** `CENTRALSTATIONCRM_SEARCH_PROJECTS`

Tool to search for projects in CentralStationCRM by name. Use when you need to find projects matching a specific name or retrieve a list of all projects with pagination support.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | Retrieve projects by their name (partial match supported). |
| `page` | integer | No | Retrieve records of the given page. Must be >= 1. |
| `methods` | string | No | Space-separated list of methods to invoke. Possible values: responsible_user_natural_name, people_ids, absolute_url, stream_updated_at. Use 'all' to invoke all methods. |
| `perpage` | integer | No | Elements per page, maximum of 250. Must be between 1 and 250. |
| `includes` | string | No | Space-separated list of related data to include. Possible values: tags, people, company, task_lists, tasks, pending_tasks, cal_events, upcoming_cal_events, custom_fields. Use 'all' to include everything. |

#### Output

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

### Search Project Protocol Attachments

**Slug:** `CENTRALSTATIONCRM_SEARCH_PROJECTS_PROTOCOLS_ATTACHMENTS`

Tool to search for attachments within a specific protocol of a project. Use when you need to find specific attachments by filename within a project's protocol.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `methods` | string | No | Additional methods to include in the response. Possible values: 'responsible_user_natural_name', 'attachment_category_name' (space-separated). Use 'all' to receive all methods. |
| `filename` | string | No | Find attachments where the filename includes or matches the given input. Supports partial matching. |
| `includes` | string | No | Additional related data to include in the response. Possible values: 'user', 'attachment_category', 'comments' (space-separated). Use 'all' to receive all includes. |
| `project_id` | integer | Yes | ID of the project the protocol belongs to. |
| `protocol_id` | integer | Yes | ID of the protocol to search attachments in. |

#### Output

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

### Search Records

**Slug:** `CENTRALSTATIONCRM_SEARCH_RECORDS`

Tool to retrieve search results from CentralStationCRM. Use when you need to search for records using a search term.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `term` | string | Yes | Search term to query records. This parameter is required. The API will return an error if the search term is missing. |

#### Output

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

### Search Users

**Slug:** `CENTRALSTATIONCRM_SEARCH_USERS`

Tool to search for users in CentralStationCRM by first name or last name. Use when you need to find users matching specific name criteria or retrieve a list of all users with pagination support.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | Retrieve users by their last name. Performs a search match. |
| `page` | integer | No | Retrieve records of the given page. Must be >= 1. |
| `first` | string | No | Retrieve users by their first name. Performs a search match. |
| `perpage` | integer | No | Elements per page, maximum of 250. Must be between 1 and 250. |

#### Output

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

### Stats People

**Slug:** `CENTRALSTATIONCRM_STATS_PEOPLE`

Retrieve statistics about people (contacts) in your CRM. Returns the total count of people matching the specified criteria. Use this when you need a quick count without fetching full person records. Supports filtering by tags and various field criteria (user_id, created_by_user_id, account_id, group_id, etc.) using operators like 'equal', 'larger_than', 'smaller_than', and 'between'.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `filter` | object | No | Filter criteria in deepObject style. Supports operators: 'equal', 'smaller_than', 'larger_than', 'between'. Common filterable fields include: user_id, created_by_user_id, updated_by_user_id, group_id, account_id. Example: {'user_id': {'equal': 42}} or {'created_by_user_id': {'larger_than': 100}}. |
| `tag_id` | integer | No | Filter statistics by this tag's ID. |
| `tag_name` | string | No | Filter statistics by this tag's name. |

#### Output

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

### Update Calendar Event

**Slug:** `CENTRALSTATIONCRM_UPDATE_CAL_EVENT`

Tool to update an existing calendar event by ID. Use when you need to modify event details such as name, time, status, or attendees.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | UUID of the calendar event to update |
| `no_log` | boolean | No | Set to true if you don't want to generate an activity for the stream |
| `cal_event` | object | Yes | Calendar event details to update |

#### Output

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

### Update Calendar Event Attendee

**Slug:** `CENTRALSTATIONCRM_UPDATE_CAL_EVENT_ATTENDEE`

Tool to update a calendar event attendee. Use when you need to modify attendee status, email, or associated person/user for a calendar event.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Unique identifier of the calendar event attendee to update |
| `email` | string | No | Email address of the attending person or user. Invitations will be sent to this address if email_notifications is set to true for the related cal event |
| `status` | string ("new" | "invited" | "no_invite" | "accepted" | "rejected" | "perhaps" | "canceled") | Yes | Status of the attendee. Can be new, invited, no_invite, accepted, rejected, perhaps or canceled |
| `user_id` | integer | No | ID of the related CSCRM user. Either person_id or user_id has to be set to valid records |
| `person_id` | integer | No | ID of the related CSCRM person. Either person_id or user_id has to be set to valid records |
| `cal_event_id` | string | Yes | Unique identifier of the calendar event |

#### Output

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

### Update Comment

**Slug:** `CENTRALSTATIONCRM_UPDATE_COMMENT`

Tool to update an existing comment by ID. Use when you need to modify the text or properties of a comment attached to tasks, events, or other entities.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The unique identifier of the comment to update |
| `name` | string | Yes | The updated text content of the comment |
| `user_id` | integer | No | ID of the user associated with this comment |
| `attachable_id` | string | No | ID of the entity this comment is attached to |
| `attachable_type` | string ("Attachment" | "CalEvent" | "Protocol" | "ExternalEmail" | "Task") | No | Types of entities a comment can be attached to. |

#### Output

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

### Update Company

**Slug:** `CENTRALSTATIONCRM_UPDATE_COMPANY`

Tool to update an existing company by ID. Use after retrieving the company's details when you need to modify one or more fields.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | The company's name |
| `no_log` | boolean | No | Set to true if you don't want to generate an activity in the stream |
| `user_id` | integer | No | Optional ID of the user responsible for the company |
| `group_id` | integer | No | Optional ID of the group to assign the company to |
| `background` | string | No | Optional background or description of the company |
| `company_id` | integer | Yes | The unique identifier of the company to update |

#### Output

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

### Update Company Address

**Slug:** `CENTRALSTATIONCRM_UPDATE_COMPANY_ADDRESS`

Tool to update a specific address of a company. Use after retrieving the company's addresses to modify one.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | Yes | ID of the address to update |
| `zip` | string | No | The zip code |
| `city` | string | Yes | The city name. Either the city or the country_code is mandatory |
| `atype` | string ("work_hq" | "work" | "invoice" | "delivery" | "private" | "other") | Yes | Type of address. Must be one of work_hq, work, invoice, delivery, private or other |
| `street` | string | No | The street including the house number or other details (building, c/o) |
| `primary` | boolean | No | Decides about the order of addresses when the attachable (Person or Company) has multiple addresses |
| `api_input` | boolean | No | States whether or not the address has been added via the API or some sort of integration |
| `company_id` | integer | Yes | ID of the company the address belongs to |
| `state_code` | string | No | The state code (e.g. NW, BY). Must match the country code |
| `country_code` | string | No | The country code (e.g. DE, AT) |
| `attachable_id` | integer | Yes | The ID of the record the address belongs to. Will be auto set when using routes such as /companies/:id with nested attributes |
| `attachable_type` | string | Yes | The record type the address belongs to. Must be either Person or Company. Will be auto set when using routes such as /companies/:id with nested attributes |

#### Output

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

### Update Company Contact Detail

**Slug:** `CENTRALSTATIONCRM_UPDATE_COMPANY_CONTACT_DETAIL`

Tool to update a contact detail for a company by ID. Use after retrieving the company's contact details to modify one.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | Yes | ID of the contact detail to update |
| `name` | string | Yes | The value of the contact detail according to the selected type. |
| `atype` | string ("office" | "office_hq" | "mobile" | "fax" | "private" | "voip" | "skype" | "other") | Yes | Phone type. Must be one of office, office_hq, mobile, fax, private, voip, skype or other. |
| `company_id` | integer | Yes | ID of the company the contact details belong to |
| `attachable_id` | integer | Yes | The ID of the record the contact detail belongs to. |
| `attachable_type` | string ("Person" | "Company") | Yes | The record type the contact detail belongs to. Must be either Person or Company. |

#### Output

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

### Update Custom Field Type

**Slug:** `CENTRALSTATIONCRM_UPDATE_CUSTOM_FIELDS_TYPE`

Tool to update a custom field type by ID. Use when you need to modify the category, data type, name, options, or position of an existing custom field definition.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The unique identifier of the custom field type to update |
| `custom_fields_type` | object | Yes | The custom field type data to update |

#### Output

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

### Update Deal

**Slug:** `CENTRALSTATIONCRM_UPDATE_DEAL`

Tool to update an existing deal record. Use when you need to modify deal details like background, state, value, or associated entities.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | Yes | Unique identifier of the deal to update |
| `name` | string | No | Name of the deal (max 120 chars) |
| `value` | string | No | Monetary value of the deal in decimal format |
| `no_log` | boolean | No | Set to true if you don't want to generate an activity for the stream |
| `user_id` | integer | No | User ID responsible for this deal |
| `currency` | string | No | Currency code (EUR, CHF, or USD). Default is EUR |
| `group_id` | integer | No | Group ID for the deal |
| `value_sum` | string | No | Total sum of the deal value (value * value_count depending on value_type). Must be in decimal format. |
| `background` | string | No | Details about the deal, e.g., history or notes |
| `company_id` | integer | No | Company ID to associate with the deal |
| `value_type` | string ("total" | "monthly" | "hourly" | "daily") | No | Type of billing: total, monthly, hourly, or daily |
| `finished_at` | string | No | Date-time when the deal was set to won or lost (ISO8601 format) |
| `probability` | integer | No | Probability of winning the deal in percent (0-100) |
| `target_date` | string | No | Target date when the deal shall be won in YYYY-MM-DD format |
| `value_count` | string | No | Quantity or count; only relevant if value_type is not 'total'. Must be in decimal format. |
| `deal_type_id` | integer | No | ID of the pipeline for this deal |
| `current_state` | string ("open_0" | "open_25" | "open_50" | "open_75" | "won" | "lost") | No | State of the deal: open_0, open_25, open_50, open_75, won, or lost |
| `deal_type_stage_id` | integer | No | ID of the stage within the pipeline |

#### Output

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

### Update Group Calendar

**Slug:** `CENTRALSTATIONCRM_UPDATE_GROUP_CALENDARS`

Tool to update an existing group calendar by ID. Use when you need to modify calendar properties like name, color, or read-only status.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Unique identifier (UUID) of the group calendar to update |
| `group_calendar` | object | Yes | Group calendar object containing the fields to update |

#### Output

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

### Update People Custom Fields

**Slug:** `CENTRALSTATIONCRM_UPDATE_PEOPLE_CUSTOM_FIELDS`

Tool to update a person's custom field by its ID. Use when you need to modify a custom field value after confirming the person_id and custom field id.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | Yes | Unique identifier of the custom field to update. Must be a positive integer. |
| `person_id` | integer | Yes | Unique identifier of the person to which the custom field belongs. Must be a positive integer. |
| `custom_field` | object | Yes | Custom field data to update |

#### Output

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

### Update People Position

**Slug:** `CENTRALSTATIONCRM_UPDATE_PEOPLE_POSITION`

Tool to update a position for a specific person. Use after retrieving the person's positions when you need to modify position details such as title, department, or status.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | Yes | Unique identifier of the position to update |
| `name` | string | No | Name/title of the position (e.g., 'Principal Software Engineer') |
| `former` | boolean | No | Whether this is a former position (True) or current position (False). Positions that are no longer active may be marked as former |
| `person_id` | integer | Yes | Unique identifier of the person whose position is to be updated |
| `company_id` | integer | Yes | The ID of the company the position belongs to |
| `department` | string | No | Department within the company |
| `company_name` | string | No | Name of the company associated with this position |
| `primary_function` | boolean | No | Whether this is the primary function/position. Only one position may be set to primary |

#### Output

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

### Update Person

**Slug:** `CENTRALSTATIONCRM_UPDATE_PERSON`

Tool to update an existing person by ID. Use after retrieving the person's current details when you need to modify one or more fields.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | The person's last name (surname) |
| `title` | string | No | The person's job title |
| `gender` | string | No | The person's gender (valid values: 'male', 'female') |
| `user_id` | integer | No | The ID of the user responsible for this person |
| `person_id` | integer | Yes | The unique identifier of the person to update |
| `background` | string | No | Additional background or bio information |
| `first_name` | string | No | The person's first name |

#### Output

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

### Update Person Address

**Slug:** `CENTRALSTATIONCRM_UPDATE_PERSON_ADDRESS`

Tool to update a specific address of a person. Use after retrieving the person's addresses to modify one.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `zip` | string | No | ZIP or postal code |
| `city` | string | Yes | City name. Either city or country_code must be provided |
| `atype` | string ("work_hq" | "work" | "invoice" | "delivery" | "private" | "other") | No | Type of address, one of work_hq, work, invoice, delivery, private or other |
| `street` | string | No | The street including house number or additional info |
| `primary` | boolean | No | Whether this is the primary address |
| `person_id` | integer | Yes | Unique identifier of the person |
| `address_id` | integer | Yes | Unique identifier of the address to update |
| `state_code` | string | No | State or region code (e.g., NW) |
| `country_code` | string | No | ISO 3166-1 alpha-2 country code |

#### Output

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

### Update Person Assi

**Slug:** `CENTRALSTATIONCRM_UPDATE_PERSON_ASSI`

Tool to update an assi entry of a person. Use when you need to modify a specific assistant record after retrieving the person’s assis list. Example: "Update assi 101 for person 42 changing email to foo@example.com".

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tel` | string | No | The telephone number of the assistant. |
| `name` | string | Yes | The name of the assistant. |
| `email` | string | No | The email of the assistant. |
| `assi_id` | integer | Yes | Unique identifier of the assistant to update |
| `primary` | boolean | No | Indicates if the assistant is the primary contact. |
| `person_id` | integer | Yes | Unique identifier of the person |

#### Output

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

### Update Person Contact Detail

**Slug:** `CENTRALSTATIONCRM_UPDATE_PERSON_CONTACT_DETAIL`

Tool to update a specific contact detail of a person by ID. Use after retrieving the person's contact details to modify one.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | The phone number or contact value. |
| `atype` | string ("office" | "office_hq" | "mobile" | "fax" | "private" | "voip" | "skype" | "other") | Yes | Phone type. Must be one of office, office_hq, mobile, fax, private, voip, skype or other. |
| `primary` | boolean | No | Whether this should be the primary contact detail of this type |
| `visible` | boolean | No | Whether this contact detail is visible to other users |
| `person_id` | integer | Yes | Unique identifier of the person |
| `location_id` | integer | No | ID of the associated location if applicable |
| `contact_detail_id` | integer | Yes | Unique identifier of the contact detail to update |

#### Output

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

### Update Person Historic Event

**Slug:** `CENTRALSTATIONCRM_UPDATE_PERSON_HISTORIC_EVENT`

Tool to update a historic event of a person by ID. Use after retrieving the event when you need to modify its details. Example: "Update historic event 101 for person 42 changing atype to anniversary."

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `desc` | string | No | For atype 'other', an additional description may be provided. Ignored otherwise. |
| `name` | string | Yes | The date of the historic event in YYYY-MM-DD format. |
| `atype` | string ("birthday" | "anniversary" | "first_met" | "renewal" | "other") | Yes | Type of the historic event. Must be one of birthday, anniversary, first_met, renewal or other. |
| `event_id` | integer | Yes | Unique identifier of the historic event to update |
| `person_id` | integer | Yes | Unique identifier of the person |

#### Output

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

### Update Person Tag

**Slug:** `CENTRALSTATIONCRM_UPDATE_PERSON_TAG`

Tool to update a tag on a person. Use when you need to modify an existing tag's name or properties for a specific person.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The unique identifier of the tag to update |
| `tag` | object | Yes | The tag data to update |
| `person_id` | integer | Yes | The unique identifier of the person |

#### Output

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

### Update Project

**Slug:** `CENTRALSTATIONCRM_UPDATE_PROJECT`

Tool to update an existing project record. Use when you need to modify project details like name, target date, state, or associated entities.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | Yes | Unique identifier of the project to update |
| `name` | string | No | Name of the project (max 120 chars) |
| `no_log` | boolean | No | Set to true if you don't want to generate an activity for the stream |
| `deal_id` | integer | No | Deal ID to associate with the project |
| `user_id` | integer | No | User ID responsible for this project |
| `group_id` | integer | No | Group ID for the project |
| `background` | string | No | Details about the project, e.g., description or notes |
| `company_id` | integer | No | Company ID to associate with the project |
| `finished_at` | string | No | Date-time when the project was finished (ISO8601 format) |
| `target_date` | string | No | Target completion date in YYYY-MM-DD format |
| `current_state` | string ("open_0" | "open_25" | "open_50" | "open_75" | "won" | "lost") | No | State of the project: open_0, open_25, open_50, open_75, won, or lost |
| `person_ids_set` | string | No | Set of person IDs to associate with the project |

#### Output

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

### Update Protocol

**Slug:** `CENTRALSTATIONCRM_UPDATE_PROTOCOL`

Tool to update an existing protocol by ID. Use when you need to modify the content or metadata of a protocol record.

#### Input Parameters

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

#### Output

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

### Update Task

**Slug:** `CENTRALSTATIONCRM_UPDATE_TASK`

Tool to update an existing task by ID. Use when you need to modify task details such as name, status, badge, or assigned user.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The unique identifier of the task to update |
| `name` | string | Yes | The task name or description |
| `badge` | string ("task" | "call" | "email" | "visit" | "preparation" | "important") | No | Valid badge types for tasks. |
| `fuzzy` | boolean | No | Set to true if the precise_time hour and minutes are irrelevant, allowing the task to be done at any time during the day |
| `user_id` | integer | Yes | The ID of the user responsible for this task |
| `finished` | boolean | No | Set to true if the task is completed/done |
| `precise_time` | string | No | Date and time when the task should be done (ISO 8601 format) |
| `task_list_id` | integer | No | ID of the task list the task belongs to (must be within the attachable record) |
| `attachable_id` | integer | No | ID of the record the task belongs to (e.g., a person, company, or deal) |
| `attachable_type` | string ("Person" | "Company" | "Deal") | No | Valid attachable types for tasks. |

#### Output

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