> For the complete documentation index, see [llms.txt](https://docs.chord.co/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.chord.co/chord-oms/chord-oms-overview/users/creating-users.md). # Creating Users ### Introduction Users are created in the Chord OMS under four conditions: 1. An admin user is created in the admin panel. 2. A customer purchases for the first time 3. The developer calls the create user endpoint with an email address. Please take a look at this [document](https://chord.stoplight.io/docs/chord-oms/7fcc571bffd15-create-user) to learn more about creating a user. 4. A valid JWT issued by the store's `AUTH_PROVIDER` performs an API operation against the API with a sub value of an email address not currently in the OMS's user store. There are two kinds of users: internal and external, usually referred customers. This article will walk you through creating both and clarify how they are linked in the Chord system. {% hint style="danger" %} Chord is unaware of the customer's auth provider mechanics, nor does Chord create users in non-Chord OMS systems. {% endhint %} ### Internal vs. External users Internal users (**Team**) have a relationship with and within your company, either through employment or as partners who deliver your product or service to the end user, the external customer. An external user is a person who is only directly connected to your organization by purchasing your product or service. External customers are also known as **customers**. ### Creating Internal User An internal user, such as an employee or agency partner, usually needs to access the OMS. Log in to Chord OMS and click **Team** on the left panel. ![](https://3559351341-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGejRW1RLC9yasX56Xzxu%2Fuploads%2Fgit-blob-2d57a3ae85d54611dc75e53700be613b52694613%2Fcreating-users-1.jpg?alt=media) Click **Invite User** Provide their email address and click **Invite to join** ![](https://3559351341-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGejRW1RLC9yasX56Xzxu%2Fuploads%2Fgit-blob-9304e8e0a81b3b2c4741c5b3a1982abe06d1dae9%2Fcreating-users-2.jpg?alt=media) Once they receive the email and login for the first time, a form will appear, prompting them to input their names. You can check whether they have established their account and accessed the Team page. **Pending** = has not created the account just yet ![](https://3559351341-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGejRW1RLC9yasX56Xzxu%2Fuploads%2Fgit-blob-ccc073f3eb73500b8d1fe35963adf2a272177d55%2Fcreating-users-3.jpg?alt=media) A date will appear in front of the user's name once they have successfully logged in ![](https://3559351341-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGejRW1RLC9yasX56Xzxu%2Fuploads%2Fgit-blob-fae940dc1ce6eeeb8076d27f08540a44c13fb40d%2Fcreating-users-4.jpg?alt=media) {% hint style="info" %} An internal user can also be a Customer and will appear as such on the Customer's page, but a customer will not appear on the Team's page. The Team's page is for internal users only. {% endhint %} ### Creating an external user (customer) If you need to manually create an order for a customer who has never placed one in your store before, you have two options: **Option 1** is to create a new customer from within the Chord OMS. Click **Customers** on the left menu and click **New Customers** Provide\*\* Email, Password, **and** Role, **and click** Create \*\* ![Option 2 is placing the order manually, automatically creating the customer.](https://3559351341-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGejRW1RLC9yasX56Xzxu%2Fuploads%2Fgit-blob-b2f88535f693d5137fff30b5132e76bd09de8639%2Fcreating-users-5.jpg?alt=media) {% hint style="info" %} Your customer will be able to see their orders in **My Account** in your front-end store (given that they are using the same email address you placed the order with) {% endhint %} **Option 2** is creating a manual order to create a new customer record. {% hint style="warning" %} In both options, the password is exclusive to the OMS admin and will not affect the passwordless authentication to your Store. {% endhint %} {% hint style="success" %} If you have any questions or need help, please reach out to us at {% endhint %} --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.chord.co/chord-oms/chord-oms-overview/users/creating-users.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.