---
canonical_url: "https://docs.composio.dev/toolkits/callback24"
markdown_url: "https://docs.composio.dev/toolkits/callback24.md"
product: "platform"
version: null
last_updated: null
---

# Callback24

Callback24 provides account APIs for managing phone calls, users, services, and routing groups.

- **Category:** call tracking
- **Auth:** API_KEY
- **Composio-managed OAuth available?** N/A
- **Tools:** 27
- **Triggers:** 0
- **Slug:** `CALLBACK24`
- **Version:** 00000000_00

## Tools

### Assign User to Service

**Slug:** `CALLBACK24_ASSIGN_USER_TO_SERVICE`

Assign a Callback24 user to a service, optionally within a routing group.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `user_id` | integer | Yes | Callback24 ID of the user to assign to the service. |
| `group_id` | integer | No | Optional Callback24 routing group ID for the assignment. |
| `service_id` | integer | Yes | Callback24 ID of the service to which the user will be assigned. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | 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 |

### Batch Assign Users to Service

**Slug:** `CALLBACK24_BATCH_ASSIGN_USERS_TO_SERVICE`

Sequentially assign 1-25 Callback24 users to one service. This operation is non-atomic and has no rollback: processing stops after the first provider failure, malformed success response, or transport error. The attempted user can be marked unknown when the assignment may have occurred; verify membership before retrying. All remaining users are marked not_attempted.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `group_id` | integer | No | Optional Callback24 routing group ID for every assignment. |
| `user_ids` | array | Yes | One to 25 unique positive Callback24 user IDs to assign in order. |
| `service_id` | integer | Yes | Callback24 ID of the service to which users will be assigned. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | 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 |

### Batch Remove Users from Service

**Slug:** `CALLBACK24_BATCH_REMOVE_USERS_FROM_SERVICE`

Sequentially remove 1-25 users from a Callback24 service. This operation is non-atomic and provides no rollback: processing stops after the first provider failure, malformed success response, or transport error. The attempted user can be marked unknown when removal may have occurred; verify membership before retrying. Remaining users are marked not_attempted.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `group_id` | integer | No | Optional Callback24 routing group ID for every removal. |
| `user_ids` | array | Yes | Callback24 IDs of 1-25 unique users to remove, in processing order. |
| `service_id` | integer | Yes | Callback24 ID of the service from which users will be removed. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | 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 |

### Cancel Upcoming Phone Calls

**Slug:** `CALLBACK24_CANCEL_UPCOMING_PHONE_CALLS`

Irreversibly bulk-cancel every upcoming phone call matching a phone number or lead reference. Optionally narrow the destructive operation by earliest scheduled time and service. The reason is permanently appended to each cancelled call's comments and defaults to 'Canceled by API, no reason'.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `reason` | string | No | Reason permanently appended to every matching call's comments. Defaults to 'Canceled by API, no reason'. |
| `service_id` | integer | No | Limit the irreversible bulk cancellation to this Callback24 service ID. |
| `phone_number` | string | No | Phone number selecting upcoming calls to irreversibly cancel. Required when lead_ref_number is omitted. |
| `starting_from` | string | No | Cancel only calls scheduled at or after this ISO 8601 datetime. Callback24 defaults to the current time when omitted. |
| `lead_ref_number` | string | No | Lead reference selecting upcoming calls to irreversibly cancel. Required when phone_number is omitted. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | 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

**Slug:** `CALLBACK24_CREATE_GROUP`

Create a routing group within a Callback24 service, with optional localized names.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `service_id` | integer | Yes | Callback24 service ID that will own the new group. |
| `german_name` | string | No | German display name for the group. |
| `polish_name` | string | No | Polish display name for the group. |
| `english_name` | string | No | English display name for the group. |
| `russian_name` | string | No | Russian display name for the group. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | 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 Phone Call

**Slug:** `CALLBACK24_CREATE_PHONE_CALL`

