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

ActionWhat it does
Add contact to campaignAdd a phone number to a Sales Dialer campaign, so the dialer calls it.
Check for text replySee whether a contact has texted back, and get the newest text they sent.
Create contactAdd a contact to JustCall, so calls and texts with them show their name.
Create text tagMake a tag for labelling text conversations, such as Follow up.
Delete contactDelete a contact from JustCall.
Delete text tagDelete a text tag.
Get callGet one call: who it was with, direction, outcome, duration, notes, disposition, rating, recording link and voicemail text.
Get call AI reportGet JustCall AI's report on a call: summary, action items, score, customer sentiment, key moments and, if you ask, the transcript.
Get contactGet a contact's details, numbers and notes, and whether they are blocked or on Do Not Disturb.
Get textGet one text: what it says, who it was with, and whether it was delivered.
Get userGet one JustCall user: role, extension, numbers, groups, and whether they are available or on a call now.
List callsList calls on your JustCall account, newest first: by day, direction, outcome (such as missed or voicemail), JustCall number, contact or user.
List campaignsList your Sales Dialer campaigns, with their type and whether they are finished.
List contactsList contacts in JustCall, newest first, or find them by phone number or name.
List phone numbersList your JustCall phone numbers, with their line names, owners and whether each can call, text and send pictures.
List Sales Dialer callsList calls made by Sales Dialer, newest first: by campaign, user or day, with who picked up, the outcome, notes and recording.
List textsList texts sent and received on your JustCall account, newest first: by day, sent or received, JustCall number, contact or words in them.
List usersList the people on your JustCall account, with their role, extension, numbers and whether they are available or on a call.
Remove contact from campaignTake a phone number off a Sales Dialer campaign, so the dialer stops calling it.
Send textSend a text (SMS) from one of your JustCall numbers, with pictures or files if you add links to them (sent as MMS).
Set user availabilityMark a JustCall user available to take calls, or unavailable with a reason, such as at the end of a shift.
Tag text conversationPut 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 conversationTake a tag off a text conversation, chosen the same way as for tagging.
Update callSet a finished call's notes, disposition or rating.
Update contactChange 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

CampaigncampaigntextRequired
The Sales Dialer campaign.
Phone numberphone_numbertextRequired
The number to call, with its country code, like +14155550123.
Namenametext
The contact's name.
Emailemailtext
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 numbercontact_numbertextRequired
Their phone number, with its country code, like +14155550123.
JustCall numberjustcall_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 namefirst_nametextRequired
The contact's first name.
Phone numbercontact_numbertextRequired
Their phone number, with its country code, like +14155550123.
Last namelast_nametext
The contact's last name.
Emailemailtext
The contact's email address.
Companycompanytext
The company they work for.
Addressaddresstext
Their address.
Extensionextensionnumber
An extension number for them.At least 0.
Notesnotestext
Anything to keep on the contact.
For every useracross_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

NamenametextRequired
The tag's name.
Colourcolortext
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 IDcontact_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

TagtagtextRequired
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 IDcall_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 IDcall_idtextRequired
The call's ID (or its SID), from 'List calls', a trigger or an earlier step.
Made inplatformtext
Where the call was made.One of: justcall (JustCall phone (default)), sales_dialer (Sales Dialer). Default: justcall.
Include transcriptinclude_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 IDcontact_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 IDtext_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

UseragenttextRequired
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

Fromfrom_datedate
Only those on or after this day.
Toto_datedate
Only those on or before this day.
Directioncall_directiontext
Only incoming or only outgoing calls.One of: Incoming, Outgoing.
Outcomecall_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 numberjustcall_numbertext
Only calls on this number of yours.
Contact's numbercontact_numbertext
Only calls with this number, with its country code, like +14155550123.
Useragenttext
Only this user's calls.
Orderordertext
Newest or oldest first.One of: desc (Newest first (default)), asc (Oldest first). Default: desc.
Pagepagenumber
Which page to get: 0 is the first. Use 'Has more' to see whether there is another.At least 0.
Per pageper_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

