Create accounts

Important: This part of the GraphQL API is currently in Preview status. For more information, see GraphQL API policy.

To create a new account you use the createAccount mutation to specify a company name, the email address for the account's first associated user, and other account characteristics. This mutation is the equivalent of the REST Create new company API.

If the user does not already exist, it is created along with the account. The mutation also creates a new account membership to link the account and user.

The response to the mutation includes the unique identifier (uuid) for the new account. This identifier is required in requests to create users, payment instruments, and subscriptions, and is often referred to as the accountID in those requests. The ID is also required for subscription management queries and mutations.