Skip to content
View as Markdown

End a FaceTime call

POST/end-facetime-call-apiBearer token

Request body

call_uuidstringRequired
The call_uuid returned by POST /start-facetime-call-api, or from an inbound FaceTime webhook.
Daily dial limit
Each account may dial up to 40 unique destinations per calendar day (America/Los_Angeles). Redials to a number already called that day do not count. Exceeding the limit returns 429 with error_code: FACETIME_DAILY_LIMIT_REACHED plus uniqueDestinationsToday and limit fields.

Status codes

200
Call started / status returned
400
Invalid pb_line_id or phone_number
401
Missing or invalid API key
403
FACETIME_NOT_ENABLED — FaceTime Audio not enabled on this account
404
Call not found (status/end endpoints)
429
Rate limit exceeded or daily FaceTime dial limit reached
502
Device error placing the call
500
Internal server error
API reference