JustCall

Usage Instructions

Integrate the JustCall cloud phone and SMS dialer into the workflow. List and review calls, set call notes and dispositions, read JustCall AI summaries, send and read SMS, create, update, and search contacts, and list users and phone numbers. Can also run workflows on JustCall call, SMS, and contact events. Requires a JustCall API key and secret (Team plan or higher).

Actions

JustCall List Calls

List JustCall calls, filtered by agent, direction, outcome, traits, disposition, contact number, JustCall number, or a date range.

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	JustCall API key, from Profile > APIs and Webhooks
`apiSecret`	string	Yes	JustCall API secret, from Profile > APIs and Webhooks
`agentId`	string	No	Only calls of this agent (user) ID
`callDirection`	string	No	Incoming or Outgoing
`callType`	string	No	Call outcome: OUTGOING_ANSWERED, OUTGOING_UNANSWERED, OUTGOING_BUSY, OUTGOING_FAILED, OUTGOING_RESTRICTED, OUTGOING_BLOCKED, OUTGOING_CANCELLED, INCOMING_ANSWERED, INCOMING_BUSY, INCOMING_FAILED, INCOMING_MISSED, INCOMING_ABANDONED, INCOMING_VOICEMAIL
`callTraits`	string	No	Comma-separated traits: QUEUE, CALLBACK, FORWARD, TRANSFER, MERGE, IVR, VOICE_AGENT
`dispositionCodes`	string	No	Comma-separated disposition codes in "List: Code" form, e.g. "Sales: Lead"
`contactNumber`	string	No	Contact number with country code
`justcallNumber`	string	No	JustCall number the calls went through
`fromDatetime`	string	No	Start, as yyyy-mm-dd or yyyy-mm-dd hh:mm:ss in the user's timezone
`toDatetime`	string	No	End, as yyyy-mm-dd or yyyy-mm-dd hh:mm:ss in the user's timezone
`fetchAiData`	boolean	No	Include JustCall AI coaching data
`fetchQueueData`	boolean	No	Include queue callback data
`sort`	string	No	Sort by "id" (default) or "datetime"
`order`	string	No	"desc" (default) or "asc"
`page`	number	No	Page number
`perPage`	number	No	Calls per page, 1 to 100 (default 20)
`lastCallIdFetched`	string	No	ID of the last call of the previous page, to avoid duplicates

Output

Parameter	Type	Description
`calls`	array	Calls in this page

JustCall Get Call

Get a JustCall call by ID or call SID: direction, outcome, duration, contact, agent, recording, notes, and disposition.

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	JustCall API key, from Profile > APIs and Webhooks
`apiSecret`	string	Yes	JustCall API secret, from Profile > APIs and Webhooks
`callId`	string	Yes	JustCall call ID (numeric) or call SID
`fetchAiData`	boolean	No	Include JustCall AI coaching data
`fetchQueueData`	boolean	No	Include queue callback data

Output

Parameter	Type	Description
`call`	object	The call

JustCall Update Call

Set the notes, disposition, or rating of a completed JustCall call. New notes replace the existing notes.

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	JustCall API key, from Profile > APIs and Webhooks
`apiSecret`	string	Yes	JustCall API secret, from Profile > APIs and Webhooks
`callId`	string	Yes	JustCall call ID (numeric) or call SID
`notes`	string	No	Call notes. Replaces any existing notes.
`dispositionCode`	string	No	Existing disposition code in "List: Code" form, e.g. "Sales: Follow Up" for the Follow Up code of the Sales list
`rating`	number	No	Rating from 0 to 5 in steps of 0.5

Output

Parameter	Type	Description
`call`	object	The updated call

JustCall Get Call AI Insights

Get the JustCall AI analysis of a call: summary, action items, customer sentiment, call score, smart chapters, and optionally the transcript. Requires JustCall AI.

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	JustCall API key, from Profile > APIs and Webhooks
`apiSecret`	string	Yes	JustCall API secret, from Profile > APIs and Webhooks
`callId`	string	Yes	Numeric JustCall call ID
`platform`	string	No	"justcall" (default) or "sales_dialer"
`fetchTranscription`	boolean	No	Include the transcript (off by default)
`fetchSummary`	boolean	No	Include the summary (on by default)
`fetchActionItems`	boolean	No	Include action items (on by default)
`fetchAiInsights`	boolean	No	Include coaching insights (on by default)
`fetchSmartChapters`	boolean	No	Include smart chapters (on by default)

