> For the complete documentation index, see [llms.txt](https://docs.harmony.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.harmony.io/integrations/saas-applications/mesh-payments.md).

# Mesh Payments

Connect Mesh Payments to sync employee corporate card data and expense information into Harmony

Mesh Payments is a corporate spend management platform that provides companies with visibility and control over employee expenses and corporate card usage. Connecting Mesh Payments to Harmony imports your Mesh employee directory and turns corporate card spend into contracts, one per Mesh fund, so IT teams can see which software the organization is paying for and which employee each charge belongs to.

#### What the Mesh Payments integration enables

| Capability            | Description                                                                                                                                                          |
| --------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Employee Sync         | Import employee profiles from Mesh Payments - name, email, permission level, and account status - synced every 24 hours                                              |
| SaaS Spend Visibility | Card expenses from the last 90 days, grouped into one contract per Mesh fund, with each charge as a line item naming the employee it is assigned to, refreshed daily |
| Permission Visibility | See each employee's Mesh permission level and account status alongside the rest of their IT footprint                                                                |

***

#### Prerequisites

* **Mesh Payments account**: An active Mesh Payments account, and a Mesh user with an **Admin** or **Pro** profile. Other Mesh users can't connect partners
* **Mesh sync enabled for your Harmony workspace**: Mesh Payments sync is enabled per workspace by Harmony and is off by default

{% hint style="warning" %}
**Mesh sync must be switched on for your workspace before any data flows.** Even after every step below is completed, Harmony will not collect Mesh data until the integration is enabled for your workspace. [Contact Harmony support](mailto:support@harmony.io) to have it enabled.
{% endhint %}

***

#### Connect Mesh Payments to Harmony

**Step 1: Open Harmony in the Mesh Integration Store**

1. Log in to the [Mesh Payments platform](https://app.meshpayments.com)
2. If your organization has several companies in Mesh, switch to the company you want to connect. Each connection covers one company
3. Open **Company Settings**, then select **Integrations** in the **General** section
4. Click **Manage integrations**, then click **+ Go to integration Store**
5. Scroll to the **Other** group and click **+ Connect** on the **Harmony** tile

**Step 2: Review and approve Harmony's access**

1. Check the company name at the top of the page ("You are connecting...")
2. Review what Harmony will be able to access: **Employees**, **Custom Fields**, and **Expenses** (see [Permissions Explained](#permissions-explained))
3. Tick **I authorize Harmony to access your company as listed above**
4. Click **Connect**

{% hint style="info" %}
If Harmony needs more access in the future, its tile in the Integration Store shows **Update access**. Harmony keeps the access you already approved until you review and approve the new items.
{% endhint %}

**Step 3: Copy your Mesh Company ID**

Harmony uses your Mesh **Company ID** to reach your company through the Mesh API, with the access you approved.

1. Once you're connected, the Mesh page shows your **Mesh Company ID**
2. Click the copy button next to it

{% hint style="info" %}
Treat your Company ID as you would any internal account identifier - share it only with authorized Harmony and Mesh representatives.
{% endhint %}

**Step 4: Connect in Harmony**

1. Log in to your Harmony dashboard
2. Navigate to **Settings** > **Integrations**
3. Find **Mesh Payments** under **SaaS Procurement** (or search for it by name) and click its card. If a Mesh company is already connected, click **+ Create instance**
4. Enter an **Instance name** (required), for example the name of the Mesh company
5. Paste the **Company ID** you retrieved from Mesh
6. Leave **Only sync contracts matching the application catalog** on to keep only funds whose name or charges match an application in Harmony's catalog. Turning it off brings in every charge, including non-software spend
7. Click **Connect**

No API key or secret is required from you - Harmony authenticates to Mesh with its own partner credentials, and the Company ID selects your account. Harmony checks the Company ID with Mesh when you click **Connect** and shows an error if Mesh does not recognize it. Each Mesh company can be connected once; to sync several companies, create one instance per Company ID.

{% hint style="info" %}
You can access this documentation directly from the integration settings page. Go to **Settings** > **Integrations** and click the **Mesh Payments** card to find a link to this setup guide without leaving the platform.
{% endhint %}

***

#### Disconnect Mesh Payments from Harmony

1. Log in to your Harmony dashboard
2. Navigate to **Settings** > **Integrations**
3. Find **Mesh Payments** under **SaaS Procurement** and click its card
4. Click the delete (trash) icon next to the instance you want to remove
5. Confirm when prompted

Once disconnected, Harmony stops syncing data from Mesh Payments. Previously synced data remains available in Harmony.

To also revoke Harmony's access on the Mesh side, open **Company Settings** > **Integrations** in Mesh and click **Manage integrations**, click **Edit** next to Harmony, then click **Disconnect** and confirm. Disconnecting removes all of Harmony's access to your company.

***

#### What Harmony Syncs from Mesh Payments

| Data              | Description                                                                                                                                                                                                      |
| ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Employee profiles | Full name, email, permission level, and account status (active, pending, or inactive), synced every 24 hours                                                                                                     |
| License tier      | Whether the employee holds a Mesh seat or is a contact-only record with no platform access                                                                                                                       |
| Card expenses     | Amount and currency, merchant, fund name and fund type, expense date, status, spend category, reimbursable flag, and the employees who reported and were assigned the charge - the last 90 days, refreshed daily |

{% hint style="info" %}
**Card expenses become contracts, one per fund.** Mesh groups spend into funds, so Harmony creates one contract per fund, named after the fund, with each card charge as a line item. By default only funds whose name or charges match an application in Harmony's catalog are kept; turn off **Only sync contracts matching the application catalog** on the connection to keep every fund. A contract that matches an application is attributed to it, which is how Mesh contributes SaaS spend data to your application inventory.
{% endhint %}

{% hint style="info" %}
**Only card expenses are collected.** Harmony requests expenses of type `CARD_EXPENSE`. Reimbursements and other Mesh expense types are not synced.

Each daily sync re-reads the last 90 days of card expenses, so a fund's contract always reflects its trailing 90 days of charges. Expenses that are not assigned to a fund are not synced.
{% endhint %}

{% hint style="warning" %}
**Mesh Payments does not provide sign-in or usage data.** Mesh exposes no login-activity or software-usage API to Harmony, so this integration contributes inventory only. Unlike integrations that report sign-in activity, you will not see last-login dates, sign-in events, or per-user activity metrics for Mesh.
{% endhint %}

{% hint style="info" %}
**One Mesh company per connection.** A Mesh organization can contain several companies. Harmony syncs the single company identified by the Company ID you entered - other entities in the same Mesh organization are not included.
{% endhint %}

No per-user credential management is required. Once connected with your Mesh Company ID, Harmony keeps your data up to date on a continuous basis.

***

#### Permissions Explained

When you connect Harmony, Mesh lists the access below and asks you to approve it (Step 2). Disconnecting Harmony in Mesh removes all of it.

| Access          | What Mesh lists                                                                         | Purpose                                                                          |
| --------------- | --------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------- |
| `Employees`     | See your employees and their contact details, and add new employees (marked **Change**) | Sync employee profiles, permission levels, account status, and license tier      |
| `Custom Fields` | See the custom fields your company set up, and their options (marked **Read**)          | Part of Harmony's access list in Mesh; Harmony does not read custom fields today |
| `Expenses`      | See your company's expenses and their receipts (marked **Read**)                        | Sync card expenses and attribute SaaS spend per application and per employee     |

Harmony reads Mesh data only - the integration never creates, modifies, or cancels cards, funds, employees, or expenses in your Mesh account, even though Mesh marks the **Employees** access as **Change**.

***

#### Troubleshooting

<details>

<summary>No data appears after connecting</summary>

**Possible causes:**

* Mesh sync has not been enabled for your Harmony workspace - it is off by default
* Harmony was not connected for this company in the Mesh Integration Store (Steps 1 and 2)
* The first sync cycle has not run yet - employee profiles and card expenses refresh every 24 hours
* No fund matched an application in Harmony's catalog, and **Only sync contracts matching the application catalog** is on

**Solutions:**

1. [Contact Harmony support](mailto:support@harmony.io) to confirm Mesh sync is enabled for your workspace
2. In Mesh, open **Company Settings** > **Integrations** > **Manage integrations** and confirm Harmony is connected for this company
3. Wait for the next sync cycle to complete

</details>

<details>

<summary>Data stopped syncing, or an access denied error appears</summary>

**Possible causes:**

* Harmony was disconnected in Mesh, which removes all of its access. Mesh then rejects Harmony's requests and the sync reports a *Mesh access denied - check partner permissions* error

**Solutions:**

1. Connect Harmony again from the Mesh Integration Store (Steps 1 and 2). If its tile shows **Update access**, review and approve the new items
2. If the Harmony tile is not listed in the Integration Store, contact your Mesh CSM

</details>

<details>

<summary>Connecting fails with a Company ID error</summary>

**Possible causes:**

* The Company ID entered in Harmony is incorrect. Harmony checks it with Mesh when you click **Connect**: a value Mesh does not know fails with *Mesh Payments does not recognize this Company ID*, and a value that is not a numeric ID fails as malformed
* Mesh denied access to the Company ID because Harmony is not connected for that company in the Mesh Integration Store (Steps 1 and 2)
* The same Company ID is already connected in another instance (*This Mesh Payments company is already connected*)

**Solutions:**

1. Verify the Company ID in Mesh and enter it again
2. If you are unsure which value is correct, ask your Mesh CSM to confirm your Company ID
3. If the company is already connected, use the existing instance instead of creating a new one

</details>

***

#### Data & Privacy

<details>

<summary>Key privacy principles</summary>

For information about how Harmony handles your data, see our [Privacy Policy](https://harmony.io/privacy).

* Harmony accesses Mesh Payments data in read-only mode and does not modify any data in your Mesh account
* Access can be revoked at any time by disconnecting Harmony in Mesh (**Company Settings** > **Integrations** > **Manage integrations**), or by disconnecting the integration in Harmony

</details>


---

# 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.harmony.io/integrations/saas-applications/mesh-payments.md?ask=<question>&goal=<user_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.
