Skip to main content
Callingly logo
  • Category: phone & sms
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 29
  • Triggers: 0
  • Slug: CALLINGLY
  • Version: 20261101_00

Tools

Slug: CALLINGLY_ACTIVATE_DEACTIVATE_CLIENTTool to activate or deactivate a client account. Use when you need to toggle client access after onboarding or offboarding. Example: “Activate client 123” or “Deactivate client 456”.

Input Parameters

integer
required
Unique identifier of the client account to modify.
integer ("0" | "1")
required
Set to 1 to activate the client account or 0 to deactivate it.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CALLINGLY_CREATE_AGENTTool to create a new agent. Use when you need to register an agent in Callingly after gathering their account ID and contact details.

Input Parameters

string
Agent’s phone extension if applicable
string
required
Agent’s email address
string
required
Agent’s first name
string
required
Agent’s last name
string
required
Agent’s timezone, IANA format (e.g., ‘America/Phoenix’)
integer
required
Client’s account ID under which the agent will be created
string
required
Agent’s phone number in E.164 format (must include country code with ’+’ prefix, e.g., ‘+14155551234’)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CALLINGLY_CREATE_CALLCreates a new outbound call record and initiates a real outbound call, which incurs cost — ensure explicit user authorization and compliance with applicable consent and telemarketing regulations before use. The call will be routed to available agents on the specified team based on account-level routing configuration. Use List Teams first to get valid account_id and team_id values. Returns a call_id that can be used with Get Call to retrieve call status, recordings, and other details.

Input Parameters

string
required
Lead’s email address
integer
External CRM identifier for the lead, used for syncing with your CRM system
string
Source where the lead originated from (e.g., ‘HubSpot’, ‘Website’, ‘Referral’)
string
Lead’s company name
integer
required
ID of the team that will handle the call. Retrieve available team IDs using the List Teams endpoint. Must belong to the specified account_id — a mismatch will prevent proper call routing.
string
Category to classify the call (e.g., ‘Sales’, ‘Support’, ‘Pools’)
string
required
Lead’s last name
integer
required
Your Callingly account ID. Retrieve this using the List Teams endpoint (account_id is returned in each team object).
string
required
Lead’s first name
string
required
Lead’s phone number in E.164 format (e.g., +15555555555 for US, +442071234567 for UK)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CALLINGLY_CREATE_CLIENTCreates a new client account in Callingly. Clients are sub-accounts under your agency account that can have their own teams, agents, and billing. Use this when onboarding a new business customer to your Callingly agency.

Input Parameters

string
required
Client’s email address.
string
required
Client’s first name.
string
required
Client’s last name.
string
required
Client’s company name.
string
required
Password for the client’s account.
string
required
Client’s phone number in E.164 format (e.g., +14155551234). Must be a valid phone number with a real area code.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CALLINGLY_CREATE_TEAMTool to create a new team. Use when setting up a team configuration before adding agents.

Input Parameters

string
required
Name of the team.
integer
Delay in seconds before dialing team members.
integer
Number of retry attempts per agent.
integer ("0" | "1")
Enable per-agent retries: 1 to enable, 0 to disable.
string
Language code for team messages (e.g., ‘en’).
string
Call distribution mode. Only ‘simultaneous’ supported currently.
integer ("0" | "1")
Whether calls should be recorded: 1 to record, 0 otherwise.
integer
required
Account ID under which to create the team.
string
Pre-call whisper message template.
integer
Number of retries at the lead level.
integer ("0" | "1")
Enable rescheduling on no-answer: 1 to enable, 0 to disable.
integer ("0" | "1")
Enable lead-level retries: 1 to enable, 0 to disable.
array
Schedule for per-agent retries in minutes.
array
Schedule for lead-level retries in minutes.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CALLINGLY_CREATE_WEBHOOKTool to create a new webhook for call or lead events. Use when you need to receive real-time notifications on specific events. Example: “Create a webhook for call_completed events to http://example.com/callback”.

Input Parameters

string
required
A descriptive name for the webhook.
string ("call_completed" | "lead_created" | "lead_updated")
required
Event that triggers this webhook.
string ("lead_owner" | "result" | "stage" | "status" | "tags")
For lead_created or lead_updated events only: field to watch for changes.
string
For lead_created or lead_updated events only: value the watched field must match.
integer
For call_completed events only when direction is outbound: the team ID to filter on.
string ("outbound" | "inbound")
For call_completed events only: whether to trigger on outbound or inbound calls.
integer
For call_completed events only when direction is inbound: the number ID to filter on.
string
required
The callback URL to receive the webhook.
string ("completed" | "missed" | "offline")
For call_completed events only: status filter.
string ("contacted" | "missed" | "removed" | "voicemail")
For call_completed events only: lead outcome filter.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CALLINGLY_DELETE_AGENTPermanently delete an agent from a Callingly account. Use when removing an agent who should no longer receive calls. Requires both the agent ID and the account ID the agent belongs to.

