Update account tier

If you want to explicitly set the tier for an account you can do so using this mutation. If instead you want to add many accounts to a tier at once, you can use the add members mutation.

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

This operation requires the following permissions:

tierMembership:read
tierMembership:create

Mutation

mutation updateAccountTier($input: UpdateAccountTierInput!) {
  updateAccountTier(input: $input) {
    accountTierMembership {
      id
      tierId
    }
    error {
      message
      type
      code
      fields {
        field
        message
        type
      }
    }
  }
}

Variables

{
  "input": {
    "accountIdentifier": {
      "externalId": "XXX"
    },

    "tierIdentifier": {
      "externalId": "XXX"
    }
  }
}

GraphQL API

Building Agents

Agent integrations

Webhooks

Channels

Customer Cards

UI Components

Security

Changelog