Loading...
Skip to main content

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",
}
}
}