# Connect SimPRO to Line

> Connect SimPRO Premium to Line. See SimPRO customers and jobs on calls, tell callers when the engineer is due, and create SimPRO leads and notes. You choose what syncs.

Source: https://useline.io/help/integrations/simpro  
Section: Integrations and API  
Last updated: 2026-11-19  
Plans: Pro, Business  
Roles: Owner, Manager

Connect SimPRO to Line, and Line knows your SimPRO customers and jobs. When a customer calls, Line shows their name and open jobs. An agent can tell a caller when the engineer is due. Agents, workflows and your team can create SimPRO leads and add notes. You choose what syncs, and in which direction.

## Before you start

- Your workspace must be on Pro or Business. SimPRO counts towards the integrations limit: Pro has 3, Business has no limit.
- You need the **Owner** or **Manager** role in Line.
- You need a **SimPRO Premium** build. The SimPRO API works on Premium builds only.
- You need a SimPRO user with administrator access, to create an API application.
- Line connects to cloud builds at `yourbuild.simprosuite.com` or `yourbuild.simprocloud.com`.

## Choose a sign-in method

Line signs in to SimPRO with your own SimPRO application. The application uses one of two sign-in methods. Line accepts both.

| Method | How it works | Choose it when |
|---|---|---|
| **Client credentials** (recommended) | Line holds a client ID and a client secret. Line uses them to get a new access token about every hour. | You can create a new application for Line. This is the safer choice: if an access token leaks, it stops working within an hour. |
| **API key** | Line holds one key. The key works until you delete it in SimPRO. | You already have an API key application, or SimPRO offers you only this method. It is quicker to set up. |

Both methods give Line the same access to your SimPRO data. With both, Line encrypts the details, and you stop Line's access by deleting the application in SimPRO.

If you use an API key, replace it when you think someone else saw it, or when a person who saw it leaves. Create a new key in SimPRO, then disconnect SimPRO in Line and connect again with the new key.

## Create the application in SimPRO

Each SimPRO build has its own applications, so you create one for Line.

1. Sign in to SimPRO as an administrator.
2. Select **System** → **Setup** → **API** → **Applications**.
3. Select **Request Access**.
4. Give the application a name, such as `Line`.
5. Select the grant type: **Client Credentials** (recommended) or **API Key**.
6. Send the request. SimPRO can take some time to approve it.
7. When SimPRO approves it, download the **key file**.
   - For **Client Credentials**, the file holds the token URL, the client ID and the client secret.
   - For **API Key**, the file holds the key.

Keep the key file safe. Anyone with it can read and change your SimPRO data.

## Connect SimPRO

1. In Line, select **Integrations** in the main menu.
2. Select **SimPRO**.
3. Select **Connect SimPRO**.
4. In **Sign-in method**, select **Client credentials** or **API key**. Use the method that your SimPRO application uses.
5. Select **Upload key file**, and choose the key file. For an API key, also type the **Build name** if the file does not hold it.
   Or select **Enter details**, and type the **Build name**. Then type the **Client ID** and the **Client secret**, or the **API key**.
6. Select **Connect**.
7. If your build has more than one company, select the company, then select **Use this company**.
8. In **Choose what syncs**, Line shows the recommended set: caller ID, jobs and call summaries. Change an item if you need to, then select **Save**. Or select **Skip** to keep every item **Off**.

Line checks the details with SimPRO. If SimPRO refuses them, Line keeps nothing and shows the reason. When it works, Line opens the SimPRO **Overview**.

## Reconnect SimPRO

If SimPRO stops accepting Line's details, for example because someone deleted the key, the **Overview** shows the error and **Reconnect**.

1. Select **Reconnect**.
2. Enter the new details for the same build, as in "Connect SimPRO".
3. Select **Reconnect**.

Line keeps what syncs, the field mapping, and the links to your contacts. To connect a different build or company, select **Disconnect** first.

## Choose what syncs

On the **Sync** page, set each item. Select **Use recommended** to turn on caller ID, jobs and call summaries in one step. Then select **Save**.

| Item | Choices | What each choice does |
|---|---|---|
| **Customers and contacts** | Off, Match only, Pull into Line, Push from Line, Both ways | **Match only** keeps each customer's name, numbers, email and Do not call flag for caller ID. It creates no Line contacts. **Pull into Line** creates a Line contact for each SimPRO customer. **Push from Line** creates a SimPRO customer for each new Line contact with a name. **Both ways** does both. In **When both change**, you then choose **SimPRO wins** or **Line wins**. |
| **Jobs and visits** | Off, Pull into Line | Line reads open jobs and the next engineer visit live from SimPRO. Jobs need customers set to Match only, Pull or Both ways. |
| **Leads** | Off, Pull into Line, Push from Line, Both ways | Push lets agents, workflows and your team create SimPRO leads. Pull lets a new SimPRO lead start a workflow. |
| **Notes** | Off, Push from Line | Line adds notes to the SimPRO customer or job. Choose **Call summaries**, **Call transcripts** or **Agent and workflow notes**. |
| **Quotes** | Off, Pull into Line | A quote status change can start a workflow. |

When you turn off an item that pulls data, Line deletes the data it copied for that item. Line contacts that it created stay.

## Map fields

The **Field mapping** page shows which SimPRO field fills each Line field for customers and contacts.

