GET YOUR_SUBDOMAIN.auth.marketingcloudapis.com/v2/userinfo
Gets information for the account and user that are associated with the access token. Supply the access token in the authorization header. User information includes the account name, email, and ID. Account information includes the member ID (MID) and enterprise ID (EID). Application information includes REST and SOAP base URIs, redirect URIs, and scopes. Permission information includes the permission name and ID. Review REST API Permission IDs and Scopes.
Status | Name | Type | Description |
---|---|---|---|
200 | Response contains information about the account and user associated with the supplied access token. | ||
exp | integer | UNIX timestamp when the access token expires. | |
iss | string | Issuer URI | |
user | object | User information | |
user.sub | string | Employee ID of the user. If view=oidc is specified in the request, this value is https://mc.auth.marketingcloudapis.com/uid/<employee_id> | |
user.name | string | User’s Marketing Cloud username. | |
user.preferred_username | string | User’s Marketing Cloud user ID. | |
user.email | string | Email address associated with the user’s Marketing Cloud account. | |
user.locale | string | Account user’s language and country codes. | |
user.zoneinfo | string | Principal city in the user’s time zone. Example: Europe/London. | |
user.timezone | object | User's time zone information. | |
user.timezone.longName | string | Friendly name of the user’s time zone. | |
user.timezone.shortName | string | Code for the user’s time zone, in UTC. | |
user.timezone.offset | double | Coordinated Universal Time (UTC) offset. | |
user.timezone.dst | boolean | Indicates whether daylight time is applied to the user’s time zone setting. | |
organization | object | Organization information. | |
organization.member_id | integer | Marketing Cloud account member ID. | |
organization.enterprise_id | integer | Marketing Cloud top-level account enterprise ID. | |
organization.enterprise_name | string | Name of the top-level Marketing Cloud enterprise account. | |
organization.account_type | string | Type of account. Possible values are core, reseller, tiered, and enterprise. | |
organization.stack_key | string | Marketing Cloud server instance that the account is on. | |
organization.region | string | The account’s data center region. Possible values are NA1 and EU1. | |
organization.locale | string | Language and country code for the top-level account. | |
organization.zoneinfo | string | Principal city in the top-level account’s time zone. Example: Europe/London. | |
organization.timezone | object | Top-level account’s time zone information. | |
organization.timezone.longName | string | Friendly name of the time zone for the top-level account. | |
organization.timezone.shortName | string | Code for the top-level account’s time zone code, in UTC. | |
organization.timezone.offset | double | Coordinated Universal Time (UTC) offset. | |
organization.timezone.dst | boolean | Indicates whether daylight time is applied to the top-level account’s time zone setting. | |
rest | object | Base URIs | |
rest.rest_instance_url | string | REST base URI | |
rest.soap_instance_url | string | SOAP base URI | |
application | object | Application information | |
application.id | string | Application’s package ID. | |
application.name | string | Application’s package name. | |
application.redirectUrl | array | URIs set for the application in the package. | |
application.appScopes | array | Package scopes supported for the application. | |
permissions | object | Permissions information | |
permissions.objectTypeName | string | Name of the type of object permission. Example: Email. | |
permissions.operationName | string | Name of the permission operation. Example: Update. | |
permissions.name | string | Permission name | |
permissions.id | integer | Permission ID. Review REST API Permission IDs and Scopes. | |
400 | Missing access token. | ||
error | string | Invalid request. Missing access token. | |
error_description | string | Make sure that the authorization header isn’t empty or null. | |
error_uri | string | https://developer.salesforce.com/docs/atlas.en-us.mc-apis.meta/mc-apis/error-handling.htm | |
401 | Invalid access token or tenant-specific endpoint. | ||
error | string | Access token or authentication TSE provided is invalid. | |
error_description | string | Invalid access token or not authorized to use this authentication base URI. Use your authentication base URI found in Marketing Cloud Installed Packages. Don’t use exacttargetapis.com. | |
error_uri | string | https://developer.salesforce.com/docs/atlas.en-us.mc-apis.meta/mc-apis/error-handling.htm |