Add customers to tenants

Add a customer to one or more tenants in a single call.

You can add a customer to multiple tenants.

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

When selecting the customer you can chose how to identify them. You can use the customer’s email, externalId or id.

This operation requires the following permissions:

• customer:edit
• customerTenantMembership:create

Mutation

mutation addCustomerToTenants($input: AddCustomerToTenantsInput!) {
  addCustomerToTenants(input: $input) {
    error {
      message
      type
      code
      fields {
        field
        message
        type
      }
    }
  }
}

Variables

{
  "input": {
    "customerIdentifier": {
      "emailAddress": "[e-mail]"
    },
    "tenantIdentifiers": [
      {
        "externalId": "team_123"
      },
      {
        "externalId": "team_456"
      }
    ]
  }
}