# JustCall

> 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.

App · 25 actions. Web page: https://docs.lodol.com/docs/integrations/justcall

## Actions

### 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 (`campaign`, text, required): The Sales Dialer campaign.
- Phone number (`phone_number`, text, required): The number to call, with its country code, like +14155550123.
- Name (`name`, text): The contact's name.
- Email (`email`, text): The contact's email address.

**Outputs**

- `campaign_id` (text): The campaign
- `contact` (object): The contact in Sales Dialer

**Example output**

```json
{
  "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_number`, text, required): Their phone number, with its country code, like +14155550123.
- JustCall number (`justcall_number`, text): Only replies to this number of yours. Leave blank for any.

**Outputs**

- `replied` (true/false): Whether they have texted in
- `text` (object): The text

**Example output**

```json
{
  "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_name`, text, required): The contact's first name.
- Phone number (`contact_number`, text, required): Their phone number, with its country code, like +14155550123.
- Last name (`last_name`, text): The contact's last name.
- Email (`email`, text): The contact's email address.
- Company (`company`, text): The company they work for.
- Address (`address`, text): Their address.
- Extension (`extension`, number): An extension number for them. At least 0.
- Notes (`notes`, text): Anything to keep on the contact.
- For every user (`across_team`, true/false): Add the contact for every user, not only the account owner.

**Outputs**

- `contact` (object): The contact

**Example output**

```json
{
  "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 (`name`, text, required): The tag's name.
- Colour (`color`, text): The tag's colour. One of: `#3B82F6` (Blue (default)), `#22C55E` (Green), `#EAB308` (Yellow), `#F97316` (Orange), `#EF4444` (Red), `#A855F7` (Purple), `#6B7280` (Grey). Default: `#3B82F6`.

**Outputs**

- `tag` (object): The tag

**Example output**

```json
{
  "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_id`, text, required): The contact's ID, from 'List contacts' or an earlier step.

**Outputs**

- `contact_id` (text): The contact deleted
- `deleted` (true/false): Always true once deleted

**Example output**

```json
{
  "contact_id": "1234",
  "deleted": true
}
```

### Delete text tag

Delete a text tag. It comes off every conversation that has it.

**Inputs**

- Tag (`tag`, text, required): The text tag.

**Outputs**

- `deleted` (true/false): Always true once deleted
- `tag_id` (text): The tag deleted

**Example output**

```json
{
  "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_id`, text, required): The call's ID (or its SID), from 'List calls', a trigger or an earlier step.

**Outputs**

- `call` (object): The call

**Example output**

```json
{
  "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_id`, text, required): The call's ID (or its SID), from 'List calls', a trigger or an earlier step.
- Made in (`platform`, text): Where the call was made. One of: `justcall` (JustCall phone (default)), `sales_dialer` (Sales Dialer). Default: `justcall`.
- Include transcript (`include_transcript`, true/false): Also get what was said, line by line.

**Outputs**

- `report` (object): JustCall AI's report on the call

**Example output**

```json
{
  "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_id`, text, required): The contact's ID, from 'List contacts' or an earlier step.

**Outputs**

- `contact` (object): The contact

**Example output**

```json
{
  "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_id`, text, required): The text's ID, from 'List texts' or an earlier step.

**Outputs**

- `text` (object): The text

**Example output**

