CallRail

App · 25 actions

Work with CallRail call tracking: list and read calls with their marketing source, tag and score leads, place calls, send texts, read form submissions and summary reports, and manage companies and tags. Start a workflow when a call comes in or ends, a text arrives or a form is submitted.

Actions

ActionWhat it does
Create companyCreate a company in the account, such as for a new client or location.
Create tagCreate a tag for one company, or (as an admin) for every company in the account.
Delete tagDelete a tag.
Disable companyDisable a company.
Get callGet one call with its caller, source and campaign, tags, note, lead status, recording, and its transcript and summary where the plan includes them.
Get call recordingGet a link to a call's recording as an MP3, to play or save.
Get calls over timeCount calls for each hour, day, week, month or year of a date range, for a chart or a trend.
Get companyGet one company with its time zone, status and tracking settings.
Get text conversationGet one text conversation with its messages, the newest first.
Get tracking numberGet one tracker with its numbers, where calls ring, the source it tracks and whether it can text.
List callsList calls, newest first, with the caller, the marketing source and campaign, tags, note and lead status.
List companiesList the companies in the account, each with its own tracking numbers and settings (an agency has one per client).
List form submissionsList the website form submissions CallRail captured, newest first, with what was filled in and the marketing source.
List tagsList the tags that label calls, texts and form submissions, in one company or across the account.
List text conversationsList text message conversations with customers, the most recent first, each with its last two messages.
List tracking numbersList tracking numbers (CallRail calls them trackers) with the numbers, where calls ring and the source each tracks.
List usersList the people in the CallRail account with their role and the companies they can see.
Place outbound callCall a customer through CallRail: it rings your business number first and, once answered, dials the customer, showing your tracking number.
Send text messageText a customer from one of a company's text-enabled tracking numbers, one to one (CallRail forbids bulk texting).
Summarize callsCount calls over a date range (total, missed, answered, first-time callers, leads, average length), overall and grouped by source, campaign, keyword, referrer, landing page or company.
Summarize form submissionsCount form submissions over a date range (total, first-time, leads), overall and grouped by source, campaign, keyword, referrer, landing page or form.
Update callAdd a note or tags to a call, score it as a good lead or not a lead, set what it was worth, or change the caller's name.
Update companyRename a company, change its time zone, or turn its call transcripts or call scoring on or off.
Update form submissionAdd a note or tags to a form submission, score it as a good lead or not a lead, or set what it was worth.
Update tagRename a tag, change its colour, or disable it so it can't be added any more (it stays where it is).

Create company

Create a company in the account, such as for a new client or location. Add its tracking numbers in CallRail.

Inputs

NamenametextRequired
The company's name.
Time zonetime_zonetext
The company's time zone, such as America/New_York. Defaults to the account's.

Outputs

companyobject
The company
Example output
{
  "company": {
    "callscore_enabled": false,
    "callscribe_enabled": false,
    "created_at": "2016-06-06T07:06:01.000Z",
    "disabled_at": null,
    "dni_active": true,
    "form_capture": true,
    "id": "COM8154748ae6bd4e278a7cddd38a662f4f",
    "lead_scoring_enabled": true,
    "name": "Widget Shop",
    "premium_ci_enabled": false,
    "script_url": "//cdn.callrail.com/companies/183570817/5706dbe6dc972c634a65/12/swap.js",
    "status": "active",
    "swap_cookie_duration": 6,
    "swap_cookie_duration_unit": "months",
    "time_zone": "America/New_York"
  }
}

Create tag

Create a tag for one company, or (as an admin) for every company in the account.

Inputs

NamenametextRequired
The tag's name.
Companycompany_idtext
The company the tag is for. Needed unless the tag is for every company.
Colourcolortext
The tag's colour in CallRail.One of: gray1 (Gray 1), gray2 (Gray 2), blue1 (Blue 1), blue2 (Blue 2), cyan1 (Cyan 1), cyan2 (Cyan 2), purple1 (Purple 1), purple2 (Purple 2), pink1 (Pink 1), pink2 (Pink 2), and 14 more.
Fortag_leveltext
One company (default), or every company in the account.One of: company (One company), account (Every company in the account). Default: company.

Outputs

tagobject
The tag
Example output
{
  "tag": {
    "background_color": "gray1",
    "color": "gray1",
    "company_id": "COM8154748ae6bd4e278a7cddd38a662f4f",
    "created_at": "2017-07-24T11:13:47.366-04:00",
    "id": 993186,
    "name": "Existing Customer",
    "status": "enabled",
    "tag_level": "company"
  }
}

Delete tag

Delete a tag. It is removed from every call, text and form submission that has it. To keep it on those, disable it with 'Update tag' instead.

Inputs

Tag IDtag_idtextRequired
The tag's ID, from 'List tags' or 'Create tag'.

Outputs

deletedtrue/false
Always true once deleted
tag_idtext
The tag deleted
Example output
{
  "deleted": true,
  "tag_id": "993186"
}

Disable company

Disable a company. Its tracking numbers stop working and its website script turns off. An account's only company can't be disabled.

Inputs

Companycompany_idtextRequired
The CallRail company. Pick one, or give its ID from an earlier step.

Outputs

company_idtext
The company disabled
disabledtrue/false
Always true once done
Example output
{
  "company_id": "COM8154748ae6bd4e278a7cddd38a662f4f",
  "disabled": true
}

Get call

Get one call with its caller, source and campaign, tags, note, lead status, recording, and its transcript and summary where the plan includes them.

Inputs

Call IDcall_idtextRequired
The call's ID (it starts with CAL), from 'List calls' or a trigger.

Outputs