Input Parameters

integer
required
Unique identifier of the agent to delete.
integer
required
The client account ID that the agent belongs to. Required to identify which account’s agent to delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CALLINGLY_DELETE_CLIENTTool to delete a client. Use when you need to remove an existing client from your account after confirming its ID.

Input Parameters

integer
required
Positive integer ID of the client to delete

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CALLINGLY_DELETE_LEADDeletes a lead by ID. Returns a synthesized success confirmation when the HTTP request succeeds.

Input Parameters

integer
required
Positive integer ID of the lead to delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CALLINGLY_DELETE_WEBHOOKTool to delete a webhook. Use when permanently removing a webhook by its ID.

Input Parameters

integer
required
Unique identifier of the webhook to delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CALLINGLY_GET_AGENT_SCHEDULETool to retrieve the availability schedule for a specific agent. Use when you need to know which days and times the agent is available.

Input Parameters

integer
required
Unique identifier of the agent. Obtain this from the List Users action.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CALLINGLY_GET_CALLRetrieves detailed information about a specific call by its unique ID. Returns comprehensive call metadata including status, duration, lead information, agent details, recording URLs, transcripts, and AI-generated insights. Use the LIST_CALLS action first to obtain valid call IDs.

Input Parameters

integer
required
The unique numeric identifier of the call to retrieve. Obtain this from the LIST_CALLS action response.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CALLINGLY_GET_LEADTool to retrieve details of a specific lead by its ID. Use when you need full lead details before follow-up actions.

Input Parameters

integer
required
Positive integer ID of the lead to retrieve.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CALLINGLY_GET_TEAMRetrieve a Callingly team by ID to inspect its configuration, including call distribution, recording, and retry settings.

Input Parameters

integer
required
Unique identifier of the team to retrieve

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CALLINGLY_GET_WEBHOOKTool to retrieve details of a specific webhook by its ID. Use when you need to inspect a webhook’s configuration before modifying or deleting it.

Input Parameters

integer
required
Unique identifier of the webhook to retrieve.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CALLINGLY_LIST_CALLSTool to list calls. Use when you need to retrieve multiple call records with optional filters such as date range, team, and pagination after identifying the need for a collection of calls.

Input Parameters

string
End date for filtering calls (YYYY-MM-DD).
integer
Page number for pagination.
integer
Number of records per page.
string
Start date for filtering calls (YYYY-MM-DD).
integer
Filter calls by team ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CALLINGLY_LIST_CLIENTSList clients associated with the Callingly account, including their identifying and billing details.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CALLINGLY_LIST_LEADSTool to list leads based on provided filters like date range or phone number. Use after confirming filter criteria when bulk lead retrieval is needed.

Input Parameters

string
Date (YYYY-MM-DD) to filter leads created on or before this date
integer
Page number for pagination.
integer
Number of records per page.
string
Date (YYYY-MM-DD) to filter leads created on or after this date
integer
Account ID for agency partner context
string
Phone number to filter leads by, e.g., ‘+14801234567’

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CALLINGLY_LIST_TEAMSTool to list teams. Use when you need to retrieve all teams associated with your account.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CALLINGLY_LIST_TEAM_USERSRetrieve all agents assigned to a specific team in Callingly. Returns each agent’s ID, name, priority, call cap, and any custom/integration identifiers. Use this to audit team composition or before performing agent management operations like updates or removals.

Input Parameters

integer
required
The unique numeric ID of the team. Use the List Teams action to retrieve available team IDs.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CALLINGLY_LIST_USERSTool to retrieve a list of agents. Use when you need to see all agents available under the authenticated account, optionally filtering by a specific client account.

Input Parameters

integer
Filter users by client account ID (required for agency partners)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CALLINGLY_LIST_WEBHOOKSTool to list configured webhooks. Use when you need to retrieve all webhooks configured in your account to review or manage them.

Input Parameters

integer
Filter webhooks by client account ID (required for agency partners)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CALLINGLY_REMOVE_TEAM_AGENTTool to remove a specific agent from a team. Use when you need to disassociate an agent from a team after confirming both team and agent IDs.

