> ## Documentation Index
> Fetch the complete documentation index at: https://docs.m3ter.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Creating and Managing External Mappings for Accounts

When you integrate your 3rd-party external systems with the m3ter platform, external system  entities and fields are mapped to m3ter entities and fields. *External Mappings* are created and act as mapping reference lookups for which entities and fields have been mapped across two or more systems.

As you set up and configure integrations, you might want to review, create, and manage the External Mappings created for a specific Account:

* You can review the mappings created for an Account on the **Overview** tab of the Account's page, where they are listed under the **Account metadata** panel.
* You can also create new External Mappings for the Account from panel.

<Tip>
  **Tip: External Mappings for your Integrations?** You can create and manage all External Mappings for your Integrations from the main **Integrations>External Mappings** page, including those that reference your m3ter Accounts - see [Creating and Managing External Mappings](/guides/integrations/setting-up-integrations/creating-and-managing-external-mappings).
</Tip>

**To create and manage External mappings for an Account:**

1. Select **Accounts**. The **Accounts** page opens
2. Select the **Name** text of the Account you want to review or create External mappings for. The **Account** page opens with the **Overview** tab selected.
3. Scroll down the page to **Account metadata**.
4. Select **External mappings**:

<img src="https://mintcdn.com/m3ter/97v2-eCLZ5ulkdC5/images/ExtMapping70.png?fit=max&auto=format&n=97v2-eCLZ5ulkdC5&q=85&s=04ce5dfddc5728d4d9ca410342f524ff" alt="Ext Mapping70" width="896" height="355" data-path="images/ExtMapping70.png" />

* The **External system** and **External table** mapped to are shown - such as **Xero - Contact**  in the above example. The **External entity ID** mapped to is also shown.
* If a listed External mapping is linked to an Integration, under **Linked integration** a hotlink text will be shown which you can use to open the Integration.
* Under **Actions**, you can edit or delete the External mapping.
* If the Account has multiple External mappings created for it, you can use *Search external mappings* to search by **External table** and **External entity ID** and filter the list.

5. Select **Create** **external mapping**.

* Alternatively, on the **Account actions** menu, select **External mappings>Create external mapping**:

<img src="https://mintcdn.com/m3ter/03osooeLKFU5Y0yI/images/1732732459-extmapping40a.png?fit=max&auto=format&n=03osooeLKFU5Y0yI&q=85&s=744f9acb598771836458297ae427e002" style={{ maxWidth: 'min(150px, 100%)' }} width="188" height="617" data-path="images/1732732459-extmapping40a.png" />

The **Create** page opens at **Stage 1 - Select mapping type** and the **Entity type** is preselected for **Account**.

6. Using the **External system** drop-down list, select the external system referenced for the mapping type.

<Tip>
  **Tip: Other External systems showing?** Note that you can configure mappings for any of the integrations with external systems set up for your m3ter Organization. This includes any custom integrations as well as native integrations
</Tip>

7. Using the **External table** drop-down list, select the table in the selected 3rd-party system that you want to use for the mapping type:

<img src="https://mintcdn.com/m3ter/LeooOOS3ziv5cQmD/images/1769604532-extmapping61a.png?fit=max&auto=format&n=LeooOOS3ziv5cQmD&q=85&s=15c3b8efbb06e2f6b201b29eddc811b3" style={{ maxWidth: 'min(450px, 100%)' }} width="640" height="762" data-path="images/1769604532-extmapping61a.png" />

* In this example, we've chosen to create an **Account \<> Customer** mapping for **m3ter \<> Chargebee**.

8. When you've completed the mapping type set up, select **Next**. You're taken to **Stage 2 - Add mapping IDs:**

* The **m3ter entity type**, **External system**, and **External table** you configured for **Stage 1** are shown.

9. On **External mappings details**:

* The **m3ter entity** drop-down is preselected for the **Name** of the Account you started the workflow from.
* **Linked integration**. Note that because you started the create external mapping workflow from the Account metadata panel, the external mapping will *not be linked* to a specific integration with the selected external system. See [Creating Linked External Mappings](/guides/integrations/setting-up-integrations/creating-and-managing-external-mappings#creating-linked-external-mappings) for more details.

10. In the **External entity ID** field, enter the ID of the external system entity you want to map to.

<Tip>
  **Tip: Possibles values might show!** Note that if the possible values for the **External entity ID** field can be fetched for the **External system**, then you can use a drop-down list to select the value for this field from the list of possible values returned.
</Tip>

<img src="https://mintcdn.com/m3ter/LeooOOS3ziv5cQmD/images/1769604823-extmapping62a.png?fit=max&auto=format&n=LeooOOS3ziv5cQmD&q=85&s=47521e19c73b9cf55ff24a287edc1d58" style={{ maxWidth: 'min(450px, 100%)' }} width="644" height="794" data-path="images/1769604823-extmapping62a.png" />

11. Select **Create external mapping**. You are returned to the **Account details** page where the new mapping is listed for **Account metadata** under **External mappings**:

<img src="https://mintcdn.com/m3ter/97v2-eCLZ5ulkdC5/images/ExtMapping71.png?fit=max&auto=format&n=97v2-eCLZ5ulkdC5&q=85&s=d6f3cd7ad88e14694b42d72bd88b14a3" alt="Ext Mapping71" width="929" height="404" data-path="images/ExtMapping71.png" />
