Create users

A user represents an individual end-user in a marketplace. Each user must be a member of at least one account. The following sections outline how to create a user in a new account/company using REST and GraphQL APIs.

Create a user (REST)

User accounts are a core resource in the AppDirect platform linked to one or more company memberships. Every marketplace user must be a member of at least one company. Therefore, it is not possible to create users without any company information. You can use the following requests to create users in AppDirect marketplaces:

• To create the first user in a new company, see Create new company.
• To create a user as a member of an existing company, see Create company membership.

Create a user (GraphQL)

Users are initially identified with a unique email address, which is used to create the user definition. The marketplace generates an internal identifier for each new user. Most API calls will use the internal identifier to refer to the user, although some may still use the email (see Create accounts and Create account memberships).

Every marketplace user must be a member of at least one account, so each user is linked to one or more account memberships. It is impossible to create users on their own without any account information—there is no mutation for creating a user directly.

Instead, you must either create a user as the first user of a new account or include it in a new account membership for an existing account:

• To create the first user in a new account, see Create accounts.
• To create a user as a member of an existing account, see Create account memberships.