Sign in
Extension

Issue a provisioning token for extension

Issues a short-lived (10 minute) provisioning token for SIP softphone auto-configuration (Linphone remote provisioning). The response contains the token, the complete public provisioning URL (rendered as a QR code by the admin console), and the expiration timestamp.

Scanning the returned URL with the Linphone mobile app fetches the extension's SIP credentials automatically via GET /provisioning/extension.

Requires CustomerAdmin or CustomerManager permission.

post/extensions/{id}/provisioning-token

Path parameters

idstring uuid required
Example:550e8400-e29b-41d4-a716-446655440000

The unique identifier of the extension. Returned from the GET /extensions response.

Response

Provisioning token issued successfully.

tokenstring

64-character lowercase hexadecimal provisioning token. Generated by api-manager when an authorized agent requests extension provisioning via POST /extensions/{id}/provisioning-token.

urlstring uri

Complete public provisioning URL to be rendered as a QR code. Scanning it with the Linphone mobile app fetches the extension's SIP configuration.

expirestring date-time

Timestamp when the provisioning token expires (10 minutes after issuance).

Example response

{
  "token": "3f7a1c9e5b2d8f04a6c1e9b3d7f2a58c0e4b6d19f83c25a7e1b09d4f6a2c8e35",
  "url": "https://api.voipbin.net/provisioning/extension?token=3f7a1c9e5b2d8f04a6c1e9b3d7f2a58c0e4b6d19f83c25a7e1b09d4f6a2c8e35",
  "expire": "2026-08-24T12:10:00.000000Z"
}