> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mspilot.io/llms.txt
> Use this file to discover all available pages before exploring further.
# Syncro
> Sync customers and devices into your clients.
Connect Syncro with an API token that uses **Custom Permissions**. MSPilot uses it to list customers and assets, then sync those into your clients. It does not create, update, or delete records in Syncro.
You need a Syncro administrator who can create API tokens.
## Create an API token in Syncro
1. In Syncro, go to **Admin → API - API Tokens**.
2. Click **New Token**.
3. Open the **Custom Permissions** tab. Don't stay on **App Integration**. Those tokens are prebuilt for other apps and grant more than MSPilot needs.
4. Enter a **Name** you'll recognize later, such as `MSPilot Access`. You can leave **Expiration** blank.
5. Enable only:
* **Assets - List/Search**
* **Customers - List/Search**
6. Leave every other permission off.
7. Create the token and copy it to a password manager. Syncro typically won't show it again.
## Connect Syncro
1. In MSPilot, open **Integrations** and choose **Syncro**.
2. Enter **Subdomain**. For `https://your-subdomain.syncromsp.com`, enter `your-subdomain`. Don't include `https://`, and don't include `.syncromsp.com`. The form also accepts the full hostname.
3. Paste the token into **API token**.
4. Click **Connect Syncro**.
## After you connect
MSPilot starts syncing customers and devices from Syncro.
* If you skipped a PSA, Syncro customers are imported as clients first. Devices then land in those workspaces.
* If clients already came from a PSA, map each client to the Syncro customer that owns its endpoint inventory.
Each Syncro customer can map to only one client. Assets without a mapped customer, or without a Syncro agent installed, are skipped.
On the client, use **Syncro mapping** to bind the customer, then **Refresh devices** when you want that client's inventory updated immediately.