v51

latestOpenAPI 3.0.1MITraw.githubusercontent.com2026-08-01150230854.3 KB

Admins

Identify an admin

You can view the currently authorised admin along with the embedded app object (a "workspace" in legacy terminology).

🚧 Single Sign On

If you are building a custom "Log in with Intercom" flow for your site, and you call the /me endpoint to identify the logged-in user, you should not accept any sign-ins from users with unverified email addresses as it poses a potential impersonation security risk.

get/me

Headers

Intercom-Version'1.0' | '1.1' | '1.2' | '1.3' | '1.4' | '2.0' | '2.1' | '2.2' | '2.3' | '2.4' | '2.5' | '2.6' | '2.7' | '2.8' | '2.9' | '2.10' | '2.11' | '2.12' | '2.13' | '2.14'

Intercom API version.</br>By default, it's equal to the version set in the app package.

Example:2.14

Response

Successful response

typestring

String representing the object's type. Always has the value admin.

idstring

The id representing the admin.

namestring

The name of the admin.

emailstring

The email of the admin.

job_titlestring

The job title of the admin.

away_mode_enabledboolean

Identifies if this admin is currently set in away mode.

away_mode_reassignboolean

Identifies if this admin is set to automatically reassign new conversations to the apps default inbox.

has_inbox_seatboolean

Identifies if this admin has a paid inbox seat to restrict/allow features that require them.

team_idsinteger[]

This is a list of ids of the teams that this admin is part of.

email_verifiedboolean nullable

Identifies if this admin's email is verified.

Example response

{
  "type": "admin",
  "id": "1295",
  "name": "Joe Example",
  "email": "jdoe@example.com",
  "job_title": "Associate",
  "has_inbox_seat": true,
  "team_ids": [
    814865
  ],
  "avatar": {
    "type": "avatar",
    "image_url": "https://example.com/avatar.png"
  },
  "email_verified": true,
  "app": {
    "type": "app",
    "id_code": "xyz789",
    "name": "ACME",
    "region": "US",
    "timezone": "America/Los_Angeles",
    "created_at": 1671465577
  }
}