Call a contact
POST/api/v1/accounts/:account_id/contacts/:id/call
Places an outgoing voice call to the contact through a Twilio inbox and answers with the conversation and provider ids the browser client needs to join the conference.
The inbox has to be one the calling user is assigned to, on a Twilio SMS channel with voice enabled — anything else is not found rather than refused, so an inbox the user cannot reach is indistinguishable from one that does not exist.
Reuses the contact's open conversation on that inbox when there is one, instead of starting a second thread for the same call.
Request
Responses
- 200
- 403
- 404
Ringing
Access denied
Contact not found, or the inbox is not a voice inbox you can reach