---
title: "Issue a provisioning token for extension"
method: POST
path: "/extensions/{id}/provisioning-token"
tags: ["Extension"]
---

# Issue a provisioning token for extension

`POST /extensions/{id}/provisioning-token`

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.

## Path parameters

- `id` string, uuid, required

## Response `200`

Provisioning token issued successfully.

- ApiManagerExtensionProvisioningToken — Short-lived provisioning token for SIP softphone auto-configuration (Linphone remote provisioning). Returned from the `POST /extensions/{id}/provisioning-token` response.
  - `token` string — 64-character lowercase hexadecimal provisioning token. Generated by api-manager when an authorized agent requests extension provisioning via `POST /extensions/{id}/provisioning-token`.
  - `url` string, 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.
  - `expire` string, date-time — Timestamp when the provisioning token expires (10 minutes after issuance).

## Other responses

- `400` — Invalid request (INVALID_ARGUMENT).
- `401` — Authentication required (UNAUTHENTICATED).
- `403` — Insufficient permission (PERMISSION_DENIED).
- `404` — Resource not found (NOT_FOUND).
- `500` — Internal error (INTERNAL).

---

[API](https://skmtc.net/voipbin/apis/voipbin-api.md) · [All operations](https://skmtc.net/voipbin/apis/voipbin-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/voipbin/voipbin-api/revisions/48dafc7da0a6/schema)