Skip to main content
POST
cURL
Only customers who lease numbers that support FaceTime Audio can use this endpoint.
Phone numbers must be in E.164 format with country codes. to can also be a FaceTime email.
Dialing creates a call in queued and fires facetime.call.initiated. When the remote side starts ringing, status becomes ringing and Contiguity fires facetime.call.ringing. If you omit from, Contiguity picks one of your leased FaceTime Audio numbers at random. caller_id is optional and is presented as Maybe: caller_id to the recipient. If not provided, it will be a formatted version of your leased number, e.g., Maybe: +1 (415) 555-1234 The response is the same call object returned by Get a call. At dial time link is null, participants is [], and duration is null.

Join as the number

webrtc.join opens the call as the Contiguity FaceTime Audio line — not a third participant.

FaceTime Web

Once Apple creates it, link is a FaceTime Web URL. Opening it joins the call in the browser as a web participant.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
to
string
required

Recipient's phone number (E.164) or FaceTime email.

Example:

"+15125550100"

from
string | null

Your leased FaceTime Audio number. If omitted, a random FaceTime Audio number of yours is used.

Example:

"+18005551234"

caller_id
string | null

Optional caller ID to present in the call. Appears as 'Maybe: caller_id'.

Example:

"Tesla Support"

Response

Place an outbound FaceTime Audio call

id
string
required
Example:

"req_xxxxxxxxxxxxxxxx"

timestamp
number
required
Example:

1790548280377

api_version
string
required
Example:

"v2026.9.27"

object
string
required
Example:

"response"

data
object
required