Statusstatustext
Which campaigns. JustCall's default is every campaign that isn't archived.One of: all, active (Active (not completed)), completed, archived.
Typecampaign_typetext
Only campaigns of this type.One of: PowerDial (Power dialer), Predictive, Dynamic.
Pagepagenumber
Which page to get: 0 is the first. Use 'Has more' to see whether there is another.At least 0.
Per pageper_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 numbercontact_numbertext
Only the contact with this number, with its country code.
First namefirst_nametext
Only contacts with this first name.
Last namelast_nametext
Only contacts with this last name.
Every user's contactsacross_teamtrue/false
Include every user's contacts, not only the account owner's.
Orderordertext
Newest or oldest first.One of: desc (Newest first (default)), asc (Oldest first). Default: desc.
Pagepagenumber
Which page to get: 0 is the first. Use 'Has more' to see whether there is another.At least 0.
Per pageper_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

Cancapabilitytext
Only numbers that can do this.One of: call (Calls), sms (Texts (SMS)), mms (Picture messages (MMS)).
Typenumber_typetext
Only numbers of this type.One of: local, mobile, toll_free (Toll-free).
Pagepagenumber
Which page to get: 0 is the first. Use 'Has more' to see whether there is another.At least 0.
Per pageper_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

Campaigncampaigntext
Only this campaign's calls.
Useragenttext
Only this user's calls.
Fromfrom_datedate
Only those on or after this day.
Toto_datedate
Only those on or before this day.
Orderordertext
Newest or oldest first.One of: desc (Newest first (default)), asc (Oldest first). Default: desc.
Pagepagenumber
Which page to get: 0 is the first. Use 'Has more' to see whether there is another.At least 0.
Per pageper_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

Fromfrom_datedate
Only those on or after this day.
Toto_datedate
Only those on or before this day.
Sent or receiveddirectiontext
Only texts received, or only texts sent.One of: incoming (Received), outgoing (Sent).
JustCall numberjustcall_numbertext
Only texts on this number of yours.
Contact's numbercontact_numbertext
Only texts with this number, with its country code, like +14155550123.
Containingsearchtext
Only texts with these words in them.
Orderordertext
Newest or oldest first.One of: desc (Newest first (default)), asc (Oldest first). Default: desc.
Pagepagenumber
Which page to get: 0 is the first. Use 'Has more' to see whether there is another.At least 0.
Per pageper_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

Emailemailtext
Only the user with this email.
Orderordertext
Newest or oldest first.One of: desc (Newest first (default)), asc (Oldest first). Default: desc.
Pagepagenumber
Which page to get: 0 is the first. Use 'Has more' to see whether there is another.At least 0.
Per pageper_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

CampaigncampaigntextRequired
The Sales Dialer campaign.
Phone numberphone_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

Fromjustcall_numbertextRequired
Your JustCall number to send from. It must be able to text.
Tocontact_numbertextRequired
The phone number to text, with its country code, like +14155550123.
MessagebodytextRequired
What to say, up to 1600 characters.
Picture or file linksmedia_urlslist
Up to 10 public links to images, audio, video or PDFs, 5 MB in all.
At most once a dayonce_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

UseragenttextRequired
The JustCall user (agent).
Availableavailabletrue/falseRequired
On for available, off for unavailable.
Reasonunavailability_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

TagtagtextRequired
The text tag.
JustCall numberjustcall_numbertext
Your JustCall number the conversation is on. Leave blank for the contact's conversations on every number.
Contact's numbercontact_numbertext
The contact's phone number with its country code, like +14155550123.
Thread IDthread_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

TagtagtextRequired
The text tag.
JustCall numberjustcall_numbertext
Your JustCall number the conversation is on. Leave blank for the contact's conversations on every number.
Contact's numbercontact_numbertext
The contact's phone number with its country code, like +14155550123.
Thread IDthread_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 IDcall_idtextRequired
The call's ID (or its SID), from 'List calls', a trigger or an earlier step.
Notesnotestext
The call's notes. They replace any there.
Dispositiondisposition_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.
Ratingratingnumber
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 IDcontact_idtextRequired
The contact's ID, from 'List contacts' or an earlier step.
First namefirst_nametext
A new first name.
Phone numbercontact_numbertext
A new main number, with its country code.
Last namelast_nametext
The contact's last name.
Emailemailtext
The contact's email address.
Companycompanytext
The company they work for.
Addressaddresstext
Their address.
Extensionextensionnumber
An extension number for them.At least 0.
Add a notenotetext
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"
      }
    ]
  }
}

On this page