> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Callback24

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

![Callback24 logo](https://mintcdn.com/composio-preview/PudKL42NVsy5O-ND/images/toolkits/callback24.svg?fit=max\&auto=format\&n=PudKL42NVsy5O-ND\&q=85\&s=9ba3d6be33390e748cbcfee0c650dd22)

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

## Tools

> [accordion] Assign User to Service
>
> **Slug:** `CALLBACK24_ASSIGN_USER_TO_SERVICE`
>
> Assign a Callback24 user to a service, optionally within a routing group.
>
> #### Input Parameters
>
> **user\_id** `integer` *required*
>
> Callback24 ID of the user to assign to the service.
>
> **group\_id** `integer`
>
> Optional Callback24 routing group ID for the assignment.
>
> **service\_id** `integer` *required*
>
> Callback24 ID of the service to which the user will be assigned.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **group\_id** `integer`
>
> Optional Callback24 routing group ID for every assignment.
>
> **user\_ids** `array` *required*
>
> One to 25 unique positive Callback24 user IDs to assign in order.
>
> **service\_id** `integer` *required*
>
> Callback24 ID of the service to which users will be assigned.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **group\_id** `integer`
>
> Optional Callback24 routing group ID for every removal.
>
> **user\_ids** `array` *required*
>
> Callback24 IDs of 1-25 unique users to remove, in processing order.
>
> **service\_id** `integer` *required*
>
> Callback24 ID of the service from which users will be removed.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Cancel Upcoming Phone Calls
>
> **Slug:** `CALLBACK24_CANCEL_UPCOMING_PHONE_CALLS`
>
> Bulk-cancel upcoming phone calls matching a phone number or lead reference, optionally narrowed by earliest scheduled time and service. Cancellation is irreversible and may be partial even when an error is reported; the reason is appended to cancelled calls' comments and defaults to 'Canceled by API, no reason'.
>
> #### Input Parameters
>
> **reason** `string`
>
> Reason permanently appended to every matching call's comments. Defaults to 'Canceled by API, no reason'.
>
> **service\_id** `integer`
>
> Limit the irreversible bulk cancellation to this Callback24 service ID.
>
> **phone\_number** `string`
>
> Phone number selecting upcoming calls to irreversibly cancel. Required when lead\_ref\_number is omitted.
>
> **starting\_from** `string`
>
> Cancel only calls scheduled at or after this ISO 8601 datetime. Callback24 defaults to the current time when omitted.
>
> **lead\_ref\_number** `string`
>
> Lead reference selecting upcoming calls to irreversibly cancel. Required when phone\_number is omitted.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Group
>
> **Slug:** `CALLBACK24_CREATE_GROUP`
>
> Create a routing group within a Callback24 service, with optional localized names.
>
> #### Input Parameters
>
> **service\_id** `integer` *required*
>
> Callback24 service ID that will own the new group.
>
> **german\_name** `string`
>
> German display name for the group.
>
> **polish\_name** `string`
>
> Polish display name for the group.
>
> **english\_name** `string`
>
> English display name for the group.
>
> **russian\_name** `string`
>
> Russian display name for the group.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **type** `integer ("1" | "2" | "3" | "4")`
>
> Call type: 1 for callback, 2 for incoming, 3 for outgoing, or 4 for form.
>
> **title** `string`
>
> Title of the phone call.
>
> **domain** `string`
>
> Domain of the page where the call was requested.
>
> **call\_at** `string`
>
> ISO 8601 time at which to place the call. Callback24 uses the current time when omitted.
>
> **referer** `string`
>
> URL of the page where the call was requested, without a path.
>
> **website** `string` *required*
>
> Website from which the call originated.
>
> **comments** `string`
>
> Comment associated with the call.
>
> **call\_from** `string ("API" | "RESCHEDULED" | "WIDGET" | "POPUP" | "EXIT_POPUP" | "FORM" | "IMPORT")`
>
> Source of the call, such as API, RESCHEDULED, WIDGET, POPUP, EXIT\_POPUP, FORM, or IMPORT.
>
> **service\_id** `integer` *required*
>
> ID of the Callback24 service placing the call.
>
> **contact\_name** `string`
>
> Name of the contact who owns the phone number.
>
> **phone\_number** `string` *required*
>
> Phone number of the call recipient.
>
> **referer\_from** `string`
>
> Previously visited website that referred the caller.
>
> **referer\_domain** `string`
>
> Domain of the previously visited referring website.
>
> **lead\_ref\_number** `string`
>
> Lead reference number associated with the call.
>
> **assigned\_team\_id** `integer`
>
> ID of the team assigned to the call.
>
> **assigned\_user\_id** `integer`
>
> ID of the user assigned to the call.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Service
>
> **Slug:** `CALLBACK24_CREATE_SERVICE`
>
> Create a Callback24 service for a website. This can create customer-visible widget or routing configuration.
>
> #### Input Parameters
>
> **website** `string` *required*
>
> Website URL or domain for the new Callback24 service.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **role** `string`
>
> Callback24 role for the new user. The provider documents 'employee' as an example but does not publish the complete allowed set.
>
> **email** `string` *required*
>
> Email address for the new Callback24 user.
>
> **last\_name** `string`
>
> New user's last name.
>
> **first\_name** `string`
>
> New user's first name.
>
> **phone\_number** `string`
>
> New user's phone number.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Group
>
> **Slug:** `CALLBACK24_DELETE_GROUP`
>
> Permanently and irreversibly delete one Callback24 routing group by group ID. This deletion cannot be undone.
>
> #### Input Parameters
>
> **group\_id** `integer` *required*
>
> Callback24 ID of the routing group to permanently and irreversibly delete. This deletion cannot be undone.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **service\_id** `integer` *required*
>
> Callback24 ID of the service to permanently and irreversibly delete, including its associated routing and widget configuration.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete User
>
> **Slug:** `CALLBACK24_DELETE_USER`
>
> Permanently and irreversibly delete one company user by Callback24 user ID. This operation cannot be undone.
>
> #### Input Parameters
>
> **user\_id** `integer` *required*
>
> Callback24 ID of the company user to permanently and irreversibly delete. This cannot be undone.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Current User
>
> **Slug:** `CALLBACK24_GET_CURRENT_USER`
>
> Return the Callback24 user identity associated with the connected API token.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Group
>
> **Slug:** `CALLBACK24_GET_GROUP`
>
> Return one Callback24 routing group by ID with its service ID and localized names.
>
> #### Input Parameters
>
> **group\_id** `integer` *required*
>
> Callback24 ID of the routing group to retrieve.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Phone Call
>
> **Slug:** `CALLBACK24_GET_PHONE_CALL`
>
> Return detailed metadata, tags, and assigned-user information for one Callback24 phone call.
>
> #### Input Parameters
>
> **call\_id** `integer` *required*
>
> Callback24 ID of the phone call to retrieve.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Phone Call Recording
>
> **Slug:** `CALLBACK24_GET_PHONE_CALL_RECORDING`
>
> Return the recording URL for one recorded phone call.
>
> #### Input Parameters
>
> **call\_id** `integer` *required*
>
> Callback24 ID of the phone call whose recording is needed.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Service
>
> **Slug:** `CALLBACK24_GET_SERVICE`
>
> Return one Callback24 service with opening hours, routing groups, and assigned users.
>
> #### Input Parameters
>
> **service\_id** `integer` *required*
>
> Callback24 ID of the service to retrieve.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get User
>
> **Slug:** `CALLBACK24_GET_USER`
>
> Return one company user by Callback24 user ID.
>
> #### Input Parameters
>
> **user\_id** `integer` *required*
>
> Callback24 ID of the user to retrieve.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Groups
>
> **Slug:** `CALLBACK24_LIST_GROUPS`
>
> Return all Callback24 routing groups with their service IDs and localized names.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **page** `integer`
>
> Page of results to return.
>
> **limit** `integer`
>
> Maximum calls requested for this page. Callback24 documents no upper bound.
>
> **offset** `integer`
>
> Number of matching calls to skip for manual pagination.
>
> **date\_to** `string`
>
> Return calls on or before this ISO 8601 datetime.
>
> **user\_ids** `array`
>
> Return calls associated with any of these Callback24 user IDs.
>
> **call\_type** `string ("CALLBACK" | "INCOMING" | "OUTGOING")`
>
> Return only calls of this documented type.
>
> **date\_from** `string`
>
> Return calls on or after this ISO 8601 datetime.
>
> **service\_ids** `array`
>
> Return calls associated with any of these Callback24 service IDs.
>
> **phone\_number** `string`
>
> Return calls for this phone number.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Services
>
> **Slug:** `CALLBACK24_LIST_SERVICES`
>
> Return all Callback24 services with their nested groups, assigned users, and opening hours.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Users
>
> **Slug:** `CALLBACK24_LIST_USERS`
>
> Return all company users visible to the connected Callback24 account.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **user\_id** `integer` *required*
>
> Callback24 ID of the user to remove from the service.
>
> **group\_id** `integer`
>
> Optional Callback24 routing group ID for the assignment being removed.
>
> **service\_id** `integer` *required*
>
> Callback24 ID of the service from which the user will be removed.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Group
>
> **Slug:** `CALLBACK24_UPDATE_GROUP`
>
> Update one or more localized names for a Callback24 routing group.
>
> #### Input Parameters
>
> **group\_id** `integer` *required*
>
> Callback24 ID of the routing group to update.
>
> **german\_name** `string`
>
> Replacement German display name.
>
> **polish\_name** `string`
>
> Replacement Polish display name.
>
> **english\_name** `string`
>
> Replacement English display name.
>
> **russian\_name** `string`
>
> Replacement Russian display name.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **title** `string`
>
> Replacement call title.
>
> **domain** `string`
>
> Replacement domain associated with the call.
>
> **call\_at** `string`
>
> Replacement scheduled call time in ISO 8601 format.
>
> **call\_id** `integer` *required*
>
> Callback24 ID of the phone call to update.
>
> **referer** `string`
>
> Replacement referrer information.
>
> **user\_id** `integer`
>
> ID of the user who handled the call.
>
> **website** `string`
>
> Website from which the call originated.
>
> **comments** `string`
>
> Replacement comments for the call.
>
> **call\_from** `string`
>
> Replacement source label for the call.
>
> **service\_id** `integer`
>
> Replacement service ID.
>
> **contact\_name** `string`
>
> Replacement contact name.
>
> **message\_text** `string`
>
> Replacement message text.
>
> **phone\_number** `string`
>
> Replacement phone number.
>
> **referer\_from** `string`
>
> Replacement referrer origin.
>
> **child\_call\_id** `integer`
>
> Replacement child call ID.
>
> **message\_email** `string`
>
> Replacement email associated with the call message.
>
> **parent\_call\_id** `integer`
>
> Replacement parent call ID.
>
> **referer\_domain** `string`
>
> Replacement referrer domain.
>
> **attempt\_counter** `integer`
>
> Replacement number of call attempts.
>
> **lead\_ref\_number** `string`
>
> Replacement lead reference number.
>
> **assigned\_team\_id** `integer`
>
> ID of the team assigned to the call.
>
> **assigned\_user\_id** `integer`
>
> ID of the user assigned to the call.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **call\_id** `integer` *required*
>
> Callback24 ID of the phone call whose status is changing.
>
> **cancelled** `boolean`
>
> Whether the phone call is cancelled.
>
> **call\_end\_time** `string`
>
> Recorded call end time in ISO 8601 format.
>
> **call\_start\_time** `string`
>
> Recorded call start time in ISO 8601 format.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Service
>
> **Slug:** `CALLBACK24_UPDATE_SERVICE`
>
> Change the website configured for an existing Callback24 service.
>
> #### Input Parameters
>
> **website** `string` *required*
>
> Replacement website URL or domain for the service.
>
> **service\_id** `integer` *required*
>
> Callback24 ID of the service to update.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **role** `string`
>
> Replacement Callback24 role. The API does not publish a complete role list.
>
> **email** `string`
>
> Replacement email address.
>
> **user\_id** `integer` *required*
>
> Callback24 ID of the user to update.
>
> **last\_name** `string`
>
> Replacement last name.
>
> **first\_name** `string`
>
> Replacement first name.
>
> **phone\_number** `string`
>
> Replacement phone number.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