callobject
The call
Example output
{
  "call": {
    "agent_email": "gil@example.com",
    "answered": true,
    "business_phone_number": "+14045556666",
    "call_summary": "The caller asked for a quote to repair two widgets.",
    "call_type": "answered",
    "campaign": "US_branded",
    "company_id": "COM8154748ae6bd4e278a7cddd38a662f4f",
    "company_name": "Widget Shop",
    "created_at": "2026-11-03T11:27:48.119-05:00",
    "customer_city": "Denver",
    "customer_country": "US",
    "customer_name": "Jimmy Pesto",
    "customer_phone_number": "+13036231131",
    "customer_state": "CO",
    "direction": "inbound",
    "duration": 184,
    "first_call": true,
    "gclid": "12345abgdef",
    "id": "CAL8154748ae6bd4e278a7cddd38a662f4f",
    "keywords": "widget repair",
    "landing_page_url": "https://www.example.com/repair",
    "lead_score": "very good",
    "lead_status": "good_lead",
    "medium": "cpc",
    "milestones": {
      "first_touch": {
        "medium": "cpc",
        "source": "Google Ads"
      }
    },
    "note": "Wants a quote by Friday",
    "person_id": "PER8154748ae6bd4e278a7cddd38a662f4f",
    "recording": "https://api.callrail.com/v3/a/227799611/calls/111222333/recording.json",
    "recording_duration": "180",
    "recording_player": "https://app.callrail.com/calls/111222333/recording?access_key=3b91",
    "referring_url": "https://www.google.com/",
    "sentiment": "positive",
    "source": "Google Ads",
    "source_name": "Google Paid",
    "start_time": "2026-11-03T11:27:48.119-05:00",
    "tags": [
      {
        "color": "blue2",
        "name": "Sales"
      }
    ],
    "timeline_url": "https://app.callrail.com/a/227799611/timeline/PER8154",
    "tracker_id": "TRK8154748ae6bd4e278a7cddd38a662f4f",
    "tracking_phone_number": "+13038163491",
    "transcription": "Agent: Thanks for calling Widget Shop...",
    "utm_campaign": "US_branded",
    "utm_medium": "cpc",
    "utm_source": "google",
    "value": "250.00",
    "voicemail": false
  }
}

Get call recording

Get a link to a call's recording as an MP3, to play or save. Fails if the call wasn't recorded.

Inputs

Call IDcall_idtextRequired
The call's ID (it starts with CAL), from 'List calls' or a trigger.

Outputs

call_idtext
The call
urltext
A link to the MP3
Example output
{
  "call_id": "CAL8154748ae6bd4e278a7cddd38a662f4f",
  "url": "https://app.callrail.com/calls/CAL11df32690b7d46/recording/redirect?access_key=241sa242sadqwerty123"
}

Get calls over time

Count calls for each hour, day, week, month or year of a date range, for a chart or a trend. At most 200 points: use a longer interval for a long range.

Inputs

