Update company tier - Plain Docs

If you want to explicitly set the tier for a company you can do so using this mutation. If instead you want to add many companies to a tier at once, you can use the add members mutation. For this mutation you need the following permissions:

tierMembership:read
tierMembership:create

Typescript SDK
GraphQL

import { PlainClient } from '@team-plain/typescript-sdk';

const client = new PlainClient({ apiKey: 'plainApiKey_xxx' });

const res = await client.updateCompanyTier({
  companyIdentifier: {
    companyDomainName: 'acme.com',

    // Or the company id if you prefer
    // companyId: 'co_123'
  },

  tierIdentifier: {
    externalId: 'XXX',

    // Or the tier id:
    // tierId: "tier_123"
  },
});

if (res.error) {
  console.error(res.error);
} else {
  console.log(res.data);
}

Mutation

mutation updateCompanyTier($input: UpdateCompanyTierInput!) {
  updateCompanyTier(input: $input) {
    companyTierMembership {
      id
      tierId
    }
    error {
      message
      type
      code
      fields {
        field
        message
        type
      }
    }
  }
}

Variables

{
  "input": {
    "companyIdentifier": {
      "companyDomainName": "acme.com"
    },
    "tierIdentifier": {
      "externalId": "XXX"
    }
  }
}