Create or schedule a real phone call in Callback24. This action can trigger customer-visible telephony to the supplied recipient phone number.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `type` | integer ("1" | "2" | "3" | "4") | No | Call type: 1 for callback, 2 for incoming, 3 for outgoing, or 4 for form. |
| `title` | string | No | Title of the phone call. |
| `domain` | string | No | Domain of the page where the call was requested. |
| `call_at` | string | No | ISO 8601 time at which to place the call. Callback24 uses the current time when omitted. |
| `referer` | string | No | URL of the page where the call was requested, without a path. |
| `website` | string | Yes | Website from which the call originated. |
| `comments` | string | No | Comment associated with the call. |
| `call_from` | string ("API" | "RESCHEDULED" | "WIDGET" | "POPUP" | "EXIT_POPUP" | "FORM" | "IMPORT") | No | Source of the call, such as API, RESCHEDULED, WIDGET, POPUP, EXIT_POPUP, FORM, or IMPORT. |
| `service_id` | integer | Yes | ID of the Callback24 service placing the call. |
| `contact_name` | string | No | Name of the contact who owns the phone number. |
| `phone_number` | string | Yes | Phone number of the call recipient. |
| `referer_from` | string | No | Previously visited website that referred the caller. |
| `referer_domain` | string | No | Domain of the previously visited referring website. |
| `lead_ref_number` | string | No | Lead reference number associated with the call. |
| `assigned_team_id` | integer | No | ID of the team assigned to the call. |
| `assigned_user_id` | integer | No | ID of the user assigned to the call. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | 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 Service

**Slug:** `CALLBACK24_CREATE_SERVICE`

Create a Callback24 service for a website. This can create customer-visible widget or routing configuration.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `website` | string | Yes | Website URL or domain for the new Callback24 service. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | 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 User

**Slug:** `CALLBACK24_CREATE_USER`

Create a company user in Callback24. This may send an invitation and may consume an account seat.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `role` | string | No | Callback24 role for the new user. The provider documents 'employee' as an example but does not publish the complete allowed set. |
| `email` | string | Yes | Email address for the new Callback24 user. |
| `last_name` | string | No | New user's last name. |
| `first_name` | string | No | New user's first name. |
| `phone_number` | string | No | New user's phone number. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | 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

**Slug:** `CALLBACK24_DELETE_GROUP`

Permanently and irreversibly delete one Callback24 routing group by group ID. This deletion cannot be undone.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `group_id` | integer | Yes | Callback24 ID of the routing group to permanently and irreversibly delete. This deletion cannot be undone. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | 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 Service

**Slug:** `CALLBACK24_DELETE_SERVICE`

Permanently and irreversibly delete one Callback24 service and its associated routing and customer-facing widget configuration. This operation cannot be undone.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `service_id` | integer | Yes | Callback24 ID of the service to permanently and irreversibly delete, including its associated routing and widget configuration. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | 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 User

**Slug:** `CALLBACK24_DELETE_USER`

Permanently and irreversibly delete one company user by Callback24 user ID. This operation cannot be undone.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `user_id` | integer | Yes | Callback24 ID of the company user to permanently and irreversibly delete. This cannot be undone. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | 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 Current User

**Slug:** `CALLBACK24_GET_CURRENT_USER`

Return the Callback24 user identity associated with the connected API token.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | 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

**Slug:** `CALLBACK24_GET_GROUP`

Return one Callback24 routing group by ID with its service ID and localized names.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `group_id` | integer | Yes | Callback24 ID of the routing group to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | 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 Phone Call

**Slug:** `CALLBACK24_GET_PHONE_CALL`

Return detailed metadata, tags, and assigned-user information for one Callback24 phone call.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `call_id` | integer | Yes | Callback24 ID of the phone call to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | 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 Phone Call Recording

**Slug:** `CALLBACK24_GET_PHONE_CALL_RECORDING`

Return the recording URL for one recorded phone call.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `call_id` | integer | Yes | Callback24 ID of the phone call whose recording is needed. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | 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 Service

**Slug:** `CALLBACK24_GET_SERVICE`

Return one Callback24 service with opening hours, routing groups, and assigned users.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `service_id` | integer | Yes | Callback24 ID of the service to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | 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:** `CALLBACK24_GET_USER`

Return one company user by Callback24 user ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `user_id` | integer | Yes | Callback24 ID of the user to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | 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 Groups

**Slug:** `CALLBACK24_LIST_GROUPS`

Return all Callback24 routing groups with their service IDs and localized names.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | 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 Phone Calls

**Slug:** `CALLBACK24_LIST_PHONE_CALLS`

Return one page of phone-call history, optionally filtered by type, date range, phone number, users, or services. Use limit with either page or offset to paginate; Callback24 does not document precedence, so do not combine page with a nonzero offset.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page of results to return. |
| `limit` | integer | No | Maximum calls requested for this page. Callback24 documents no upper bound. |
| `offset` | integer | No | Number of matching calls to skip for manual pagination. |
| `date_to` | string | No | Return calls on or before this ISO 8601 datetime. |
| `user_ids` | array | No | Return calls associated with any of these Callback24 user IDs. |
| `call_type` | string ("CALLBACK" | "INCOMING" | "OUTGOING") | No | Return only calls of this documented type. |
| `date_from` | string | No | Return calls on or after this ISO 8601 datetime. |
| `service_ids` | array | No | Return calls associated with any of these Callback24 service IDs. |
| `phone_number` | string | No | Return calls for this phone number. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | 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 Services

