Skip to main content
POST
/
v2
/
webrtc
/
tokens
Create a widget token
curl --request POST \
  --url https://api.wavix.com/v2/webrtc/tokens \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "sip_trunk": "my-sip-trunk",
  "ttl": 3600,
  "payload": {
    "user_id": "42"
  }
}
'
{
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "uuid": "uuid",
  "sip_trunk": "sip trunk",
  "payload": {},
  "ttl": 123
}

Authorizations

​
Authorization
string
header
required

Wavix API key. Pass as Authorization: Bearer <api_key>. Keys support per-resource scopes (none / read / write). See Restricted keys and scopes.

Body

application/json

Widget token configuration.

​
sip_trunk
string
required

SIP trunk name

Example:

"my-sip-trunk"

​
ttl
integer | null
required

Time to live in seconds. Pass null for no expiration.

Required range: x >= 1
Example:

3600

​
payload
object

Arbitrary data to be associated with the token

Example:
{}

Response

Widget token created.

​
token
string
required

Wavix Embeddable Widget token.

Example:

"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."

​
uuid
string
required

Token ID

Example:

"550e8400-e29b-41d4-a716-446655440000"

​
sip_trunk
string
required

SIP trunk name

Example:

"my-sip-trunk"

​
payload
object

Arbitrary data associated with the token

Example:
{}
​
ttl
integer | null

Time to live, in seconds

Example:

3600