/v1/comms/calls/dialPlace a call from a record
Dial one of a record's phone numbers through the workspace's connected dialer. The call lands in the call log immediately as an outbound entry, and the dialer's own status callback moves it from ringing to connected to ended with a duration. A number that asked us to stop is refused with 409 and the same sentence a text gets. Body: definitionId and rowId (the record — both required, the call is filed under it) and phone (required — the number to dial, one of that record's phone cells; read the record first). It needs the workspace's Orum dialer connected (Settings › Integrations): without it every dial answers 422 "its Orum integration is not connected" — say so and stop, a different record will not change it.
Access class: workspace.
Send request
Use the documented inputs to call this endpoint directly.
Request body
application/jsonrequiredResponses
the action's answer
{
"call": {
"ai_summary": "string",
"answered_at": "2026-01-01T00:00:00Z",
"duration_seconds": 1,
"ended_at": "2026-01-01T00:00:00Z",
"provider": "string",
"recording_count": 1,
"recording_url": "string",
"result": "string",
"started_at": "2026-01-01T00:00:00Z",
"transcript": "string"
},
"content": "string",
"content_html": "string",
"conversation_id": 1,
"delivered_at": "2026-01-01T00:00:00Z",
"delivery": {
"attempts": 1,
"claimed_at": "2026-01-01T00:00:00Z",
"claimed_by": "string",
"error": "string",
"next_attempt_at": "2026-01-01T00:00:00Z",
"settled_at": "2026-01-01T00:00:00Z",
"state": "string"
},
"direction": "string",
"external_id": "",
"id": 1,
"is_deleted": true,
"medium": "string",
"no_advertising": true,
"occurred_at": "2026-01-01T00:00:00Z",
"parent_message_id": 1,
"read_at": "2026-01-01T00:00:00Z",
"recorded_at": "2026-01-01T00:00:00Z",
"sender_id": 1,
"sender_name": "string",
"sender_type": "string",
"source_provider": "string",
"status": "string",
"subject": "string",
"text": {
"error_code": "string",
"error_message": "string",
"media_count": 1,
"provider": "string",
"segment_count": 1
}
}an RFC3339 instant with its offset, such as ; a bare date, a time with no offset, or words like "tomorrow" are not instants
an RFC3339 instant with its offset, such as ; a bare date, a time with no offset, or words like "tomorrow" are not instants
an RFC3339 instant with its offset, such as ; a bare date, a time with no offset, or words like "tomorrow" are not instants
an RFC3339 instant with its offset, such as ; a bare date, a time with no offset, or words like "tomorrow" are not instants
a refusal: {"error": "<what a person needs to read>"}. 401 no credential, 402 the plan does not include this, 403 the seat does not, 404 the thing does not exist or is not yours to see.
{
"error": "string"
}