Essential Data Fields

When you POST to your agent’s webhook URL to trigger an outbound call, this is what the endpoint accepts.

Required

Field	Type	Notes
`phone`	string	The number to call. Include the country code — `+14155550132`.
`name`	string	The callee’s name. `full_name` or `fullName` are accepted instead.

Both fields are required. A request without a name is rejected with 400 Bad Request and the message name or full name is required.

Optional

Field	Type	Notes
`full_name`	string	Alias for `name` — satisfies the name requirement
`fullName`	string	Alias for `name` — satisfies the name requirement
`email`	string	Must be a valid email address if supplied

The three name fields are interchangeable aliases — send whichever one your automation tool produces naturally. There’s no need to send more than one, but at least one of them must be present.

Example


{
  "phone": "+14155550132",
  "name": "John Doe",
  "email": "john.doe@example.com"
}

Any additional keys you send — company, notes, booking_ref, anything your automation produces — are stored with the call and passed to the agent as context for that call. Reference them in the prompt or welcome message as {company}, {notes}, and so on. Use single braces and plain word_characters: {{company}} and keys containing a hyphen or a dot are not substituted. If you need per-call variables plus your own metadata echoed back on the completion webhook, use the Calls API.

Using the name in your prompt

The name you send here can be referenced in the agent’s prompt and welcome message as a variable — see How to Write a High-Quality Prompt.

Phone number format

Always include the country code with a + prefix. See Phone Number Formatting.