Output

Parameter	Type	Description
`insights`	object	JustCall AI analysis of the call

JustCall Send SMS

Send an SMS or MMS from a JustCall number to a contact, now or at a scheduled time.

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	JustCall API key, from Profile > APIs and Webhooks
`apiSecret`	string	Yes	JustCall API secret, from Profile > APIs and Webhooks
`justcallNumber`	string	Yes	JustCall number to send from, in E.164 format (e.g. +14155550100)
`contactNumber`	string	Yes	Recipient number in E.164 format
`body`	string	Yes	Message text, up to 1600 characters
`mediaUrl`	string	No	Comma-separated public media URLs to send as MMS (up to 10)
`restrictOnce`	boolean	No	Skip the send if this recipient already got an SMS in the last 24 hours
`scheduleAt`	string	No	Send later, as YYYY-MM-DD HH:mm:ss

Output

Parameter	Type	Description
`sms`	object	The sent message

JustCall List SMS

List JustCall SMS messages, filtered by contact number, JustCall number, direction, content, or a date range.

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	JustCall API key, from Profile > APIs and Webhooks
`apiSecret`	string	Yes	JustCall API secret, from Profile > APIs and Webhooks
`contactNumber`	string	No	Contact number in E.164 format
`justcallNumber`	string	No	JustCall number in E.164 format
`smsDirection`	string	No	incoming or outgoing
`smsContent`	string	No	Keywords the message text contains
`fromDatetime`	string	No	Start, as yyyy-mm-dd or yyyy-mm-dd hh:mm:ss in the user's timezone
`toDatetime`	string	No	End, as yyyy-mm-dd or yyyy-mm-dd hh:mm:ss in the user's timezone
`sort`	string	No	Sort by "id" (default) or "datetime"
`order`	string	No	"asc" or "desc"
`page`	number	No	Page number
`perPage`	number	No	Messages per page, 1 to 100 (default 20)
`lastSmsIdFetched`	string	No	ID of the last message of the previous page, to avoid duplicates

Output

Parameter	Type	Description
`messages`	array	Messages in this page

JustCall Get SMS

Get a JustCall SMS by ID: text, direction, contact, agent, and delivery status.

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	JustCall API key, from Profile > APIs and Webhooks
`apiSecret`	string	Yes	JustCall API secret, from Profile > APIs and Webhooks
`smsId`	string	Yes	JustCall SMS ID

Output

Parameter	Type	Description
`sms`	object	The message

JustCall Create Contact

Add a contact to JustCall with a name, phone number, and optional email, company, address, notes, and other numbers.

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	JustCall API key, from Profile > APIs and Webhooks
`apiSecret`	string	Yes	JustCall API secret, from Profile > APIs and Webhooks
`firstName`	string	Yes	First name
`contactNumber`	string	Yes	Primary phone number with country code
`lastName`	string	No	Last name
`email`	string	No	Email address
`company`	string	No	Company
`address`	string	No	Address
`extension`	number	No	Extension to assign to the contact
`otherNumbers`	string	No	Other phone numbers: comma-separated (labeled Mobile), or a JSON array of {"label", "number"} objects
`acrossTeam`	boolean	No	Apply to the contact of every agent instead of only the account owner
`notes`	string	No	Notes about the contact
`agentId`	string	No	Create the contact only for this agent ID

Output

Parameter	Type	Description
`contact`	object	The created contact

JustCall Update Contact