Companycompany_idtext
Only this company. Leave empty for every company in the account.
Intervalintervaltext
How long each point covers. Defaults to a day.One of: hour, day (Day (default)), week, month, year.
Date rangedate_rangetext
A named range. Ignored when a start or end date is given. Defaults to the last 7 days, including today.One of: recent (Last 7 days, including today (default)), today, yesterday, last_7_days (Last 7 days, not including today), last_30_days (Last 30 days, not including today), this_month (This month), last_month (Last month), this_year (This year), last_year (Last year), all_time (All time (the last 25 months)).
Fromstart_datedate
Only from this date on (in the account's time zone).
Untilend_datedate
Only up to and including this date.
Totalsfieldslist
Which totals to get. Defaults to total calls only.One or more of: total_calls (Total calls), missed_calls (Missed calls), answered_calls (Answered calls), first_time_callers (First-time callers), average_duration (Average length (seconds)), formatted_average_duration (Average length (formatted)), leads.
Directiondirectiontext
Only calls from customers (inbound) or to them (outbound).One of: inbound, outbound.
Answeredanswer_statustext
Only answered calls, missed calls or calls that went to voicemail.One of: answered, missed, voicemail.
Devicedevicetext
Only callers who came from a desktop or a mobile website visit.One of: desktop, mobile.
Lead statuslead_statustext
Only good leads, those marked not a lead, or those not scored yet.One of: good_lead (Good lead), not_a_lead (Not a lead), not_scored (Not scored).

Outputs

datalist
One set of totals per interval, each with its 'date'
end_datetext
End of the range reported
start_datetext
Start of the range reported
time_zonetext
The time zone of the dates
total_resultsobject
The totals asked for, such as total_calls
Example output
{
  "data": [
    {
      "date": "2026-10-01",
      "total_calls": 30
    },
    {
      "date": "2026-10-02",
      "total_calls": 20
    }
  ],
  "end_date": "2026-10-02T23:59:59-0400",
  "start_date": "2026-10-01T00:00:00-0400",
  "time_zone": "America/New_York",
  "total_results": {
    "total_calls": 50
  }
}

Get company

Get one company with its time zone, status and tracking settings.

Inputs

Companycompany_idtextRequired
The CallRail company. Pick one, or give its ID from an earlier step.

Outputs

companyobject
The company
Example output
{
  "company": {
    "callscore_enabled": false,
    "callscribe_enabled": false,
    "created_at": "2016-06-06T07:06:01.000Z",
    "disabled_at": null,
    "dni_active": true,
    "form_capture": true,
    "id": "COM8154748ae6bd4e278a7cddd38a662f4f",
    "lead_scoring_enabled": true,
    "name": "Widget Shop",
    "premium_ci_enabled": false,
    "script_url": "//cdn.callrail.com/companies/183570817/5706dbe6dc972c634a65/12/swap.js",
    "status": "active",
    "swap_cookie_duration": 6,
    "swap_cookie_duration_unit": "months",
    "time_zone": "America/New_York"
  }
}

Get text conversation

Get one text conversation with its messages, the newest first.

Inputs

Conversation IDconversation_idtextRequired
The conversation's ID, from 'List text conversations' or a text trigger.

Outputs

conversationobject
The conversation
messageslist
Its messages, newest first
Example output
{
  "conversation": {
    "company_id": "COM8154748ae6bd4e278a7cddd38a662f4f",
    "company_time_zone": "America/New_York",
    "current_tracker_id": "TRK8154748ae6bd4e278a7cddd38a662f4f",
    "current_tracking_number": "+14045556677",
    "customer_name": "Kevin Mann",
    "customer_phone_number": "+14042223333",
    "id": "KZaGR",
    "initial_tracker_id": "TRK8154748ae6bd4e278a7cddd38a662f4f",
    "initial_tracking_number": "+14045556677",
    "last_message_at": "2026-11-03T19:28:21.578Z",
    "lead_status": null,
    "recent_messages": [
      {
        "content": "Thanks, we can come by on Tuesday.",
        "created_at": "2026-11-03T19:28:21.578Z",
        "direction": "outgoing",
        "media_urls": [],
        "type": "sms"
      },
      {
        "content": "Can someone look at my widget this week?",
        "created_at": "2026-11-03T19:26:43.578Z",
        "direction": "incoming",
        "media_urls": [],
        "type": "sms"
      }
    ],
    "source": "Google Organic",
    "state": "active"
  },
  "messages": [
    {
      "content": "Can someone look at my widget this week?",
      "created_at": "2026-11-03T19:26:43.578Z",
      "direction": "incoming",
      "id": 23456,
      "media_urls": [],
      "status": null,
      "type": "sms",
      "user": null
    }
  ]
}

Get tracking number

Get one tracker with its numbers, where calls ring, the source it tracks and whether it can text.

Inputs

Tracking numbertracker_idtextRequired
The tracker. Pick one, or give its ID (it starts with TRK).

Outputs

trackerobject
The tracker
Example output
{
  "tracker": {
    "call_flow": {
      "recording_enabled": true,
      "type": "basic"
    },
    "campaign_name": "Billboard",
    "company": {
      "id": "COM8154748ae6bd4e278a7cddd38a662f4f",
      "name": "Widget Shop"
    },
    "created_at": "2011-07-05T19:06:10Z",
    "destination_number": "+15553104554",
    "disabled_at": null,
    "id": "TRK8154748ae6bd4e278a7cddd38a662f4f",
    "name": "My Billboard",
    "sms_enabled": true,
    "sms_supported": true,
    "source": {
      "type": "offline"
    },
    "status": "active",
    "tracking_numbers": [
      "+14045559999"
    ],
    "type": "source",
    "whisper_message": null
  }
}

List calls

List calls, newest first, with the caller, the marketing source and campaign, tags, note and lead status. Filter by company, tracking number, dates, direction, answer, lead status or tag. Gets one page; run it again with the next page to see more.

Inputs

Companycompany_idtext
Only this company. Leave empty for every company in the account.
Tracking numbertracker_idtext
Only calls to this tracking number.
Date rangedate_rangetext
A named range. Ignored when a start or end date is given. Defaults to the last 7 days, including today.One of: recent (Last 7 days, including today (default)), today, yesterday, last_7_days (Last 7 days, not including today), last_30_days (Last 30 days, not including today), this_month (This month), last_month (Last month), this_year (This year), last_year (Last year), all_time (All time (the last 25 months)).
Fromstart_datedate
Only from this date on (in the account's time zone).
Untilend_datedate
Only up to and including this date.
Directiondirectiontext
Only calls from customers (inbound) or to them (outbound).One of: inbound, outbound.
Answeredanswer_statustext
Only answered calls, missed calls or calls that went to voicemail.One of: answered, missed, voicemail.
Lead statuslead_statustext
Only good leads, those marked not a lead, or those not scored yet.One of: good_lead (Good lead), not_a_lead (Not a lead), not_scored (Not scored).
Devicedevicetext
Only callers who came from a desktop or a mobile website visit.One of: desktop, mobile.
Tagstagslist
Only those with any of these tags, by name.
Searchsearchtext
Only calls whose caller's name or number, note or source contains this.
Pagepagenumber
Which page to get, starting at 1. Defaults to the first.At least 1.
Page sizeper_pagenumber
How many to get, 1 to 250. CallRail's default is 100.From 1 to 250.

Outputs

callslist
The calls
countnumber
How many are on this page
has_moretrue/false
Whether there is a next page (run again with page + 1)
pagenumber
This page's number
total_pagesnumber
How many pages there are
total_recordsnumber
How many there are in all
Example output
{
  "calls": [
    {
      "agent_email": "gil@example.com",
      "answered": true,
      "business_phone_number": "+14045556666",
      "call_type": "answered",
      "campaign": "US_branded",
      "company_id": "COM8154748ae6bd4e278a7cddd38a662f4f",
      "company_name": "Widget Shop",
      "created_at": "2026-11-03T11:27:48.119-05:00",
      "customer_city": "Denver",
      "customer_country": "US",
      "customer_name": "Jimmy Pesto",
      "customer_phone_number": "+13036231131",
      "customer_state": "CO",
      "direction": "inbound",
      "duration": 184,
      "first_call": true,
      "gclid": "12345abgdef",
      "id": "CAL8154748ae6bd4e278a7cddd38a662f4f",
      "keywords": "widget repair",
      "landing_page_url": "https://www.example.com/repair",
      "lead_status": "good_lead",
      "medium": "cpc",
      "note": "Wants a quote by Friday",
      "person_id": "PER8154748ae6bd4e278a7cddd38a662f4f",
      "recording": "https://api.callrail.com/v3/a/227799611/calls/111222333/recording.json",
      "recording_duration": "180",
      "recording_player": "https://app.callrail.com/calls/111222333/recording?access_key=3b91",
      "referring_url": "https://www.google.com/",
      "source": "Google Ads",
      "source_name": "Google Paid",
      "start_time": "2026-11-03T11:27:48.119-05:00",
      "tags": [
        {
          "color": "blue2",
          "name": "Sales"
        }
      ],
      "timeline_url": "https://app.callrail.com/a/227799611/timeline/PER8154",
      "tracker_id": "TRK8154748ae6bd4e278a7cddd38a662f4f",
      "tracking_phone_number": "+13038163491",
      "utm_campaign": "US_branded",
      "utm_medium": "cpc",
      "utm_source": "google",
      "value": "250.00",
      "voicemail": false
    }
  ],
  "count": 1,
  "has_more": false,
  "page": 1,
  "total_pages": 1,
  "total_records": 1
}

List companies

List the companies in the account, each with its own tracking numbers and settings (an agency has one per client). Gets one page; run it again with the next page to see more.

Inputs

Statusstatustext
Only active or only disabled companies.One of: active, disabled.
Searchsearchtext
Only companies whose name contains this.
Pagepagenumber
Which page to get, starting at 1. Defaults to the first.At least 1.
Page sizeper_pagenumber
How many to get, 1 to 250. CallRail's default is 100.From 1 to 250.

Outputs

companieslist
The companies
countnumber
How many are on this page
has_moretrue/false
Whether there is a next page (run again with page + 1)
pagenumber
This page's number
total_pagesnumber
How many pages there are
total_recordsnumber
How many there are in all
Example output
{
  "companies": [
    {
      "callscore_enabled": false,
      "callscribe_enabled": false,
      "created_at": "2016-06-06T07:06:01.000Z",
      "disabled_at": null,
      "dni_active": true,
      "form_capture": true,
      "id": "COM8154748ae6bd4e278a7cddd38a662f4f",
      "lead_scoring_enabled": true,
      "name": "Widget Shop",
      "premium_ci_enabled": false,
      "script_url": "//cdn.callrail.com/companies/183570817/5706dbe6dc972c634a65/12/swap.js",
      "status": "active",
      "swap_cookie_duration": 6,
      "swap_cookie_duration_unit": "months",
      "time_zone": "America/New_York"
    }
  ],
  "count": 1,
  "has_more": false,
  "page": 1,
  "total_pages": 1,
  "total_records": 1
}

List form submissions

List the website form submissions CallRail captured, newest first, with what was filled in and the marketing source. Gets one page; run it again with the next page to see more.

Inputs

Companycompany_idtext
Only this company. Leave empty for every company in the account.
Date rangedate_rangetext
A named range. Ignored when a start or end date is given. Defaults to the last 7 days, including today.One of: recent (Last 7 days, including today (default)), today, yesterday, last_7_days (Last 7 days, not including today), last_30_days (Last 30 days, not including today), this_month (This month), last_month (Last month), this_year (This year), last_year (Last year), all_time (All time (the last 25 months)).
Fromstart_datedate
Only from this date on (in the account's time zone).
Untilend_datedate
Only up to and including this date.
Lead statuslead_statustext
Only good leads, those marked not a lead, or those not scored yet.One of: good_lead (Good lead), not_a_lead (Not a lead), not_scored (Not scored).
Tagstagslist
Only those with any of these tags, by name.
Pagepagenumber
Which page to get, starting at 1. Defaults to the first.At least 1.
Page sizeper_pagenumber
How many to get, 1 to 250. CallRail's default is 100.From 1 to 250.

Outputs

countnumber
How many are on this page
form_submissionslist
The submissions
has_moretrue/false
Whether there is a next page (run again with page + 1)
pagenumber
This page's number
total_pagesnumber
How many pages there are
total_recordsnumber
How many there are in all
Example output
{
  "count": 1,
  "form_submissions": [
    {
      "campaign": "back_to_school",
      "company_id": "COM8154748ae6bd4e278a7cddd38a662f4f",
      "company_name": "Widget Shop",
      "customer_email": "graham@example.com",
      "customer_name": "Graham Armstrong",
      "customer_phone_number": "+19999999999",
      "first_form": true,
      "form_data": {
        "email": "graham@example.com",
        "name": "Graham Armstrong"
      },
      "form_name": "Appointment request",
      "form_url": "https://www.example.com/appointment",
      "id": "FOR8154748ae6bd4e278a7cddd38a662f4f",
      "keywords": "widget repair",
      "landing_page_url": "https://www.example.com/appointment?campaign=back_to_school",
      "lead_status": null,
      "medium": "CPC",
      "note": null,
      "person_id": "PER8154748ae6bd4e278a7cddd38a662f4f",
      "referrer": "google_paid",
      "referring_url": "https://www.google.com/",
      "source": "Google Ads",
      "submitted_at": "2026-11-03T07:46:28.000Z",
      "tags": [],
      "timeline_url": "https://app.callrail.com/a/227799611/timeline/PER8154",
      "utm_campaign": "back_to_school",
      "utm_medium": "cpc",
      "utm_source": "google",
      "value": null
    }
  ],
  "has_more": false,
  "page": 1,
  "total_pages": 1,
  "total_records": 1
}

List tags

List the tags that label calls, texts and form submissions, in one company or across the account. Gets one page; run it again with the next page to see more.

Inputs

Companycompany_idtext
Only this company's tags.
Statusstatustext
Only enabled or only disabled tags.One of: enabled, disabled.
Leveltag_leveltext
Only tags for one company, or only those for every company in the account.One of: company (One company), account (Every company in the account).
Pagepagenumber
Which page to get, starting at 1. Defaults to the first.At least 1.
Page sizeper_pagenumber
How many to get, 1 to 250. CallRail's default is 100.From 1 to 250.

Outputs

countnumber
How many are on this page
has_moretrue/false
Whether there is a next page (run again with page + 1)
pagenumber
This page's number
tagslist
The tags
total_pagesnumber
How many pages there are
total_recordsnumber
How many there are in all
Example output
{
  "count": 1,
  "has_more": false,
  "page": 1,
  "tags": [
    {
      "background_color": "gray1",
      "color": "gray1",
      "company_id": "COM8154748ae6bd4e278a7cddd38a662f4f",
      "created_at": "2017-07-24T11:13:47.366-04:00",
      "id": 993186,
      "name": "Existing Customer",
      "status": "enabled",
      "tag_level": "company"
    }
  ],
  "total_pages": 1,
  "total_records": 1
}

List text conversations

List text message conversations with customers, the most recent first, each with its last two messages. Gets one page; run it again with the next page to see more.

Inputs

Companycompany_idtext
Only this company. Leave empty for every company in the account.
Date rangedate_rangetext
A named range. Ignored when a start or end date is given. Defaults to the last 7 days, including today.One of: recent (Last 7 days, including today (default)), today, yesterday, last_7_days (Last 7 days, not including today), last_30_days (Last 30 days, not including today), this_month (This month), last_month (Last month), this_year (This year), last_year (Last year), all_time (All time (the last 25 months)).
Fromstart_datedate
Only from this date on (in the account's time zone).
Untilend_datedate
Only up to and including this date.
Searchsearchtext
Only conversations with this customer name or number.
Pagepagenumber
Which page to get, starting at 1. Defaults to the first.At least 1.
Page sizeper_pagenumber
How many to get, 1 to 250. CallRail's default is 100.From 1 to 250.

Outputs

conversationslist
The conversations
countnumber
How many are on this page
has_moretrue/false
Whether there is a next page (run again with page + 1)
pagenumber
This page's number
total_pagesnumber
How many pages there are
total_recordsnumber
How many there are in all
Example output
{
  "conversations": [
    {
      "company_id": "COM8154748ae6bd4e278a7cddd38a662f4f",
      "company_time_zone": "America/New_York",
      "current_tracker_id": "TRK8154748ae6bd4e278a7cddd38a662f4f",
      "current_tracking_number": "+14045556677",
      "customer_name": "Kevin Mann",
      "customer_phone_number": "+14042223333",
      "id": "KZaGR",
      "initial_tracker_id": "TRK8154748ae6bd4e278a7cddd38a662f4f",
      "initial_tracking_number": "+14045556677",
      "last_message_at": "2026-11-03T19:28:21.578Z",
      "lead_status": null,
      "recent_messages": [
        {
          "content": "Thanks, we can come by on Tuesday.",
          "created_at": "2026-11-03T19:28:21.578Z",
          "direction": "outgoing",
          "media_urls": [],
          "type": "sms"
        },
        {
          "content": "Can someone look at my widget this week?",
          "created_at": "2026-11-03T19:26:43.578Z",
          "direction": "incoming",
          "media_urls": [],
          "type": "sms"
        }
      ],
      "source": "Google Organic",
      "state": "active"
    }
  ],
  "count": 1,
  "has_more": false,
  "page": 1,
  "total_pages": 1,
  "total_records": 1
}

List tracking numbers

List tracking numbers (CallRail calls them trackers) with the numbers, where calls ring and the source each tracks. Gets one page; run it again with the next page to see more.

Inputs

Companycompany_idtext
Only this company. Leave empty for every company in the account.
Typetracker_typetext
Only source trackers or only website session pools.One of: source (Source (one number per marketing source)), session (Website session (a pool of numbers)).
Statusstatustext
Only active or only disabled tracking numbers.One of: active, disabled.
Searchsearchtext
Only tracking numbers whose name contains this.
Pagepagenumber
Which page to get, starting at 1. Defaults to the first.At least 1.
Page sizeper_pagenumber
How many to get, 1 to 250. CallRail's default is 100.From 1 to 250.

Outputs

countnumber
How many are on this page
has_moretrue/false
Whether there is a next page (run again with page + 1)
pagenumber
This page's number
total_pagesnumber
How many pages there are
total_recordsnumber
How many there are in all
trackerslist
The tracking numbers
Example output
{
  "count": 1,
  "has_more": false,
  "page": 1,
  "total_pages": 1,
  "total_records": 1,
  "trackers": [
    {
      "call_flow": {
        "recording_enabled": true,
        "type": "basic"
      },
      "campaign_name": "Billboard",
      "company": {
        "id": "COM8154748ae6bd4e278a7cddd38a662f4f",
        "name": "Widget Shop"
      },
      "created_at": "2011-07-05T19:06:10Z",
      "destination_number": "+15553104554",
      "disabled_at": null,
      "id": "TRK8154748ae6bd4e278a7cddd38a662f4f",
      "name": "My Billboard",
      "sms_enabled": true,
      "sms_supported": true,
      "source": {
        "type": "offline"
      },
      "status": "active",
      "tracking_numbers": [
        "+14045559999"
      ],
      "type": "source",
      "whisper_message": null
    }
  ]
}

List users

List the people in the CallRail account with their role and the companies they can see. Gets one page; run it again with the next page to see more.

Inputs

Companycompany_idtext
Only people who can see this company.
Searchsearchtext
Only people whose name or email contains this.
Pagepagenumber
Which page to get, starting at 1. Defaults to the first.At least 1.
Page sizeper_pagenumber
How many to get, 1 to 250. CallRail's default is 100.From 1 to 250.

Outputs

countnumber
How many are on this page
has_moretrue/false
Whether there is a next page (run again with page + 1)
pagenumber
This page's number
total_pagesnumber
How many pages there are
total_recordsnumber
How many there are in all
userslist
The users
Example output
{
  "count": 1,
  "has_more": false,
  "page": 1,
  "total_pages": 1,
  "total_records": 1,
  "users": [
    {
      "accepted": true,
      "companies": [
        {
          "id": "COM8154748ae6bd4e278a7cddd38a662f4f",
          "name": "Widget Shop"
        }
      ],
      "created_at": "2011-04-06T16:38:27.505-04:00",
      "email": "kevin@example.com",
      "first_name": "Kevin",
      "id": "USR8154748ae6bd4e278a7cddd38a662f4f",
      "last_name": "Mann",
      "name": "Kevin Mann",
      "role": "admin"
    }
  ]
}

Place outbound call

Call a customer through CallRail: it rings your business number first and, once answered, dials the customer, showing your tracking number. US and Canadian numbers only.

Inputs

Show ascaller_idtextRequired
The tracking number (or verified caller ID) the customer sees calling them.
Business phonebusiness_phone_numbertextRequired
The phone that rings first, such as your desk or mobile.
Customer phonecustomer_phone_numbertextRequired
The customer's number, such as (404) 555-1234.
Record the callrecording_enabledtrue/false
Record the call. Make sure the customer is told.Default: false.
Greetingoutbound_greeting_texttext
Words read to the customer when they answer.
Agentagent_idtext
The CallRail user the call is assigned to.

Outputs

callobject
The call
Example output
{
  "call": {
    "agent_email": "gil@example.com",
    "answered": null,
    "business_phone_number": "+14045556666",
    "call_type": "outbound",
    "campaign": "US_branded",
    "company_id": "COM8154748ae6bd4e278a7cddd38a662f4f",
    "company_name": "Widget Shop",
    "created_at": "2026-11-03T11:27:48.119-05:00",
    "customer_city": "Denver",
    "customer_country": "US",
    "customer_name": "Jimmy Pesto",
    "customer_phone_number": "+13036231131",
    "customer_state": "CO",
    "direction": "outbound",
    "duration": null,
    "first_call": true,
    "gclid": "12345abgdef",
    "id": "CAL8154748ae6bd4e278a7cddd38a662f4f",
    "keywords": "widget repair",
    "landing_page_url": "https://www.example.com/repair",
    "lead_status": "good_lead",
    "medium": "cpc",
    "note": "Wants a quote by Friday",
    "person_id": "PER8154748ae6bd4e278a7cddd38a662f4f",
    "recording": "https://api.callrail.com/v3/a/227799611/calls/111222333/recording.json",
    "recording_duration": "180",
    "recording_player": "https://app.callrail.com/calls/111222333/recording?access_key=3b91",
    "referring_url": "https://www.google.com/",
    "source": "Google Ads",
    "source_name": "Google Paid",
    "start_time": "2026-11-03T11:27:48.119-05:00",
    "tags": [
      {
        "color": "blue2",
        "name": "Sales"
      }
    ],
    "timeline_url": "https://app.callrail.com/a/227799611/timeline/PER8154",
    "tracker_id": "TRK8154748ae6bd4e278a7cddd38a662f4f",
    "tracking_phone_number": "+13038163491",
    "utm_campaign": "US_branded",
    "utm_medium": "cpc",
    "utm_source": "google",
    "value": "250.00",
    "voicemail": false
  }
}

Send text message

Text a customer from one of a company's text-enabled tracking numbers, one to one (CallRail forbids bulk texting). US and Canadian numbers only; the number must be registered for texting.

Inputs

Companycompany_idtextRequired
The CallRail company. Pick one, or give its ID from an earlier step.
Fromtracking_numbertextRequired
The company's tracking number to text from.
Tocustomer_phone_numbertextRequired
The customer's mobile number, such as (404) 555-1234.
MessagecontenttextRequired
The text. The first text to someone gets opt-out words (such as Reply STOP) added unless it has them.
Picture linkmedia_urltext
A public https:// link to an image to send with it, as a picture message.

Outputs

conversationobject
The text conversation
Example output
{
  "conversation": {
    "company_id": "COM8154748ae6bd4e278a7cddd38a662f4f",
    "company_time_zone": "America/New_York",
    "current_tracker_id": "TRK8154748ae6bd4e278a7cddd38a662f4f",
    "current_tracking_number": "+14045556677",
    "customer_name": "Kevin Mann",
    "customer_phone_number": "+14042223333",
    "id": "KZaGR",
    "initial_tracker_id": "TRK8154748ae6bd4e278a7cddd38a662f4f",
    "initial_tracking_number": "+14045556677",
    "last_message_at": "2026-11-03T19:28:21.578Z",
    "lead_status": null,
    "recent_messages": [
      {
        "content": "Thanks, we can come by on Tuesday.",
        "created_at": "2026-11-03T19:28:21.578Z",
        "direction": "outgoing",
        "media_urls": [],
        "type": "sms"
      },
      {
        "content": "Can someone look at my widget this week?",
        "created_at": "2026-11-03T19:26:43.578Z",
        "direction": "incoming",
        "media_urls": [],
        "type": "sms"
      }
    ],
    "source": "Google Organic",
    "state": "active"
  }
}

Summarize calls

Count calls over a date range (total, missed, answered, first-time callers, leads, average length), overall and grouped by source, campaign, keyword, referrer, landing page or company.

Inputs

Companycompany_idtext
Only this company. Leave empty for every company in the account.
Group bygroup_bytext
Totals for each source, campaign and so on.One of: source, keywords, campaign, referrer, landing_page (Landing page), company.
Date rangedate_rangetext
A named range. Ignored when a start or end date is given. Defaults to the last 7 days, including today.One of: recent (Last 7 days, including today (default)), today, yesterday, last_7_days (Last 7 days, not including today), last_30_days (Last 30 days, not including today), this_month (This month), last_month (Last month), this_year (This year), last_year (Last year), all_time (All time (the last 25 months)).
Fromstart_datedate
Only from this date on (in the account's time zone).
Untilend_datedate
Only up to and including this date.
Totalsfieldslist
Which totals to get. Defaults to total calls only.One or more of: total_calls (Total calls), missed_calls (Missed calls), answered_calls (Answered calls), first_time_callers (First-time callers), average_duration (Average length (seconds)), formatted_average_duration (Average length (formatted)), leads.
Directiondirectiontext
Only calls from customers (inbound) or to them (outbound).One of: inbound, outbound.
Answeredanswer_statustext
Only answered calls, missed calls or calls that went to voicemail.One of: answered, missed, voicemail.
Devicedevicetext
Only callers who came from a desktop or a mobile website visit.One of: desktop, mobile.
Lead statuslead_statustext
Only good leads, those marked not a lead, or those not scored yet.One of: good_lead (Good lead), not_a_lead (Not a lead), not_scored (Not scored).

Outputs

end_datetext
End of the range reported
grouped_bytext
What the results are grouped by
grouped_resultslist
One set of totals per group, each with its 'key' (a source, say)
start_datetext
Start of the range reported
time_zonetext
The time zone of the dates
total_resultsobject
The totals asked for, such as total_calls
Example output
{
  "end_date": "2026-10-31T23:59:59-0400",
  "grouped_by": "source",
  "grouped_results": [
    {
      "key": "Google Ads",
      "total_calls": 130
    },
    {
      "key": "Billboard Ad",
      "total_calls": 30
    }
  ],
  "start_date": "2026-10-01T00:00:00-0400",
  "time_zone": "America/New_York",
  "total_results": {
    "total_calls": 160
  }
}

Summarize form submissions

Count form submissions over a date range (total, first-time, leads), overall and grouped by source, campaign, keyword, referrer, landing page or form.

Inputs

Companycompany_idtext
Only this company. Leave empty for every company in the account.
Group bygroup_bytext
Totals for each source, form and so on.One of: source, keywords, campaign, referrer, landing_page (Landing page), form_name (Form name).
Date rangedate_rangetext
A named range. Ignored when a start or end date is given. Defaults to the last 7 days, including today.One of: recent (Last 7 days, including today (default)), today, yesterday, last_7_days (Last 7 days, not including today), last_30_days (Last 30 days, not including today), this_month (This month), last_month (Last month), this_year (This year), last_year (Last year), all_time (All time (the last 25 months)).
Fromstart_datedate
Only from this date on (in the account's time zone).
Untilend_datedate
Only up to and including this date.
Totalsfieldslist
Which totals to get. Defaults to total form submissions only.One or more of: total_forms (Total form submissions), first_forms (First-time submissions), leads.
Lead statuslead_statustext
Only good leads, those marked not a lead, or those not scored yet.One of: good_lead (Good lead), not_a_lead (Not a lead), not_scored (Not scored).

Outputs

end_datetext
End of the range reported
grouped_bytext
What the results are grouped by
grouped_resultslist
One set of totals per group, each with its 'key' (a source, say)
start_datetext
Start of the range reported
time_zonetext
The time zone of the dates
total_resultsobject
The totals asked for, such as total_calls
Example output
{
  "end_date": "2026-10-31T23:59:59-0400",
  "grouped_by": "source",
  "grouped_results": [
    {
      "first_forms": 15,
      "key": "direct",
      "total_forms": 130
    },
    {
      "first_forms": 4,
      "key": "google_paid",
      "total_forms": 30
    }
  ],
  "start_date": "2026-10-01T00:00:00-0400",
  "time_zone": "America/New_York",
  "total_results": {
    "first_forms": 19,
    "leads": 46,
    "total_forms": 160
  }
}

Update call

Add a note or tags to a call, score it as a good lead or not a lead, set what it was worth, or change the caller's name. Only the fields given change.

Inputs

Call IDcall_idtextRequired
The call's ID (it starts with CAL), from 'List calls' or a trigger.
Notenotetext
A note to keep on the call. It replaces any note already there.
Tagstagslist
Tag names to add to the call. A tag the company doesn't have yet is created.
Replace existing tagsreplace_tagstrue/false
Off (default): the tags are added to the ones already there. On: they replace them.Default: false.
Lead statuslead_statustext
Score it as a good lead or not a lead.One of: good_lead (Good lead), not_a_lead (Not a lead).
Valuevaluetext
What the call is worth, such as 125.00.
Caller namecustomer_nametext
The caller's name, replacing the caller ID name.

Outputs

callobject
The call
Example output
{
  "call": {
    "agent_email": "gil@example.com",
    "answered": true,
    "business_phone_number": "+14045556666",
    "call_type": "answered",
    "campaign": "US_branded",
    "company_id": "COM8154748ae6bd4e278a7cddd38a662f4f",
    "company_name": "Widget Shop",
    "created_at": "2026-11-03T11:27:48.119-05:00",
    "customer_city": "Denver",
    "customer_country": "US",
    "customer_name": "Jimmy Pesto",
    "customer_phone_number": "+13036231131",
    "customer_state": "CO",
    "direction": "inbound",
    "duration": 184,
    "first_call": true,
    "gclid": "12345abgdef",
    "id": "CAL8154748ae6bd4e278a7cddd38a662f4f",
    "keywords": "widget repair",
    "landing_page_url": "https://www.example.com/repair",
    "lead_status": "good_lead",
    "medium": "cpc",
    "note": "Wants a quote by Friday",
    "person_id": "PER8154748ae6bd4e278a7cddd38a662f4f",
    "recording": "https://api.callrail.com/v3/a/227799611/calls/111222333/recording.json",
    "recording_duration": "180",
    "recording_player": "https://app.callrail.com/calls/111222333/recording?access_key=3b91",
    "referring_url": "https://www.google.com/",
    "source": "Google Ads",
    "source_name": "Google Paid",
    "start_time": "2026-11-03T11:27:48.119-05:00",
    "tags": [
      {
        "color": "blue2",
        "name": "Sales"
      }
    ],
    "timeline_url": "https://app.callrail.com/a/227799611/timeline/PER8154",
    "tracker_id": "TRK8154748ae6bd4e278a7cddd38a662f4f",
    "tracking_phone_number": "+13038163491",
    "utm_campaign": "US_branded",
    "utm_medium": "cpc",
    "utm_source": "google",
    "value": "250.00",
    "voicemail": false
  }
}

Update company

Rename a company, change its time zone, or turn its call transcripts or call scoring on or off. Only the fields given change.

Inputs

Companycompany_idtextRequired
The CallRail company. Pick one, or give its ID from an earlier step.
Namenametext
A new name. Leave empty to keep it.
Time zonetime_zonetext
A new time zone, such as America/Chicago. Leave empty to keep it.
Transcripts and call highlightscallscribetext
Turn CallRail's call transcripts on or off.One of: on, off.
Call scoringcallscoretext
Turn CallRail's call scoring (CallScore) on or off.One of: on, off.

Outputs

companyobject
The company
Example output
{
  "company": {
    "callscore_enabled": false,
    "callscribe_enabled": false,
    "created_at": "2016-06-06T07:06:01.000Z",
    "disabled_at": null,
    "dni_active": true,
    "form_capture": true,
    "id": "COM8154748ae6bd4e278a7cddd38a662f4f",
    "lead_scoring_enabled": true,
    "name": "Widget Shop Downtown",
    "premium_ci_enabled": false,
    "script_url": "//cdn.callrail.com/companies/183570817/5706dbe6dc972c634a65/12/swap.js",
    "status": "active",
    "swap_cookie_duration": 6,
    "swap_cookie_duration_unit": "months",
    "time_zone": "America/New_York"
  }
}

Update form submission

Add a note or tags to a form submission, score it as a good lead or not a lead, or set what it was worth. Only the fields given change.

Inputs

Form submission IDform_submission_idtextRequired
The submission's ID (it starts with FOR), from 'List form submissions' or a trigger.
Notenotetext
A note to keep on the form submission. It replaces any note already there.
Tagstagslist
Tag names to add to the form submission. A tag the company doesn't have yet is created.
Replace existing tagsreplace_tagstrue/false
Off (default): the tags are added to the ones already there. On: they replace them.Default: false.
Lead statuslead_statustext
Score it as a good lead or not a lead.One of: good_lead (Good lead), not_a_lead (Not a lead).
Valuevaluetext
What the form submission is worth, such as 125.00.

Outputs

form_submissionobject
The submission
Example output
{
  "form_submission": {
    "campaign": "back_to_school",
    "company_id": "COM8154748ae6bd4e278a7cddd38a662f4f",
    "company_name": "Widget Shop",
    "customer_email": "graham@example.com",
    "customer_name": "Graham Armstrong",
    "customer_phone_number": "+19999999999",
    "first_form": true,
    "form_data": {
      "email": "graham@example.com",
      "name": "Graham Armstrong"
    },
    "form_name": "Appointment request",
    "form_url": "https://www.example.com/appointment",
    "id": "FOR8154748ae6bd4e278a7cddd38a662f4f",
    "keywords": "widget repair",
    "landing_page_url": "https://www.example.com/appointment?campaign=back_to_school",
    "lead_status": null,
    "medium": "CPC",
    "note": null,
    "person_id": "PER8154748ae6bd4e278a7cddd38a662f4f",
    "referrer": "google_paid",
    "referring_url": "https://www.google.com/",
    "source": "Google Ads",
    "submitted_at": "2026-11-03T07:46:28.000Z",
    "tags": [],
    "timeline_url": "https://app.callrail.com/a/227799611/timeline/PER8154",
    "utm_campaign": "back_to_school",
    "utm_medium": "cpc",
    "utm_source": "google",
    "value": null
  }
}

Update tag

Rename a tag, change its colour, or disable it so it can't be added any more (it stays where it is). A new name shows everywhere the tag is.

Inputs

Tag IDtag_idtextRequired
The tag's ID, from 'List tags' or 'Create tag'.
Namenametext
A new name. Leave empty to keep it.
Colourcolortext
The tag's colour in CallRail.One of: gray1 (Gray 1), gray2 (Gray 2), blue1 (Blue 1), blue2 (Blue 2), cyan1 (Cyan 1), cyan2 (Cyan 2), purple1 (Purple 1), purple2 (Purple 2), pink1 (Pink 1), pink2 (Pink 2), and 14 more.
Statusstatustext
Enable the tag, or disable it for new calls and texts.One of: enabled, disabled.

Outputs

tagobject
The tag
Example output
{
  "tag": {
    "background_color": "gray1",
    "color": "gray1",
    "company_id": "COM8154748ae6bd4e278a7cddd38a662f4f",
    "created_at": "2017-07-24T11:13:47.366-04:00",
    "id": 993186,
    "name": "Returning Customer",
    "status": "enabled",
    "tag_level": "company"
  }
}

On this page