Skip to main content

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)
  • dialing_type - Dialing mode: sequence, ring_all or random
  • callhunt - Legacy two-state mirror of dialing_type (boolean); ignored when dialing_type is sent
  • active - Enable/disable this destination (boolean)
  • transport - Transport type code (1 = SIP URI, 4 = Phone number, 5 = SIP device, 10 = Webphone)

Authentication:

  • Requires Bearer token in Authorization header: Authorization: Bearer <token>

Request​

Responses​

Successfully creates destination and returns destination details