Authenticate (inbound)


Retrieve a bearer token to use with the send side API.





The authentication API requires a unique client_id and client_secret provided to you by your account manager for each environment. Authentication is carried out through HTTPS basic auth and returns an access_token that will be used as a bearer token for all subsequent requests. Tokens are valid for 12 hours.



Request Syntax

The request is an empty POST with the client_id and client_secret provided via HTTP Basic Authentication credentials.

Request Parameters

Query String Parameters

The query string must include grant_type=client_credentials

Response Syntax

  "access_token": <string>,
  "token_type": "bearer",
  "expires_in": <integer>,
  "refresh_token": <string>,
  "scope": <empty string>,
  "uid": <string>,
  "info": {
    "name": <string>,
    "email": null,
    "first_name": <string>,
    "last_name": <string>

Response Elements

  • access_token
    • The bearer token to provide for subsequent send side API requests
    • Type: String
  • token_type
    • Type: String
    • This will always be bearer
  • expires_in"
    • Expiration for this token is 12 hours set in seconds (43200)
    • Type: Integer
  • refresh_token
    • Refresh tokens are not currently enabled
    • Type: String
  • scope
    • Access scope for this token (currently an empty string)
  • uid
    • Unique ID for this token
    • Type: String
  • info
    • This will always reflect the service client ("Tenant Integrations Service Client")
    • Type: JSON

Status Codes

  • 200 Success
  • 401 Unauthorized (verify client credentials)
  • 500 Internal server error


Example Request

$ curl -u <client_id>:<client_secret> \
       -X POST \
       --header 'Content-Type: application/json' \

Example Response

  "access_token": "7UkvNeAabPduAvyvu4XEqSCC",
  "token_type": "bearer",
  "expires_in": 43200,
  "refresh_token": "wYwtq6NGie5paAR2XHK6uF1f",
  "scope": "",
  "uid": "f00718ea-3c64-45f1-99de-2ac34cea139a",
  "info": {
    "name": "Tenant Integrations Service Client",
    "email": null,
    "first_name": "Tenant Integrations",
    "last_name": "Service Client"
  "extra": {
    "raw_info": {
      "user_id": "6de65adf-ec20-4f2c-b8b4-0ae3c067c73b",
      "tenant_id": "5323b917-54f9-4866-aec7-67a5f1062be1",
      "tenant_name": "Chuck's Agency",
      "primary_user_group_id": "a621af94-f454-4ffc-b56c-08971630b622",
      "user_group_ids": [
      "name": "Tenant Integrations Service Client",
      "email": null,
      "first_name": "Tenant Integrations",
      "last_name": "Service Client",
      "permissions": [
      "auth_uid": null,
      "completed_steps": []

Note: the access_token as it will be used for authenticating future requests.

results matching ""

    No results matching ""