# Add a company

> Create a B2B company by hand in Data Platform › Companies with the Company Id your own systems use.

Use the **Add Company** form to create a single B2B company by hand. If your shop already knows its companies, send them through the [B2B API](https://releva.ai/documentation/reference/companies/overview/#create-or-update-companies) instead; the API also accepts custom fields, which the form does not.

## Before you start

* You know the **Company Id**: the id your own systems use for this company. Events, orders and roles your shop sends with a `companyId` are linked to the company through this id, so it has to be the same value.
* You have a contact email for the company. The form requires it.
* Your plan includes the Companies page.

## Steps

1. In the left menu, select **Data Platform › Companies**.

   ![Step 1](https://releva.ai/documentation/_astro/step-1.DEr04siY_trDBa.webp)

2. Select **Add Company**.

   The button is disabled until the list has loaded.

   ![Step 2](https://releva.ai/documentation/_astro/step-2.CiP5fxsK_Z2vMz6S.webp)

3. Enter the **Company Id** (the ID your own systems use for this company), **Name**, **Email** and, optionally, **Phone number**.

   **Company Id** and **Email** are required, although only **Company Id** has an asterisk. **Save** stays disabled until **Company Id** has a value. Enter the phone number with the country code, for example `+15555550125`; the form does not check or change the number.

   ![Step 3](https://releva.ai/documentation/_astro/step-3.Cdudfs-g_1uEkkY.webp)

4. Optionally, type a tag in **Tags** and press Enter.

   Repeat for each tag. Select the `×` on a tag to remove it.

   ![Step 4](https://releva.ai/documentation/_astro/step-4.wK-IdXYR_y81Jm.webp)

5. Select **Save**.

   Releva returns to the Companies list.

   ![Step 5](https://releva.ai/documentation/_astro/step-5.CZI-BR56_Z1qRsy6.webp)

6. Search for the Company ID to check that the company was added.

   The company can take a few seconds to appear.

   ![Step 6](https://releva.ai/documentation/_astro/step-6.BjZ7kfAA_1kG3D8.webp)

## Check it worked

* A search for the Company ID shows the new company with the name, email and phone number you entered.
* Open the company: the `#` line on the card shows the Company Id.
* The browser tab title on the form reads **Releva | Companies | New**.

## Troubleshooting

**Save is disabled.** **Company Id** is empty. Enter the id first.

**The browser says “Please fill out this field” or asks for an @ in the email.** The form requires an email address. Enter a valid address and select **Save** again.

**The company is not in the list after Save.** Companies are written a few seconds after you save. Open **Companies** again or search for the Company ID a few seconds later.

**I used a Company Id that already exists.** Saving replaces the existing company with what you entered; there is no warning. Custom fields that were sent through the API are removed. Search for the id before you add a company.

**I need custom fields on the company.** The form has no custom fields. Send the company through the API with a `custom` object. See [Create or update companies](https://releva.ai/documentation/reference/companies/overview/#create-or-update-companies).

**I need to link people to the company.** There is no form for that. Use the roles API. See [Link profiles to companies](https://releva.ai/documentation/reference/companies/overview/#link-profiles-to-companies).

## Next steps

* [Find a company and see its activity](https://releva.ai/documentation/guides/companies/find-a-company/): Search for the company and see its details, linked profiles and statistics.
* [Edit or delete a company](https://releva.ai/documentation/guides/companies/edit-a-company/): Change a company’s name, contact details or tags, or delete it.
* [Companies and roles](https://releva.ai/documentation/learn/companies/companies-and-roles/): Learn how people are linked to companies and how updates and deletes behave.
* [B2B API overview](https://releva.ai/documentation/reference/companies/overview/): Create companies and roles from your own systems, with a working request for each endpoint.