Skip to content

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

MethodPathDescription
GET/extension/listPage through all extensions.
GET/extension/get?number=101Fetch a single extension by number.
POST/extension/createCreate a new extension.
POST/extension/updateUpdate name, email, role, voicemail, forwarding.
POST/extension/deleteDelete an extension.
GET/extension/presenceRead current presence (Available, Busy, DND, Away).
POST/extension/bulk_createCreate 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.