Viewing the current admin and app

๐Ÿ“˜

OAuth only

This feature is only available when using OAuth. This requires the "Read admins" permission.

You can view the name, email and app ID of the current authorised admin via a GET request to https://api.intercom.io/me.

Returns

An Admin model, with an embedded App object.

AttributeTypeDescription
typestringvalue is 'admin'
idstringThe id of the admin
namestringThe name of the admin
emailstringThe email address of the admin
email_verifiedbooleanThis field will indicate whether the Intercom user has verified their email or not
app.typestringvalue is 'app'
app.id_codestringThe id of the app
app.namestringThe name of the app
app.created_attimestampWhen the app was created
app.identity_verificationbooleanWhether or not the app uses identity verification

๐Ÿšง

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 user logging, in you should not accept any sign ins from users with unverified email addresses as it poses a potential impersonation security risk.