Get a Tenant

URL: https://api.courier.com/tenants/:tenant_id

Method: GET

Path Parameters:

tenant_idstringrequired

Id of the tenant to be returned.

Response Body:

idstring

Id of the tenant.

namestring

Name of the tenant.

parent_tenant_idstring?

Tenant's parent id (if any).

default_preferencesobject?

Defines the preferences used for the account when the user hasn't specified their own.

propertiesobject?

Arbitrary properties accessible to a template.

user_profileobject?

A user profile object merged with user profile on send.

brand_idstring

Brand to be used for the account when one is not specified by the send call.

Example:

// GET https://api.courier.com/tenant/ACME

// RESPONSE BODY
{
  id: "ACME",
  name: "ACME Inc",
  properties: {
    ceo: "Person",
  },
  default_preferences: {
    items: [{
      status: "OPTED_IN",
      id: "my-topic",
      type: "subscription_topic"
    }]
  },
  user_profile: {
    locale: "en-US",
    "slack": {
      "access_token": "xoxb-bunch-o-letters",
    }
  }
}

Get a Tenant

URL: https://api.courier.com/tenants/:tenant_id

Method: GET

Path Parameters:

tenant_idstringrequired

Id of the tenant to be returned.

Response Body:

Example:

// GET https://api.courier.com/tenants/ACME

// RESPONSE BODY
{
  id: "ACME",
  name: "ACME Inc",
  properties: {
    ceo: "Person",
  },
  default_preferences: {
    items: [{
      status: "OPTED_IN",
      id: "my-topic",
      type: "subscription_topic"
    }]
  },
  user_profile: {
    locale: "en-US",
    "slack": {
      "access_token": "xoxb-bunch-o-letters",
    }
  }
}