JustCall
App · 25 actions
Work with JustCall, the cloud phone system for sales and support teams: send and track texts, look up calls with their notes, recordings and AI summaries, keep contacts up to date, and feed Sales Dialer campaigns. Start a workflow when a call ends or is missed, a voicemail or text comes in, or JustCall AI finishes a call report.
Actions
| Action | What it does |
|---|---|
| Add contact to campaign | Add a phone number to a Sales Dialer campaign, so the dialer calls it. |
| Check for text reply | See whether a contact has texted back, and get the newest text they sent. |
| Create contact | Add a contact to JustCall, so calls and texts with them show their name. |
| Create text tag | Make a tag for labelling text conversations, such as Follow up. |
| Delete contact | Delete a contact from JustCall. |
| Delete text tag | Delete a text tag. |
| Get call | Get one call: who it was with, direction, outcome, duration, notes, disposition, rating, recording link and voicemail text. |
| Get call AI report | Get JustCall AI's report on a call: summary, action items, score, customer sentiment, key moments and, if you ask, the transcript. |
| Get contact | Get a contact's details, numbers and notes, and whether they are blocked or on Do Not Disturb. |
| Get text | Get one text: what it says, who it was with, and whether it was delivered. |
| Get user | Get one JustCall user: role, extension, numbers, groups, and whether they are available or on a call now. |
| List calls | List calls on your JustCall account, newest first: by day, direction, outcome (such as missed or voicemail), JustCall number, contact or user. |
| List campaigns | List your Sales Dialer campaigns, with their type and whether they are finished. |
| List contacts | List contacts in JustCall, newest first, or find them by phone number or name. |
| List phone numbers | List your JustCall phone numbers, with their line names, owners and whether each can call, text and send pictures. |
| List Sales Dialer calls | List calls made by Sales Dialer, newest first: by campaign, user or day, with who picked up, the outcome, notes and recording. |
| List texts | List texts sent and received on your JustCall account, newest first: by day, sent or received, JustCall number, contact or words in them. |
| List users | List the people on your JustCall account, with their role, extension, numbers and whether they are available or on a call. |
| Remove contact from campaign | Take a phone number off a Sales Dialer campaign, so the dialer stops calling it. |
| Send text | Send a text (SMS) from one of your JustCall numbers, with pictures or files if you add links to them (sent as MMS). |
| Set user availability | Mark a JustCall user available to take calls, or unavailable with a reason, such as at the end of a shift. |
| Tag text conversation | Put a tag on a text conversation: the one between your JustCall number and a contact, every conversation with a contact, or one thread by its ID. |
| Untag text conversation | Take a tag off a text conversation, chosen the same way as for tagging. |
| Update call | Set a finished call's notes, disposition or rating. |
| Update contact | Change a contact's details, or add a note to them. |
Add contact to campaign
Add a phone number to a Sales Dialer campaign, so the dialer calls it. A number already in Sales Dialer is reused.
Inputs
- Campaign
campaigntextRequired - The Sales Dialer campaign.
- Phone number
phone_numbertextRequired - The number to call, with its country code, like +14155550123.
- Name
nametext - The contact's name.
- Email
emailtext - The contact's email address.
Outputs
campaign_idtext- The campaign
contactobject- The contact in Sales Dialer
Example output
{
"campaign_id": "2024301",
"contact": {
"email": "robert.williams@example.com",
"id": "15162",
"name": "Robert Williams",
"phone_number": "+16813810000",
"status": "Active"
}
}Check for text reply
See whether a contact has texted back, and get the newest text they sent. 'Replied' is false when they haven't.
Inputs
- Contact's number
contact_numbertextRequired - Their phone number, with its country code, like +14155550123.
- JustCall number
justcall_numbertext - Only replies to this number of yours. Leave blank for any.
Outputs
repliedtrue/false- Whether they have texted in
textobject- The text
Example output
{
"replied": true,
"text": {
"agent_email": "john.smith@example.com",
"agent_id": "271556",
"agent_name": "John Smith",
"body": "Hi Robert, your demo is booked for 3pm tomorrow.",
"contact_email": "robert.williams@example.com",
"contact_name": "Robert Williams",
"contact_number": "+16813810000",
"cost": 0.05635,
"delivery_status": "delivered",
"direction": "Incoming",
"id": "123455678",
"is_mms": false,
"justcall_line_name": "Sales Line",
"justcall_number": "+12135660000",
"media_urls": [],
"medium": "One-To-One via API",
"sms_date": "2026-11-02",
"sms_time": "09:30:58",
"sms_user_date": "2026-11-02",
"sms_user_time": "04:30:58"
}
}Create contact
Add a contact to JustCall, so calls and texts with them show their name.
Inputs
- First name
first_nametextRequired - The contact's first name.
- Phone number
contact_numbertextRequired - Their phone number, with its country code, like +14155550123.
- Last name
last_nametext - The contact's last name.
- Email
emailtext - The contact's email address.
- Company
companytext - The company they work for.
- Address
addresstext - Their address.
- Extension
extensionnumber - An extension number for them.At least 0.
- Notes
notestext - Anything to keep on the contact.
- For every user
across_teamtrue/false - Add the contact for every user, not only the account owner.
Outputs
contactobject- The contact
Example output
{
"contact": {
"address": "New York, United States",
"agent_id": "105678",
"blacklisted": false,
"company": "Friends.co",
"contact_number": "+12135660001",
"created_at": "2026-10-01",
"do_not_disturb": false,
"do_not_message": false,
"email": "rachel.green@example.com",
"extension": "101",
"first_name": "Rachel",
"id": "1234",
"last_name": "Green",
"last_updated_at": "2026-10-13",
"name": "Rachel Green",
"notes": [
{
"added_at": "2026-10-13",
"text": "Wants a demo of AI features"
}
],
"other_numbers": [
{
"label": "Mobile",
"number": "+19876540000"
}
]
}
}Create text tag
Make a tag for labelling text conversations, such as Follow up.
Inputs
- Name
nametextRequired - The tag's name.
- Colour
colortext - The tag's colour.One of:
#3B82F6(Blue (default)),#22C55E(Green),#EAB308(Yellow),#F97316(Orange),#EF4444(Red),#A855F7(Purple),#6B7280(Grey). Default:#3B82F6.
Outputs
tagobject- The tag
Example output
{
"tag": {
"color_code": "#3B82F6",
"created_at": "2026-11-02 09:00:00",
"id": "3301",
"name": "Follow up"
}
}Delete contact
Delete a contact from JustCall. Their calls and texts stay.
Inputs
- Contact ID
contact_idtextRequired - The contact's ID, from 'List contacts' or an earlier step.
Outputs
contact_idtext- The contact deleted
deletedtrue/false- Always true once deleted
Example output
{
"contact_id": "1234",
"deleted": true
}Delete text tag
Delete a text tag. It comes off every conversation that has it.
Inputs
- Tag
tagtextRequired - The text tag.
Outputs
deletedtrue/false- Always true once deleted
tag_idtext- The tag deleted
Example output
{
"deleted": true,
"tag_id": "3301"
}Get call
Get one call: who it was with, direction, outcome, duration, notes, disposition, rating, recording link and voicemail text.
Inputs
- Call ID
call_idtextRequired - The call's ID (or its SID), from 'List calls', a trigger or an earlier step.
Outputs
callobject- The call
Example output
{
"call": {
"agent_email": "john.smith@example.com",
"agent_id": "278726",
"agent_name": "John Smith",
"ai_summary": "Robert asked for a demo of the AI features.",
"call_date": "2026-11-02",
"call_sid": "CA0247d967e9bb3c284163a37a43a1b2",
"call_time": "14:34:13",
"call_traits": [
"IVR"
],
"call_user_date": "2026-11-02",
"call_user_time": "09:34:13",
"contact_email": "robert.williams@example.com",
"contact_name": "Robert Williams",
"contact_number": "+16813810000",
"cost": 0.065,
"direction": "Incoming",
"disposition": "Sales: Lead",
"duration_seconds": 633,
"friendly_duration": "00:10:33",
"id": "1786326578",
"ivr_digit": "2",
"justcall_line_name": "Sales Line",
"justcall_number": "+12135660000",
"missed_call_reason": "",
"notes": "Requested a demo for Friday.",
"rating": 5,
"recording_url": "https://bifrost.justcall.io/voice-tools-calling/v1/recording/get-presigned-url?recSid=RE01",
"type": "Answered",
"voicemail_transcription": ""
}
}Get call AI report
Get JustCall AI's report on a call: summary, action items, score, customer sentiment, key moments and, if you ask, the transcript. Needs JustCall AI on your account; the report is ready a few minutes after the call.
Inputs
- Call ID
call_idtextRequired - The call's ID (or its SID), from 'List calls', a trigger or an earlier step.
- Made in
platformtext - Where the call was made.One of:
justcall(JustCall phone (default)),sales_dialer(Sales Dialer). Default:justcall. - Include transcript
include_transcripttrue/false - Also get what was said, line by line.
Outputs
reportobject- JustCall AI's report on the call
Example output
{
"report": {
"action_items": "Send Robert the demo invite for Friday.",
"call_moments": [
"Pricing",
"Demo"
],
"call_score": 9,
"call_sid": "CA0247d967e9bb3c284163a37a43a1b2",
"chapters": [
{
"points": [
"Asked about plans."
],
"title": "Pricing"
}
],
"customer_sentiment": "Positive",
"id": "1786326578",
"overall_sentiment": "Positive",
"platform": "justcall",
"summary": "Robert asked for a demo of the AI features.",
"tags": [
"Demo"
],
"transcript": [
{
"speaker": "John Smith",
"text": "Thanks for calling JustCall."
}
]
}
}Get contact
Get a contact's details, numbers and notes, and whether they are blocked or on Do Not Disturb.
Inputs
- Contact ID
contact_idtextRequired - The contact's ID, from 'List contacts' or an earlier step.
Outputs
contactobject- The contact
Example output
{
"contact": {
"address": "New York, United States",
"agent_id": "105678",
"blacklisted": false,
"company": "Friends.co",
"contact_number": "+12135660001",
"created_at": "2026-10-01",
"do_not_disturb": false,
"do_not_message": false,
"email": "rachel.green@example.com",
"extension": "101",
"first_name": "Rachel",
"id": "1234",
"last_name": "Green",
"last_updated_at": "2026-10-13",
"name": "Rachel Green",
"notes": [
{
"added_at": "2026-10-13",
"text": "Wants a demo of AI features"
}
],
"other_numbers": [
{
"label": "Mobile",
"number": "+19876540000"
}
]
}
}Get text
Get one text: what it says, who it was with, and whether it was delivered.
Inputs
- Text ID
text_idtextRequired - The text's ID, from 'List texts' or an earlier step.
Outputs
textobject- The text
Example output
{
"text": {
"agent_email": "john.smith@example.com",
"agent_id": "271556",
"agent_name": "John Smith",
"body": "Hi Robert, your demo is booked for 3pm tomorrow.",
"contact_email": "robert.williams@example.com",
"contact_name": "Robert Williams",
"contact_number": "+16813810000",
"cost": 0.05635,
"delivery_status": "delivered",
"direction": "Outgoing",
"id": "123455678",
"is_mms": false,
"justcall_line_name": "Sales Line",
"justcall_number": "+12135660000",
"media_urls": [],
"medium": "One-To-One via API",
"sms_date": "2026-11-02",
"sms_time": "09:30:58",
"sms_user_date": "2026-11-02",
"sms_user_time": "04:30:58"
}
}Get user
Get one JustCall user: role, extension, numbers, groups, and whether they are available or on a call now.
Inputs
- User
agenttextRequired - The JustCall user (agent).
Outputs
userobject- The user
Example output
{
"user": {
"available": true,
"created_at": "2025-01-01 10:00:00",
"email": "john.doe@example.com",
"extension": "100",
"groups": [
{
"id": "111",
"name": "Sales Team"
}
],
"id": "105678",
"last_login_at": "2026-11-01 10:00:00",
"name": "John Doe",
"on_call": false,
"owned_numbers": [
"12135660000"
],
"role": "Admin",
"shared_numbers": [
"19876543210"
],
"timezone": "America/New_York",
"unavailability_reason": "",
"working_hours_type": "Always Open"
}
}List calls
List calls on your JustCall account, newest first: by day, direction, outcome (such as missed or voicemail), JustCall number, contact or user. JustCall keeps the last three months. Gets one page; run it again with the next page for more.
Inputs
- From
from_datedate - Only those on or after this day.
- To
to_datedate - Only those on or before this day.
- Direction
call_directiontext - Only incoming or only outgoing calls.One of:
Incoming,Outgoing. - Outcome
call_typetext - Only calls that went this way.One of:
INCOMING_ANSWERED(Incoming, answered),INCOMING_MISSED(Incoming, missed),INCOMING_VOICEMAIL(Incoming, voicemail),INCOMING_ABANDONED(Incoming, abandoned),INCOMING_BUSY(Incoming, busy),INCOMING_FAILED(Incoming, failed),OUTGOING_ANSWERED(Outgoing, answered),OUTGOING_UNANSWERED(Outgoing, unanswered),OUTGOING_BUSY(Outgoing, busy),OUTGOING_FAILED(Outgoing, failed), and 3 more. - JustCall number
justcall_numbertext - Only calls on this number of yours.
- Contact's number
contact_numbertext - Only calls with this number, with its country code, like +14155550123.
- User
agenttext - Only this user's calls.
- Order
ordertext - Newest or oldest first.One of:
desc(Newest first (default)),asc(Oldest first). Default:desc. - Page
pagenumber - Which page to get: 0 is the first. Use 'Has more' to see whether there is another.At least 0.
- Per page
per_pagenumber - How many to get, 1 to 100. JustCall's default is 20.From 1 to 100.
Outputs
callslist- The calls
countnumber- How many are on this page
has_moretrue/false- Whether there is a next page
pagenumber- This page's number, 0 for the first
Example output
{
"calls": [
{
"agent_email": "john.smith@example.com",
"agent_id": "278726",
"agent_name": "John Smith",
"ai_summary": "Robert asked for a demo of the AI features.",
"call_date": "2026-11-02",
"call_sid": "CA0247d967e9bb3c284163a37a43a1b2",
"call_time": "14:34:13",
"call_traits": [
"IVR"
],
"call_user_date": "2026-11-02",
"call_user_time": "09:34:13",
"contact_email": "robert.williams@example.com",
"contact_name": "Robert Williams",
"contact_number": "+16813810000",
"cost": 0.065,
"direction": "Incoming",
"disposition": "Sales: Lead",
"duration_seconds": 633,
"friendly_duration": "00:10:33",
"id": "1786326578",
"ivr_digit": "2",
"justcall_line_name": "Sales Line",
"justcall_number": "+12135660000",
"missed_call_reason": "",
"notes": "Requested a demo for Friday.",
"rating": 5,
"recording_url": "https://bifrost.justcall.io/voice-tools-calling/v1/recording/get-presigned-url?recSid=RE01",
"type": "Answered",
"voicemail_transcription": ""
}
],
"count": 1,
"has_more": false,
"page": 0
}List campaigns
List your Sales Dialer campaigns, with their type and whether they are finished. Needs the Pro plan or higher.
Inputs
- Status
statustext - Which campaigns. JustCall's default is every campaign that isn't archived.One of:
all,active(Active (not completed)),completed,archived. - Type
campaign_typetext - Only campaigns of this type.One of:
PowerDial(Power dialer),Predictive,Dynamic. - Page
pagenumber - Which page to get: 0 is the first. Use 'Has more' to see whether there is another.At least 0.
- Per page
per_pagenumber - How many to get, 1 to 50. JustCall's default is 10.From 1 to 50.
Outputs
campaignslist- The campaigns
countnumber- How many are on this page
has_moretrue/false- Whether there is a next page
pagenumber- This page's number, 0 for the first
Example output
{
"campaigns": [
{
"country_code": "US",
"created_by_email": "john.doe@example.com",
"created_by_name": "John Doe",
"created_date": "2026-10-01",
"created_time": "10:00:00",
"default_number": "+12135660000",
"id": "2024301",
"name": "Website Leads",
"status": "Remaining",
"type": "Predictive"
}
],
"count": 1,
"has_more": false,
"page": 0
}List contacts
List contacts in JustCall, newest first, or find them by phone number or name. Gets one page; run it again with the next page for more.
Inputs
- Phone number
contact_numbertext - Only the contact with this number, with its country code.
- First name
first_nametext - Only contacts with this first name.
- Last name
last_nametext - Only contacts with this last name.
- Every user's contacts
across_teamtrue/false - Include every user's contacts, not only the account owner's.
- Order
ordertext - Newest or oldest first.One of:
desc(Newest first (default)),asc(Oldest first). Default:desc. - Page
pagenumber - Which page to get: 0 is the first. Use 'Has more' to see whether there is another.At least 0.
- Per page
per_pagenumber - How many to get, 1 to 500. JustCall's default is 50.From 1 to 500.
Outputs
contactslist- The contacts
countnumber- How many are on this page
has_moretrue/false- Whether there is a next page
pagenumber- This page's number, 0 for the first
Example output
{
"contacts": [
{
"address": "New York, United States",
"agent_id": "105678",
"blacklisted": false,
"company": "Friends.co",
"contact_number": "+12135660001",
"created_at": "2026-10-01",
"do_not_disturb": false,
"do_not_message": false,
"email": "rachel.green@example.com",
"extension": "101",
"first_name": "Rachel",
"id": "1234",
"last_name": "Green",
"last_updated_at": "2026-10-13",
"name": "Rachel Green",
"notes": [
{
"added_at": "2026-10-13",
"text": "Wants a demo of AI features"
}
],
"other_numbers": [
{
"label": "Mobile",
"number": "+19876540000"
}
]
}
],
"count": 1,
"has_more": false,
"page": 0
}List phone numbers
List your JustCall phone numbers, with their line names, owners and whether each can call, text and send pictures.
Inputs
- Can
capabilitytext - Only numbers that can do this.One of:
call(Calls),sms(Texts (SMS)),mms(Picture messages (MMS)). - Type
number_typetext - Only numbers of this type.One of:
local,mobile,toll_free(Toll-free). - Page
pagenumber - Which page to get: 0 is the first. Use 'Has more' to see whether there is another.At least 0.
- Per page
per_pagenumber - How many to get, 1 to 100. JustCall's default is 30.From 1 to 100.
Outputs
countnumber- How many are on this page
has_moretrue/false- Whether there is a next page
pagenumber- This page's number, 0 for the first
phone_numberslist- The numbers
Example output
{
"count": 1,
"has_more": false,
"page": 0,
"phone_numbers": [
{
"availability_setting": "Custom Hours",
"can_call": true,
"can_send_mms": true,
"can_text": true,
"current_status": "Open",
"friendly_number": "+1 213-566-0000",
"id": "5521",
"justcall_number": "+12135660000",
"line_name": "Sales Line",
"number_type": "local",
"owner_email": "john.doe@example.com",
"owner_id": "105678",
"owner_name": "John Doe",
"sms_compliance": "Approved"
}
]
}List Sales Dialer calls
List calls made by Sales Dialer, newest first: by campaign, user or day, with who picked up, the outcome, notes and recording.
Inputs
- Campaign
campaigntext - Only this campaign's calls.
- User
agenttext - Only this user's calls.
- From
from_datedate - Only those on or after this day.
- To
to_datedate - Only those on or before this day.
- Order
ordertext - Newest or oldest first.One of:
desc(Newest first (default)),asc(Oldest first). Default:desc. - Page
pagenumber - Which page to get: 0 is the first. Use 'Has more' to see whether there is another.At least 0.
- Per page
per_pagenumber - How many to get, 1 to 100. JustCall's default is 20.From 1 to 100.
Outputs
callslist- The calls
countnumber- How many are on this page
has_moretrue/false- Whether there is a next page
pagenumber- This page's number, 0 for the first
Example output
{
"calls": [
{
"agent_email": "john.smith@example.com",
"agent_id": "278726",
"agent_name": "John Smith",
"ai_summary": "",
"answered_by": "Human Pickup",
"call_date": "2026-11-02",
"call_sid": "CA0247d967e9bb3c284163a37a43c3d4",
"call_time": "13:55:43",
"call_user_date": "2026-11-02",
"call_user_time": "08:55:43",
"campaign_id": "2024301",
"campaign_name": "Website Leads",
"contact_email": "robert.williams@example.com",
"contact_id": "15162",
"contact_name": "Robert Williams",
"contact_number": "+16813810000",
"cost": 0.38,
"disposition": "Interested",
"duration_seconds": 40,
"friendly_duration": "00:00:40",
"id": "95676",
"notes": "",
"outcome": "Connected",
"rating": 0,
"recording_url": "https://jc-recordings.s3.amazonaws.com/RE01.mp3",
"sales_dialer_number": "+12135660000"
}
],
"count": 1,
"has_more": false,
"page": 0
}List texts
List texts sent and received on your JustCall account, newest first: by day, sent or received, JustCall number, contact or words in them. Gets one page; run it again with the next page for more.
Inputs
- From
from_datedate - Only those on or after this day.
- To
to_datedate - Only those on or before this day.
- Sent or received
directiontext - Only texts received, or only texts sent.One of:
incoming(Received),outgoing(Sent). - JustCall number
justcall_numbertext - Only texts on this number of yours.
- Contact's number
contact_numbertext - Only texts with this number, with its country code, like +14155550123.
- Containing
searchtext - Only texts with these words in them.
- Order
ordertext - Newest or oldest first.One of:
desc(Newest first (default)),asc(Oldest first). Default:desc. - Page
pagenumber - Which page to get: 0 is the first. Use 'Has more' to see whether there is another.At least 0.
- Per page
per_pagenumber - How many to get, 1 to 100. JustCall's default is 20.From 1 to 100.
Outputs
countnumber- How many are on this page
has_moretrue/false- Whether there is a next page
pagenumber- This page's number, 0 for the first
textslist- The texts
Example output
{
"count": 1,
"has_more": false,
"page": 0,
"texts": [
{
"agent_email": "john.smith@example.com",
"agent_id": "271556",
"agent_name": "John Smith",
"body": "Hi Robert, your demo is booked for 3pm tomorrow.",
"contact_email": "robert.williams@example.com",
"contact_name": "Robert Williams",
"contact_number": "+16813810000",
"cost": 0.05635,
"delivery_status": "delivered",
"direction": "Outgoing",
"id": "123455678",
"is_mms": false,
"justcall_line_name": "Sales Line",
"justcall_number": "+12135660000",
"media_urls": [],
"medium": "One-To-One via API",
"sms_date": "2026-11-02",
"sms_time": "09:30:58",
"sms_user_date": "2026-11-02",
"sms_user_time": "04:30:58"
}
]
}List users
List the people on your JustCall account, with their role, extension, numbers and whether they are available or on a call.
Inputs
- Email
emailtext - Only the user with this email.
- Order
ordertext - Newest or oldest first.One of:
desc(Newest first (default)),asc(Oldest first). Default:desc. - Page
pagenumber - Which page to get: 0 is the first. Use 'Has more' to see whether there is another.At least 0.
- Per page
per_pagenumber - How many to get, 1 to 100. JustCall's default is 50.From 1 to 100.
Outputs
countnumber- How many are on this page
has_moretrue/false- Whether there is a next page
pagenumber- This page's number, 0 for the first
userslist- The users
Example output
{
"count": 1,
"has_more": false,
"page": 0,
"users": [
{
"available": true,
"created_at": "2025-01-01 10:00:00",
"email": "john.doe@example.com",
"extension": "100",
"groups": [
{
"id": "111",
"name": "Sales Team"
}
],
"id": "105678",
"last_login_at": "2026-11-01 10:00:00",
"name": "John Doe",
"on_call": false,
"owned_numbers": [
"12135660000"
],
"role": "Admin",
"shared_numbers": [
"19876543210"
],
"timezone": "America/New_York",
"unavailability_reason": "",
"working_hours_type": "Always Open"
}
]
}Remove contact from campaign
Take a phone number off a Sales Dialer campaign, so the dialer stops calling it.
Inputs
- Campaign
campaigntextRequired - The Sales Dialer campaign.
- Phone number
phone_numbertextRequired - The number to take off, with its country code.
Outputs
campaign_idtext- The campaign
phone_numbertext- The number taken off
removedtrue/false- Always true once removed
Example output
{
"campaign_id": "2024301",
"phone_number": "+16813810000",
"removed": true
}Send text
Send a text (SMS) from one of your JustCall numbers, with pictures or files if you add links to them (sent as MMS).
Inputs
- From
justcall_numbertextRequired - Your JustCall number to send from. It must be able to text.
- To
contact_numbertextRequired - The phone number to text, with its country code, like +14155550123.
- Message
bodytextRequired - What to say, up to 1600 characters.
- Picture or file links
media_urlslist - Up to 10 public links to images, audio, video or PDFs, 5 MB in all.
- At most once a day
once_a_daytrue/false - Don't send it if this number got the same text in the last 24 hours.
Outputs
textobject- The text
Example output
{
"text": {
"agent_email": "john.smith@example.com",
"agent_id": "271556",
"agent_name": "John Smith",
"body": "Hi Robert, your demo is booked for 3pm tomorrow.",
"contact_email": "robert.williams@example.com",
"contact_name": "Robert Williams",
"contact_number": "+16813810000",
"cost": 0.05635,
"delivery_status": "delivered",
"direction": "Outgoing",
"id": "123455678",
"is_mms": false,
"justcall_line_name": "Sales Line",
"justcall_number": "+12135660000",
"media_urls": [],
"medium": "One-To-One via API",
"sms_date": "2026-11-02",
"sms_time": "09:30:58",
"sms_user_date": "2026-11-02",
"sms_user_time": "04:30:58"
}
}Set user availability
Mark a JustCall user available to take calls, or unavailable with a reason, such as at the end of a shift.
Inputs
- User
agenttextRequired - The JustCall user (agent).
- Available
availabletrue/falseRequired - On for available, off for unavailable.
- Reason
unavailability_reasontext - Why they are unavailable, such as Break. It must be one of the reasons set up in JustCall.
Outputs
agent_idtext- The user
availabletrue/false- Whether they are now available
unavailability_reasontext- The reason given, if unavailable
Example output
{
"agent_id": "105678",
"available": false,
"unavailability_reason": "Break"
}Tag text conversation
Put a tag on a text conversation: the one between your JustCall number and a contact, every conversation with a contact, or one thread by its ID.
Inputs
- Tag
tagtextRequired - The text tag.
- JustCall number
justcall_numbertext - Your JustCall number the conversation is on. Leave blank for the contact's conversations on every number.
- Contact's number
contact_numbertext - The contact's phone number with its country code, like +14155550123.
- Thread ID
thread_idtext - Or the conversation's thread ID in JustCall, instead of the numbers.
Outputs
contact_numbertext- The contact's number, if one was given
justcall_numbertext- Your number, if one was given
tag_idtext- The tag
taggedtrue/false- Always true once tagged
thread_idtext- The thread, if one was given
Example output
{
"contact_number": "+16813810000",
"justcall_number": "+12135660000",
"tag_id": "3301",
"tagged": true,
"thread_id": ""
}Untag text conversation
Take a tag off a text conversation, chosen the same way as for tagging.
Inputs
- Tag
tagtextRequired - The text tag.
- JustCall number
justcall_numbertext - Your JustCall number the conversation is on. Leave blank for the contact's conversations on every number.
- Contact's number
contact_numbertext - The contact's phone number with its country code, like +14155550123.
- Thread ID
thread_idtext - Or the conversation's thread ID in JustCall, instead of the numbers.
Outputs
contact_numbertext- The contact's number, if one was given
justcall_numbertext- Your number, if one was given
tag_idtext- The tag
thread_idtext- The thread, if one was given
untaggedtrue/false- Always true once removed
Example output
{
"contact_number": "+16813810000",
"justcall_number": "+12135660000",
"tag_id": "3301",
"thread_id": "",
"untagged": true
}Update call
Set a finished call's notes, disposition or rating. New notes replace the call's notes; fields left blank keep what they have.
Inputs
- Call ID
call_idtextRequired - The call's ID (or its SID), from 'List calls', a trigger or an earlier step.
- Notes
notestext - The call's notes. They replace any there.
- Disposition
disposition_codetext - The outcome, written as in JustCall: the list's name, a colon and the outcome, such as Sales: Lead. It must already be in JustCall.
- Rating
ratingnumber - A rating from 0 to 5, in steps of 0.5.From 0 to 5.
Outputs
callobject- The call
Example output
{
"call": {
"agent_email": "john.smith@example.com",
"agent_id": "278726",
"agent_name": "John Smith",
"ai_summary": "Robert asked for a demo of the AI features.",
"call_date": "2026-11-02",
"call_sid": "CA0247d967e9bb3c284163a37a43a1b2",
"call_time": "14:34:13",
"call_traits": [
"IVR"
],
"call_user_date": "2026-11-02",
"call_user_time": "09:34:13",
"contact_email": "robert.williams@example.com",
"contact_name": "Robert Williams",
"contact_number": "+16813810000",
"cost": 0.065,
"direction": "Incoming",
"disposition": "Sales: Lead",
"duration_seconds": 633,
"friendly_duration": "00:10:33",
"id": "1786326578",
"ivr_digit": "2",
"justcall_line_name": "Sales Line",
"justcall_number": "+12135660000",
"missed_call_reason": "",
"notes": "Requested a demo for Friday.",
"rating": 5,
"recording_url": "https://bifrost.justcall.io/voice-tools-calling/v1/recording/get-presigned-url?recSid=RE01",
"type": "Answered",
"voicemail_transcription": ""
}
}Update contact
Change a contact's details, or add a note to them. Fields left blank keep what they have.
Inputs
- Contact ID
contact_idtextRequired - The contact's ID, from 'List contacts' or an earlier step.
- First name
first_nametext - A new first name.
- Phone number
contact_numbertext - A new main number, with its country code.
- Last name
last_nametext - The contact's last name.
- Email
emailtext - The contact's email address.
- Company
companytext - The company they work for.
- Address
addresstext - Their address.
- Extension
extensionnumber - An extension number for them.At least 0.
- Add a note
notetext - A note to add to the contact.
Outputs
contactobject- The contact
Example output
{
"contact": {
"address": "New York, United States",
"agent_id": "105678",
"blacklisted": false,
"company": "Friends.co",
"contact_number": "+12135660001",
"created_at": "2026-10-01",
"do_not_disturb": false,
"do_not_message": false,
"email": "rachel.green@example.com",
"extension": "101",
"first_name": "Rachel",
"id": "1234",
"last_name": "Green",
"last_updated_at": "2026-10-13",
"name": "Rachel Green",
"notes": [
{
"added_at": "2026-10-13",
"text": "Wants a demo of AI features"
}
],
"other_numbers": [
{
"label": "Mobile",
"number": "+19876540000"
}
]
}
}