**Slug:** `CALLBACK24_LIST_SERVICES`

Return all Callback24 services with their nested groups, assigned users, and opening hours.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | 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:** `CALLBACK24_LIST_USERS`

Return all company users visible to the connected Callback24 account.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | 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 |

### Remove User from Service

**Slug:** `CALLBACK24_REMOVE_USER_FROM_SERVICE`

Remove a Callback24 user's assignment from a service, optionally within a routing group.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `user_id` | integer | Yes | Callback24 ID of the user to remove from the service. |
| `group_id` | integer | No | Optional Callback24 routing group ID for the assignment being removed. |
| `service_id` | integer | Yes | Callback24 ID of the service from which the user will be removed. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | 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

**Slug:** `CALLBACK24_UPDATE_GROUP`

Update one or more localized names for a Callback24 routing group.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `group_id` | integer | Yes | Callback24 ID of the routing group to update. |
| `german_name` | string | No | Replacement German display name. |
| `polish_name` | string | No | Replacement Polish display name. |
| `english_name` | string | No | Replacement English display name. |
| `russian_name` | string | No | Replacement Russian display name. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | 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 Phone Call

**Slug:** `CALLBACK24_UPDATE_PHONE_CALL`

Update editable metadata for an existing phone call without changing its explicit cancellation or start/end status fields. Provide at least one editable field in addition to call_id.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `title` | string | No | Replacement call title. |
| `domain` | string | No | Replacement domain associated with the call. |
| `call_at` | string | No | Replacement scheduled call time in ISO 8601 format. |
| `call_id` | integer | Yes | Callback24 ID of the phone call to update. |
| `referer` | string | No | Replacement referrer information. |
| `user_id` | integer | No | ID of the user who handled the call. |
| `website` | string | No | Website from which the call originated. |
| `comments` | string | No | Replacement comments for the call. |
| `call_from` | string | No | Replacement source label for the call. |
| `service_id` | integer | No | Replacement service ID. |
| `contact_name` | string | No | Replacement contact name. |
| `message_text` | string | No | Replacement message text. |
| `phone_number` | string | No | Replacement phone number. |
| `referer_from` | string | No | Replacement referrer origin. |
| `child_call_id` | integer | No | Replacement child call ID. |
| `message_email` | string | No | Replacement email associated with the call message. |
| `parent_call_id` | integer | No | Replacement parent call ID. |
| `referer_domain` | string | No | Replacement referrer domain. |
| `attempt_counter` | integer | No | Replacement number of call attempts. |
| `lead_ref_number` | string | No | Replacement lead reference number. |
| `assigned_team_id` | integer | No | ID of the team assigned to the call. |
| `assigned_user_id` | integer | No | ID of the user assigned to the call. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | 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 Phone Call Status

**Slug:** `CALLBACK24_UPDATE_PHONE_CALL_STATUS`

Set a phone call's cancelled flag and/or recorded start and end times; this changes operational call state. Provide at least one of cancelled, call_start_time, or call_end_time.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `call_id` | integer | Yes | Callback24 ID of the phone call whose status is changing. |
| `cancelled` | boolean | No | Whether the phone call is cancelled. |
| `call_end_time` | string | No | Recorded call end time in ISO 8601 format. |
| `call_start_time` | string | No | Recorded call start time in ISO 8601 format. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | 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 Service

**Slug:** `CALLBACK24_UPDATE_SERVICE`

Change the website configured for an existing Callback24 service.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `website` | string | Yes | Replacement website URL or domain for the service. |
| `service_id` | integer | Yes | Callback24 ID of the service to update. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | 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 User

**Slug:** `CALLBACK24_UPDATE_USER`

Update one or more profile or role fields for an existing Callback24 company user. Provide at least one of first_name, last_name, email, phone_number, or role.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `role` | string | No | Replacement Callback24 role. The API does not publish a complete role list. |
| `email` | string | No | Replacement email address. |
| `user_id` | integer | Yes | Callback24 ID of the user to update. |
| `last_name` | string | No | Replacement last name. |
| `first_name` | string | No | Replacement first name. |
| `phone_number` | string | No | Replacement phone number. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | 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 |