NYnylas
Authentication APIs

OAuth Token Info

Changed on

Get info about a specific token based on the identifier you include. Use either the ID Token or Access Token.</br></br>Note: Because Nylas uses the schema outlined in RFC 9068 to ensure that it is compatible with all OAuth libraries in all languages, the format for this endpoint is different from the other OAuth endpoints.

get/v3/connect/tokeninfo

Request

  • Base URL
    https://api.us.nylas.com
  • Auth
    • HTTP bearer
    • or HTTP bearer

Query parameters

id_tokenstring

ID token

access_tokenstring

Access token

Response

Returns token info. If you pass the token in the Authorization header instead of a query parameter, Nylas returns the token info object directly, without the request_id and data wrapper.

request_idstring

ID of the request

Example response

{
  "request_id": "5967ca40-a2d8-4ee0-a0e0-6f18ace39a90",
  "data": {
    "iss": "https://nylas.com",
    "aud": "http://localhost:3030",
    "sub": "daf84d88-f274-46cc-bbc9-aed7dac061c7",
    "email": "user@example.com",
    "iat": 1692094848,
    "exp": 1692095173
  }
}

Changes

  • a669a04b02baRevision changes
    • breaking

      the response's property type changed from string to object for status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • info

      added the non-success response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property to the response with the status