openclaw-workspace/skills/api-gateway/references/callrail.md

CallRail Routing Reference

App name: callrail Base URL proxied: api.callrail.com

API Path Pattern

/callrail/v3/a/{account_id}/{resource}.json

Important: All CallRail API endpoints end with .json. Account IDs start with ACC.

Common Endpoints

Accounts

List Accounts

GET /callrail/v3/a.json

Get Account

GET /callrail/v3/a/{account_id}.json

Companies

List Companies

GET /callrail/v3/a/{account_id}/companies.json

Get Company

GET /callrail/v3/a/{account_id}/companies/{company_id}.json

Calls

List Calls

GET /callrail/v3/a/{account_id}/calls.json

Query parameters: page, per_page, date_range, start_date, end_date, company_id, tracker_id, search, fields, sort, order

Get Call

GET /callrail/v3/a/{account_id}/calls/{call_id}.json

Update Call

PUT /callrail/v3/a/{account_id}/calls/{call_id}.json
Content-Type: application/json

{
  "customer_name": "John Smith",
  "note": "Follow up scheduled",
  "lead_status": "good_lead"
}

Call Summary

GET /callrail/v3/a/{account_id}/calls/summary.json

Call Timeseries

GET /callrail/v3/a/{account_id}/calls/timeseries.json

Trackers

List Trackers

GET /callrail/v3/a/{account_id}/trackers.json

Get Tracker

GET /callrail/v3/a/{account_id}/trackers/{tracker_id}.json

Tags

List Tags

GET /callrail/v3/a/{account_id}/tags.json

Create Tag

POST /callrail/v3/a/{account_id}/tags.json
Content-Type: application/json

{
  "name": "New Tag",
  "tag_level": "account",
  "color": "blue1"
}

Update Tag

PUT /callrail/v3/a/{account_id}/tags/{tag_id}.json
Content-Type: application/json

{
  "name": "Updated Name",
  "color": "green1"
}

Delete Tag

DELETE /callrail/v3/a/{account_id}/tags/{tag_id}.json

Users

List Users

GET /callrail/v3/a/{account_id}/users.json

Get User

GET /callrail/v3/a/{account_id}/users/{user_id}.json

Integrations

List Integrations

GET /callrail/v3/a/{account_id}/integrations.json?company_id={company_id}

Notifications

List Notifications

GET /callrail/v3/a/{account_id}/notifications.json

ID Prefixes

• Account IDs: ACC
• Company IDs: COM
• Call IDs: CAL
• Tracker IDs: TRK
• User IDs: USR

Pagination

Uses offset-based pagination with page and per_page parameters:

GET /callrail/v3/a/{account_id}/calls.json?page=2&per_page=50
# Response includes page, per_page, total_pages, total_records

For calls endpoint, relative pagination is available via relative_pagination=true.

Notes

• All endpoints end with .json
• Communication records retained for 25 months
• Rate limits: 1,000/hour, 10,000/day for general API
• ISO 8601 date format with timezone

Resources

• CallRail API Documentation
• CallRail Help Center - API