curl https://api.tracklysms.com/api/v1/voice/agents \
-H "X-Api-Key: trk_your_api_key_here"
{
"agents": [
{
"id": "665f1e2a9c4b1a0012ab34ce",
"name": "Escalations",
"type": "phone",
"number": "14155550111",
"createdAt": "2026-08-21T18:05:00.000000Z"
},
{
"id": "665f1e2a9c4b1a0012ab34cd",
"name": "Front Desk",
"type": "phone",
"number": "14155559876",
"createdAt": "2026-08-21T18:00:00.000000Z"
},
{
"id": "665f1e2a9c4b1a0012ab34cf",
"name": "Salesforce Agent",
"type": "webrtc",
"number": null,
"externalSubject": "salesperson-123",
"createdAt": "2026-08-21T18:10:00.000000Z"
}
]
}
Voice Calls (v1)
List Agents
List account phone agents and browser agents bound to your API key.
GET
/
v1
/
voice
/
agents
curl https://api.tracklysms.com/api/v1/voice/agents \
-H "X-Api-Key: trk_your_api_key_here"
{
"agents": [
{
"id": "665f1e2a9c4b1a0012ab34ce",
"name": "Escalations",
"type": "phone",
"number": "14155550111",
"createdAt": "2026-08-21T18:05:00.000000Z"
},
{
"id": "665f1e2a9c4b1a0012ab34cd",
"name": "Front Desk",
"type": "phone",
"number": "14155559876",
"createdAt": "2026-08-21T18:00:00.000000Z"
},
{
"id": "665f1e2a9c4b1a0012ab34cf",
"name": "Salesforce Agent",
"type": "webrtc",
"number": null,
"externalSubject": "salesperson-123",
"createdAt": "2026-08-21T18:10:00.000000Z"
}
]
}
Returns the account’s phone agents and only the WebRTC agents bound to the authenticated API key, ordered by name without pagination. Another key’s browser agents and subjects are excluded, even within the same account. Existing visible agents remain readable if browser onboarding is later disabled.
Phone agents are reusable destinations you can reference by
id in connectTo when placing, answering, or dequeuing a call. WebRTC agents identify browser users for a separate, unpublished session/call integration; they cannot be used as phone connectTo or monitor destinations. Your backend must still authorize each salesperson’s access rather than treating a shared API key as user-level authorization.
Requires the voice_calls.read scope and the Voice Calls product entitlement.
Response Fields
array
Shared account phone agents and the authenticated key’s WebRTC agents.
Hide Agent properties
Hide Agent properties
string
The agent’s unique identifier. Phone-agent IDs can be used in
connectTo.string
The agent’s label.
string
phone or webrtc.string | null
The normalized phone destination, or
null for a WebRTC agent.string
Included only for a WebRTC agent owned by the calling API key.
string | null
ISO 8601 timestamp when the agent was created.
Examples
curl https://api.tracklysms.com/api/v1/voice/agents \
-H "X-Api-Key: trk_your_api_key_here"
{
"agents": [
{
"id": "665f1e2a9c4b1a0012ab34ce",
"name": "Escalations",
"type": "phone",
"number": "14155550111",
"createdAt": "2026-08-21T18:05:00.000000Z"
},
{
"id": "665f1e2a9c4b1a0012ab34cd",
"name": "Front Desk",
"type": "phone",
"number": "14155559876",
"createdAt": "2026-08-21T18:00:00.000000Z"
},
{
"id": "665f1e2a9c4b1a0012ab34cf",
"name": "Salesforce Agent",
"type": "webrtc",
"number": null,
"externalSubject": "salesperson-123",
"createdAt": "2026-08-21T18:10:00.000000Z"
}
]
}
Error Codes
| Status | Code | Meaning |
|---|---|---|
| 403 | voice_not_entitled | Voice calling is not enabled for your account. |