Update a JustCall contact found by ID or phone number: name, email, company, address, notes, and other numbers. With an ID, a phone number replaces the contact's primary number.

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	JustCall API key, from Profile > APIs and Webhooks
`apiSecret`	string	Yes	JustCall API secret, from Profile > APIs and Webhooks
`contactId`	string	No	JustCall contact ID. Leave empty to find the contact by phone number.
`contactNumber`	string	No	Phone number. Without a contact ID it finds the contact; with one it becomes the new primary number.
`firstName`	string	No	First name
`lastName`	string	No	Last name
`email`	string	No	Email address
`company`	string	No	Company
`address`	string	No	Address
`extension`	number	No	Extension to assign to the contact
`otherNumbers`	string	No	Other phone numbers: comma-separated (labeled Mobile), or a JSON array of {"label", "number"} objects
`acrossTeam`	boolean	No	Apply to the contact of every agent instead of only the account owner
`notes`	string	No	A note to add, or a JSON array of notes

Output

Parameter	Type	Description
`contact`	object	The updated contact

JustCall Get Contact

Get a JustCall contact by ID: name, numbers, email, company, notes, and DND/DNM/blacklist status.

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	JustCall API key, from Profile > APIs and Webhooks
`apiSecret`	string	Yes	JustCall API secret, from Profile > APIs and Webhooks
`contactId`	string	Yes	JustCall contact ID

Output

Parameter	Type	Description
`contact`	object	The contact

JustCall List Contacts

List or search JustCall contacts by phone number, first or last name, DND/DNM/blacklist status, or agent.

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	JustCall API key, from Profile > APIs and Webhooks
`apiSecret`	string	Yes	JustCall API secret, from Profile > APIs and Webhooks
`contactNumber`	string	No	Phone number to search for
`firstName`	string	No	First name to search for
`lastName`	string	No	Last name to search for
`contactStatus`	string	No	Comma-separated statuses: blacklist, dnd, dnm
`acrossTeam`	boolean	No	Include the contacts of every agent
`agentIds`	string	No	Comma-separated agent IDs whose contacts to list
`order`	string	No	Order by contact ID: "asc" or "desc"
`page`	number	No	Page number, starting at 0
`perPage`	number	No	Contacts per page, 1 to 500 (default 50)
`lastContactIdFetched`	string	No	ID of the last contact of the previous page, to avoid duplicates

Output

Parameter	Type	Description
`contacts`	array	Contacts in this page

JustCall List Users

List JustCall users (agents) with their availability, on-call state, role, and numbers. Filter by email, role, group, or availability.

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	JustCall API key, from Profile > APIs and Webhooks
`apiSecret`	string	Yes	JustCall API secret, from Profile > APIs and Webhooks
`available`	boolean	No	Only users available per their working hours
`email`	string	No	Email of the user
`groupId`	string	No	User group ID
`role`	string	No	Role assigned in JustCall
`order`	string	No	Order by agent ID: "desc" (default) or "asc"
`page`	number	No	Page number, starting at 0
`perPage`	number	No	Users per page, 1 to 100 (default 50)

Output

Parameter	Type	Description
`users`	array	Users in this page

JustCall List Phone Numbers

List the phone numbers in a JustCall account with their line name, type, capabilities, owner, and business hours setting.

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	JustCall API key, from Profile > APIs and Webhooks
`apiSecret`	string	Yes	JustCall API secret, from Profile > APIs and Webhooks
`capabilities`	string	No	Only numbers capable of call, sms, or mms
`numberType`	string	No	local, mobile, or toll_free
`availabilitySetting`	string	No	Always Open, Always Closed, or Custom Hours
`justcallLineName`	string	No	Line name to search for
`numberOwnerId`	string	No	Agent ID that owns the numbers
`sharedAgentId`	string	No	Agent ID the numbers are shared with
`sharedGroupId`	string	No	User group ID the numbers are shared with
`order`	string	No	"ASC" or "DESC"
`page`	number	No	Page number
`perPage`	number	No	Numbers per page, 1 to 100 (default 30)

Output

Parameter	Type	Description
`phoneNumbers`	array	Phone numbers in this page

Triggers

A Trigger is a block that starts a workflow when an event happens in this service.

JustCall Webhook

Trigger a workflow on JustCall calls (completed, answered, missed, voicemail), SMS sent or received, and contact status changes.

JustCall

On this page