Input Parameters

integer
required
Unique identifier of the team to remove the agent from.
integer
required
Unique identifier of the agent to remove from the team.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CALLINGLY_UPDATE_AGENTTool to update an existing agent’s details. Use when you need to modify agent information post-creation.

Input Parameters

integer
required
Unique identifier of the agent to update
string
Agent’s phone extension if applicable
string
Agent’s first name
string
Agent’s last name
string
Agent’s timezone, IANA format (e.g., ‘America/Phoenix’)
integer
Client’s account ID under which the agent exists
integer
Do-not-disturb flag: 1 to enable, 0 to disable
string
Agent’s phone number, in E.164 or local format
string
Datetime until which do-not-disturb is active, required if donotdisturb=1

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CALLINGLY_UPDATE_LEADTool to update an existing lead’s information. Use when you need to modify lead contact details, status, or blocking settings.

Input Parameters

integer
required
Unique identifier of the lead to update
string
Email address of the lead
string
First name of the lead
string
Last name of the lead
string
Current stage in the pipeline
string
Outcome/result after call or follow-up
string
Origin/source of the lead (e.g., ‘HubSpot’, ‘Web Form’)
string
Current status of the lead (e.g., ‘new’, ‘contacted’, ‘qualified’)
string
Company name associated with the lead
integer
Flag to block the lead: 1 to block, 0 to unblock
integer
Flag to stop automated calls: 1 to enable, 0 to disable
string
Phone number of the lead in E.164 format (e.g., ‘+14155551234’)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CALLINGLY_UPDATE_SCHEDULETool to update an agent’s availability schedule. Use when you need to set or override an agent’s daily availability times.

Input Parameters

integer
required
Unique identifier of the agent whose schedule is being updated. Get agent IDs from the List Users action.
array
required
Array of DaySchedule objects defining the agent’s weekly availability. Can include all 7 days (Sunday=0 through Saturday=6) or just specific days to update. Each day requires label, day number, is_available flag, and times array.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CALLINGLY_UPDATE_TEAM_AGENT_SETTINGSUpdate a specific team agent’s priority and call capacity. Priority is required, and an omitted capacity is sent as null.

Input Parameters

integer
Maximum number of calls the agent can receive. Use null or omit for unlimited capacity.
integer
required
Unique identifier of the team containing the agent.
integer
required
Unique identifier of the agent whose settings to update.
integer
required
Calling priority of the agent within the team (1 = highest priority, called first).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CALLINGLY_UPDATE_TEAM_USERSUpdates the list of agents assigned to a team. This operation replaces all existing agent assignments - any agents not included in the list will be removed from the team. Use CALLINGLY_LIST_TEAM_USERS to check current assignments before updating.

Input Parameters

integer
required
The unique identifier of the team to update. Use CALLINGLY_LIST_TEAMS to find team IDs.
array
required
List of agent IDs to assign to the team. This replaces all current agents. Use CALLINGLY_LIST_USERS to find agent IDs. Pass an empty list to remove all agents.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CALLINGLY_UPDATE_WEBHOOKUpdates an existing webhook’s configuration by ID. Supports partial updates - only provide fields you want to change. Note: When updating event-specific fields (call_status, call_lead_status, field, filter), you must also include the event field in your request.

Input Parameters

integer
required
The unique identifier of the webhook to update. Required.
string
New descriptive name for the webhook.
string ("call_completed" | "lead_created" | "lead_updated")
Event type that triggers the webhook. Must be included when updating event-specific fields like call_status or field/filter.
string ("lead_owner" | "result" | "stage" | "status" | "tags")
For lead_created/lead_updated events: the lead field to watch for changes. Requires event=‘lead_created’ or ‘lead_updated’.
string
For lead_created/lead_updated events: the value the watched field must match. Requires event=‘lead_created’ or ‘lead_updated’.
integer
For outbound call_completed events: filter by team ID. Requires call_direction=‘outbound’.
integer
For inbound call_completed events: filter by number ID. Requires call_direction=‘inbound’.
string
New callback URL to receive webhook payloads.
string ("completed" | "missed" | "offline")
For call_completed events: filter by call status. Requires event=‘call_completed’.
string ("outbound" | "inbound")
For call_completed events: filter by call direction. Requires event=‘call_completed’.
string ("contacted" | "missed" | "removed" | "voicemail")
For call_completed events: filter by lead outcome. Requires event=‘call_completed’.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not