API ReferenceConversations

Sip Outbound Call

Initiates a SIP outbound call using user-supplied SIP credentials in headers.

Authentication

AuthorizationBearer
Bearer authentication header of the form `Bearer <PHONIC_API_KEY>`. Manage your API keys [here](https://phonic.co/api-keys).

Headers

X-Sip-AddressstringRequired
SIP address of the user's SIP trunk. Required.
X-Sip-Auth-UsernamestringOptional
SIP auth username, if your provider requires it.
X-Sip-Auth-PasswordstringOptional
SIP auth password, if your provider requires it.

Request

This endpoint expects an object.
from_phone_numberstringRequired
Caller ID phone number in E.164 format.
to_phone_numberstringRequired
Destination phone number in E.164 format.
configobjectOptional

When an agent is provided, these config options override the agent settings.

Response

Success response
conversation_idstring
The ID of the created conversation.
twilio_call_sidstring
The Twilio Call SID.

Errors