Admin Model

Example Object

{
    "type": "admin",
    "id": "493881",
    "name": "Hoban Washburne",
    "email": "wash@serenity.io",
    "job_title": "Philosopher",
    "away_mode_enabled": false,
    "away_mode_reassign": false,
    "has_inbox_seat": true,
    "team_ids": [
        814865
    ],
    "avatar": "https://picsum.photos/200/300"
}

Admin Object

AttributeTypeDescription
typestringValue is admin.
idstringThe id of the admin
namestringThe name of the admin
emailstringThe email address of the admin
job_titlestringThe job title of the admin
away_mode_enabledbooleanIdentifies if this admin is currently set in away mode.
away_mode_reassignbooleanIdentifies if this admin is set to automatically reassign new conversations to the apps default inbox.
has_inbox_seatbooleanIdentifies if a teammate has a paid inbox seat to restrict/allow features that require them
team_idslistThis is a list of teams id's that you are part of
avatarurlImage for the associated team or teammate
Information on `has_inbox_seat`

As inbox seats are a new feature with our new pricing plans, customers not migrated to our new pricing will have has_inbox_seat set to true.

We only check if the teammate making the API call has seats, not the app itself, nor all admins within the app.

If an admin has_inbox_seats set to false, then certain calls will fail, such as:

If it fails, we let the developer know by returning a 403 Forbidden error, alongside a clarifying error code/message such as the one below.

Errors for admins without inbox seats

JSON

{
  "type": "error.list",
  "request_id": "0002miv9og586ig3aln0",
  "errors": [
    {
      "code": "action_forbidden",
      "message": "This admin does not have Inbox access permissions"
    }
  ]
}