Skip to main content
POST
Create an extension
The extension is the dialed number or extension sent in the Request URI of the SIP INVITE to PolyAI — it selects which agent the call routes to. In the below example, the extension would be 1000:

Authorizations

X-API-Key
string
header
required

Path Parameters

account_id
string
required

ID of the account that owns the SIP Trunk.

trunk_id
string
required

The SIP Trunk ID.

Body

application/json
extension
string
required

The dialed number or extension.

Required string length: 1 - 128
Pattern: \S
agent
object
required

The PolyAI agent to bind an extension to.

Response

The created extension.

An Extension binds a dialed number on a trunk to a PolyAI agent.

extension
string
required

The dialed number or extension.

agent
object
required

The PolyAI agent an extension routes calls to.

created_at
string<date-time>
required

RFC 3339 timestamp of when the extension was created.

updated_at
string<date-time>
required

RFC 3339 timestamp of when the extension was last updated.

Last modified on July 30, 2026