```json
{
  "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 (`agent`, text, required): The JustCall user (agent).

**Outputs**

- `user` (object): The user

**Example output**

```json
{
  "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_date`, date): Only those on or after this day.
- To (`to_date`, date): Only those on or before this day.
- Direction (`call_direction`, text): Only incoming or only outgoing calls. One of: `Incoming`, `Outgoing`.
- Outcome (`call_type`, text): 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_number`, text): Only calls on this number of yours.
- Contact's number (`contact_number`, text): Only calls with this number, with its country code, like +14155550123.
- User (`agent`, text): Only this user's calls.
- Order (`order`, text): Newest or oldest first. One of: `desc` (Newest first (default)), `asc` (Oldest first). Default: `desc`.
- Page (`page`, number): Which page to get: 0 is the first. Use 'Has more' to see whether there is another. At least 0.
- Per page (`per_page`, number): How many to get, 1 to 100. JustCall's default is 20. From 1 to 100.

**Outputs**

- `calls` (list): The calls
- `count` (number): How many are on this page
- `has_more` (true/false): Whether there is a next page
- `page` (number): This page's number, 0 for the first

**Example output**

```json
{
  "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 (`status`, text): Which campaigns. JustCall's default is every campaign that isn't archived. One of: `all`, `active` (Active (not completed)), `completed`, `archived`.
- Type (`campaign_type`, text): Only campaigns of this type. One of: `PowerDial` (Power dialer), `Predictive`, `Dynamic`.
- Page (`page`, number): Which page to get: 0 is the first. Use 'Has more' to see whether there is another. At least 0.
- Per page (`per_page`, number): How many to get, 1 to 50. JustCall's default is 10. From 1 to 50.

**Outputs**

- `campaigns` (list): The campaigns
- `count` (number): How many are on this page
- `has_more` (true/false): Whether there is a next page
- `page` (number): This page's number, 0 for the first

**Example output**

```json
{
  "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_number`, text): Only the contact with this number, with its country code.
- First name (`first_name`, text): Only contacts with this first name.
- Last name (`last_name`, text): Only contacts with this last name.
- Every user's contacts (`across_team`, true/false): Include every user's contacts, not only the account owner's.
- Order (`order`, text): Newest or oldest first. One of: `desc` (Newest first (default)), `asc` (Oldest first). Default: `desc`.
- Page (`page`, number): Which page to get: 0 is the first. Use 'Has more' to see whether there is another. At least 0.
- Per page (`per_page`, number): How many to get, 1 to 500. JustCall's default is 50. From 1 to 500.

**Outputs**

- `contacts` (list): The contacts
- `count` (number): How many are on this page
- `has_more` (true/false): Whether there is a next page
- `page` (number): This page's number, 0 for the first

**Example output**

```json
{
  "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 (`capability`, text): Only numbers that can do this. One of: `call` (Calls), `sms` (Texts (SMS)), `mms` (Picture messages (MMS)).
- Type (`number_type`, text): Only numbers of this type. One of: `local`, `mobile`, `toll_free` (Toll-free).
- Page (`page`, number): Which page to get: 0 is the first. Use 'Has more' to see whether there is another. At least 0.
- Per page (`per_page`, number): How many to get, 1 to 100. JustCall's default is 30. From 1 to 100.

**Outputs**

- `count` (number): How many are on this page
- `has_more` (true/false): Whether there is a next page
- `page` (number): This page's number, 0 for the first
- `phone_numbers` (list): The numbers

**Example output**

```json
{
  "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 (`campaign`, text): Only this campaign's calls.
- User (`agent`, text): Only this user's calls.
- From (`from_date`, date): Only those on or after this day.
- To (`to_date`, date): Only those on or before this day.
- Order (`order`, text): Newest or oldest first. One of: `desc` (Newest first (default)), `asc` (Oldest first). Default: `desc`.
- Page (`page`, number): Which page to get: 0 is the first. Use 'Has more' to see whether there is another. At least 0.
- Per page (`per_page`, number): How many to get, 1 to 100. JustCall's default is 20. From 1 to 100.

**Outputs**

- `calls` (list): The calls
- `count` (number): How many are on this page
- `has_more` (true/false): Whether there is a next page
- `page` (number): This page's number, 0 for the first

**Example output**

```json
{
  "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_date`, date): Only those on or after this day.
- To (`to_date`, date): Only those on or before this day.
- Sent or received (`direction`, text): Only texts received, or only texts sent. One of: `incoming` (Received), `outgoing` (Sent).
- JustCall number (`justcall_number`, text): Only texts on this number of yours.
- Contact's number (`contact_number`, text): Only texts with this number, with its country code, like +14155550123.
- Containing (`search`, text): Only texts with these words in them.
- Order (`order`, text): Newest or oldest first. One of: `desc` (Newest first (default)), `asc` (Oldest first). Default: `desc`.
- Page (`page`, number): Which page to get: 0 is the first. Use 'Has more' to see whether there is another. At least 0.
- Per page (`per_page`, number): How many to get, 1 to 100. JustCall's default is 20. From 1 to 100.

**Outputs**

- `count` (number): How many are on this page
- `has_more` (true/false): Whether there is a next page
- `page` (number): This page's number, 0 for the first
- `texts` (list): The texts

**Example output**

```json
{
  "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 (`email`, text): Only the user with this email.
- Order (`order`, text): Newest or oldest first. One of: `desc` (Newest first (default)), `asc` (Oldest first). Default: `desc`.
- Page (`page`, number): Which page to get: 0 is the first. Use 'Has more' to see whether there is another. At least 0.
- Per page (`per_page`, number): How many to get, 1 to 100. JustCall's default is 50. From 1 to 100.

**Outputs**

- `count` (number): How many are on this page
- `has_more` (true/false): Whether there is a next page
- `page` (number): This page's number, 0 for the first
- `users` (list): The users

**Example output**

```json
{
  "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 (`campaign`, text, required): The Sales Dialer campaign.
- Phone number (`phone_number`, text, required): The number to take off, with its country code.

**Outputs**

- `campaign_id` (text): The campaign
- `phone_number` (text): The number taken off
- `removed` (true/false): Always true once removed

**Example output**

```json
{
  "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_number`, text, required): Your JustCall number to send from. It must be able to text.
- To (`contact_number`, text, required): The phone number to text, with its country code, like +14155550123.
- Message (`body`, text, required): What to say, up to 1600 characters.
- Picture or file links (`media_urls`, list): Up to 10 public links to images, audio, video or PDFs, 5 MB in all.
- At most once a day (`once_a_day`, true/false): Don't send it if this number got the same text in the last 24 hours.

**Outputs**

- `text` (object): The text

**Example output**

```json
{
  "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 (`agent`, text, required): The JustCall user (agent).
- Available (`available`, true/false, required): On for available, off for unavailable.
- Reason (`unavailability_reason`, text): Why they are unavailable, such as Break. It must be one of the reasons set up in JustCall.

**Outputs**

- `agent_id` (text): The user
- `available` (true/false): Whether they are now available
- `unavailability_reason` (text): The reason given, if unavailable

**Example output**

```json
{
  "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 (`tag`, text, required): The text tag.
- JustCall number (`justcall_number`, text): Your JustCall number the conversation is on. Leave blank for the contact's conversations on every number.
- Contact's number (`contact_number`, text): The contact's phone number with its country code, like +14155550123.
- Thread ID (`thread_id`, text): Or the conversation's thread ID in JustCall, instead of the numbers.

**Outputs**

- `contact_number` (text): The contact's number, if one was given
- `justcall_number` (text): Your number, if one was given
- `tag_id` (text): The tag
- `tagged` (true/false): Always true once tagged
- `thread_id` (text): The thread, if one was given

**Example output**

```json
{
  "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 (`tag`, text, required): The text tag.
- JustCall number (`justcall_number`, text): Your JustCall number the conversation is on. Leave blank for the contact's conversations on every number.
- Contact's number (`contact_number`, text): The contact's phone number with its country code, like +14155550123.
- Thread ID (`thread_id`, text): Or the conversation's thread ID in JustCall, instead of the numbers.

**Outputs**

- `contact_number` (text): The contact's number, if one was given
- `justcall_number` (text): Your number, if one was given
- `tag_id` (text): The tag
- `thread_id` (text): The thread, if one was given
- `untagged` (true/false): Always true once removed

**Example output**

```json
{
  "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_id`, text, required): The call's ID (or its SID), from 'List calls', a trigger or an earlier step.
- Notes (`notes`, text): The call's notes. They replace any there.
- Disposition (`disposition_code`, text): 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 (`rating`, number): A rating from 0 to 5, in steps of 0.5. From 0 to 5.

**Outputs**

- `call` (object): The call

**Example output**

```json
{
  "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_id`, text, required): The contact's ID, from 'List contacts' or an earlier step.
- First name (`first_name`, text): A new first name.
- Phone number (`contact_number`, text): A new main number, with its country code.
- Last name (`last_name`, text): The contact's last name.
- Email (`email`, text): The contact's email address.
- Company (`company`, text): The company they work for.
- Address (`address`, text): Their address.
- Extension (`extension`, number): An extension number for them. At least 0.
- Add a note (`note`, text): A note to add to the contact.

**Outputs**

- `contact` (object): The contact

**Example output**

```json
{
  "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"
      }
    ]
  }
}
```
