Add tenants to tiers

You can add multiple tenants to a tier in a single mutation.

For TypeScript, the GraphQL SDK gives you a fully typed client for these operations.

You can only add tenants to one tier per API call. To add tenants to multiple tiers, re-run the API call providing the other tier identifier. This operation requires the following permissions:

tierMembership:read
tierMembership:create

Query

mutation addMembersToTier($input: AddMembersToTierInput!) {
  addMembersToTier(input: $input) {
    memberships {
      __typename
      ... on TenantTierMembership {
        id
        tenantId
      }
      ... on CompanyTierMembership {
        id
        companyId
      }
    }
    error {
      message
      type
      code
      fields {
        field
        message
        type
      }
    }
  }
}

Variables

{
  "input": {
    "memberIdentifiers": [
      {
        "tenantId": "te_123"
      },
      {
        "companyId": "co_123"
      }
    ],
    "tierIdentifier": { "externalId": "XXX" }
  }
}

GraphQL API

Building Agents

Agent integrations

Webhooks

Channels

Customer Cards

UI Components

Security

Changelog

Add tenants to tiers