Extensions API reference
Last updated: 2026-06-01
Manage extensions on a Drömlik tenant — list, create, edit, delete, and read presence.
Required scope
extension:read, extension:write
Endpoints
| Method | Path | Description |
|---|---|---|
GET | /extension/list | Page through all extensions. |
GET | /extension/get?number=101 | Fetch a single extension by number. |
POST | /extension/create | Create a new extension. |
POST | /extension/update | Update name, email, role, voicemail, forwarding. |
POST | /extension/delete | Delete an extension. |
GET | /extension/presence | Read current presence (Available, Busy, DND, Away). |
POST | /extension/bulk_create | Create up to 200 extensions in one call. |
Example response
{
"errcode": 0,
"total_number": 2,
"data": [
{ "number": "101", "name": "Alice Andersson", "email": "alice@acme.se", "role": "user", "presence": "available" },
{ "number": "102", "name": "Bo Bergman", "email": "bo@acme.se", "role": "user", "presence": "dnd" }
]
}Common errors
40001— Missing or invalid parameter.40301— API key lacks the scope this endpoint requires.40401— Resource not found.50001— Internal error; safe to retry with backoff.