Create destination
POST/api/v1/purchases/:purchase_id/destinations
Add a new inbound destination for a DID number.
Destination Types:
- SIP addresses (e.g.,
sip:[email protected]) - Phone numbers (e.g.,
18005551234) - Extensions (SIP accounts created within didlogic)
Parameters:
destination- The forwarding target (SIP URI or phone number)callhunt- Enable sequential ringing (boolean)active- Enable/disable this destination (boolean)transport- SIP transport protocol (udp, tcp, tls)
Authentication:
- Requires Bearer token in Authorization header:
Authorization: Bearer <token>
Request
Responses
- 200
- 403
- 404
- 422
Successfully creates destination and returns destination details
Returns 403 error when API token is incorrect
Returns 404 error when DID number does not exist or is not owned by user
Returns 422 error with validation messages when destination is incorrect