| Line field | SimPRO fields | Notes |
|---|---|---|
| **Name** | GivenName and FamilyName, or CompanyName | Always mapped. |
| **Mobile** | CellPhone, Phone or AltPhone | A new SimPRO customer gets Line's main number here. |
| **Phone** | Phone, CellPhone or AltPhone | Read only. |
| **Other phone** | AltPhone, Phone or CellPhone | Read only. |
| **Email** | Email | |
| **Do not call** | DoNotCall | Always read. You cannot change it. |

On a SimPRO contact, **Phone** is the contact's work phone.

To stop a number from matching callers, set its field to **Not mapped**. Use this for a shared office number. Then select **Save**. Line reads your SimPRO customers again.

When **Customers and contacts** is **Both ways**, select the arrow in the **Flow** column to choose the direction of each field: **Two-way**, **From SimPRO** or **To SimPRO**. In the other modes, the mode sets the direction.

## Approval

In **Approval**, choose what happens when Line creates a lead or adds a note: **Runs on its own**, or **A person approves**. New connections start with **A person approves**.

## What SimPRO can do

- **Caller ID.** When a SimPRO customer calls, Line shows their SimPRO name. Line reads its own copy of the numbers, so the call never waits for SimPRO.
- **Contact card.** A contact linked to SimPRO shows the customer, the **Do not call** flag, their open jobs and the next visit. In the **SimPRO** block, your team can select **Link**, **Create lead** and **Add note**.
- **Agent tools.** Turn each tool on in an agent's **Tools** tab. A tool shows only when its item is on in **Sync**.
  - **Find SimPRO customer** checks if the person is a SimPRO customer.
  - **Get SimPRO job status** tells the customer about their open jobs and the next engineer visit.
  - **Create SimPRO lead** creates a lead. For a new person, it creates the customer and a site first.
  - **Add note to SimPRO** adds a note to the customer or one of their jobs.
- **Call notes.** After a recorded call, Line adds the summary or the transcript to the caller's SimPRO customer, if you turned that note kind on.
- **Workflows.** A **SimPRO event** trigger starts a workflow when a visit is booked or moved, a job or quote changes status, or a lead is created. Workflow steps **Create SimPRO lead** and **Add note to SimPRO** write to SimPRO. Line never texts or calls a customer with **Do not call** set from a SimPRO event.
- **Overview.** The **Overview** page shows the connection status, the build and the company. **What syncs** shows the direction of each item: **From SimPRO**, **To SimPRO**, **Two-way**, **Match only** or **Off**. Select **Change** to open **Sync**. While Line reads your SimPRO customers, the page shows how many it has read.
- **Activity.** The **Activity** page lists each sync, link, lead, note and error, with its direction and status. Select **Failed** to show only the errors. The **Activity** item in the menu shows the number of errors in the last 24 hours.

### How Line protects job details

An agent tells a person about jobs only when their phone number came from the phone network (a call, an SMS or a WhatsApp message) and matches one SimPRO customer. A number typed into Web Chat or an email does not count. The agent cannot look up another person.

### How Line matches contacts

Line links a Line contact to a SimPRO record when one phone number or email address matches exactly one record on each side. If two SimPRO records share a number, Line links neither. Open the contact, and select **Link** in the **SimPRO** block.

## Common problems

**I do not see SimPRO in Integrations.** SimPRO is not available on your Line account yet. Contact Line support.

**SimPRO refused the client ID and secret.** Check that SimPRO approved the application, and that it uses the **Client Credentials** grant. Then connect again.

**SimPRO refused the API key.** Check that the key is for this build and that nobody deleted it in SimPRO. Check that you typed the correct **Build name**.

**Line could not read the key file.** Select **Enter details**, and type the details from the file.

**The Overview says the connection needs attention.** SimPRO no longer accepts the client secret or the API key. Someone may have deleted or changed the application in SimPRO. Select **Reconnect**, and enter the application's current details. Line keeps your settings and links.

**A caller's name does not show.** Check that **Customers and contacts** is not Off or Push from Line. The number must be in one SimPRO customer only, and its field must be mapped on **Field mapping**. Select **Sync now** on the Overview to read SimPRO again.

**An agent does not offer a SimPRO tool.** Turn on the item that the tool needs in **Sync**, then turn the tool on in the agent's **Tools** tab.

**A lead or note did not appear in SimPRO.** Open **Agents** → **Work items** to see if it waits for a person. Then open **Activity** on the SimPRO integration in Line to see the error.

## Related articles

- [What you can connect to Line](https://useline.io/help/integrations/integrations-overview.md): Line connects to Google Calendar, Microsoft Calendar, SimPRO, what3words, a browser for agents, your own HTTP and MCP tools, and the SMS API. Email to SMS works with any software that sends email.
- [How AI agents work in Line](https://useline.io/help/ai-agents/how-agents-work.md): An agent answers calls, texts, WhatsApp, Web Chat and email for you. It replies only when a workflow has an Agent step that names it.
- [Compare the Starter, Pro and Business plans](https://useline.io/help/billing/plans.md): Line has three plans. Starter is a number and a team inbox. Pro adds recording, WhatsApp, templates and more agents. Business removes the limits.
- [Connect Google Calendar or Microsoft Calendar](https://useline.io/help/integrations/connect-a-calendar.md): Connect Google Calendar or Microsoft Calendar in Integrations so your agents can check free times and book meetings. A person approves each booking. Pro and Business only.
