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

# Insightly

> Connect Insightly to Allo, sync your contacts, leads and organizations, and log every call and SMS as an event on the contact and its organization

Allo logs every call as an event on the matching Insightly contact or lead and on the contact's organization, and groups each day's SMS with a contact into one event. Your Insightly contacts, leads and organizations sync into Allo.

## How to connect

The Insightly integration connects with your Insightly API key and your API URL. Every Insightly plan includes API access. You need an Allo admin or manager to connect the integration.

### Get your Insightly API key and API URL

**1. Open your user settings**

In Insightly, click your profile picture at the top right, then **User Settings**.

**2. Find the API section**

Scroll to the **API** section. It shows your **API key** and, right under it, your **API URL**, for example `https://api.na1.insightly.com`.

If the API key field says **API Access is disabled**, an Insightly administrator must turn on API access for your user first.

**3. Copy both values**

Copy the API key and the API URL. Don't click **Generate New API Key** afterwards: it revokes the key Allo uses at once.

Allo works with the permissions of the Insightly user who owns the API key. Use the key of a user who can see the contacts, leads and organizations you want in Allo.

### Connect in Allo

**1. Open integrations**

Go to [**web.withallo.com**](https://web.withallo.com) and navigate to **Settings** > **Integrations**.

**2. Find Insightly**

Find **Insightly** in the list and click **Connect**.

**3. Paste your API key**

Paste the API key you copied from Insightly.

**4. Paste your API URL**

Paste the API URL shown under the API key, for example `https://api.na1.insightly.com`. Use the API URL, not the address you see in your browser when you use Insightly.

**5. Save and connect**

Click **Save & Connect**. Allo imports your Insightly contacts, leads and organizations.

## What syncs

**From Insightly to Allo:**

* Contacts, with their first and last name, email, phone numbers (business, mobile, home, other and assistant), job title, organization, owner, tags, and a link to the contact in Insightly
* Leads that are not converted yet, with their first and last name, email, phone and mobile numbers, job title, organization name, website, lead status, owner, tags, and a link to the lead in Insightly
* Organizations, with their name, website, phone number, address, background, owner, and a link to the organization in Insightly

Allo maps the owner by email: the owner of a contact in Allo is the Insightly user with the same email.

**From Allo to Insightly:**

* Calls and SMS, logged as events on the matching contact or lead and on the contact's organization
* New contacts, only when **Create lead for unknown calls** is enabled. Allo creates an Insightly contact (not a lead) with the name, email, phone number and job title known in Allo. A contact without a name in Allo gets its phone number as first name.

Allo only fills in empty fields on an existing contact or lead and adds phone numbers it doesn't have yet. Allo never overwrites what is already set in Insightly, and never converts a lead.

Contacts and leads sync every 10 minutes and organizations every 30 minutes, only the records that changed. When a lead is converted in Insightly, it leaves Allo and its contact takes over. Opportunities and projects are not synced. Deleting a record in Insightly does not remove the contact from Allo. Records without a phone number are not synced to Allo.

When a call comes in or goes out, Allo looks for the caller in the **Phone** and **Mobile** fields of your contacts, then of your leads.

> [!TIP]
>
> Insightly matches a phone number by the characters stored in the field, so the format matters. Numbers stored in international format (`+14155550123`) or as plain digits (`4155550123`) match best. Common formats such as `(415) 555-0123`, `415-555-0123` or `+33 6 12 34 56 78` also match. A number written with dots, such as `415.555.0123`, is not found when the call happens. Contacts with such numbers, and numbers stored in the home, other or assistant fields, still sync into Allo, so Allo shows their name and logs their calls once synced.

## How calls are synced

After each call, Allo creates an **Event** in Insightly, linked to the matching contact and to the contact's organization when there is one, or to the lead. The event starts when the call started and ends when the call ended, so it shows the call duration. Missed calls and voicemails start and end at the same time.

The event title shows the direction, the result, the Allo user and the duration, for example `Allo Outbound Call - Answered - Jane Doe (5:12)`. The event details contain:

* Who called whom and on which Allo line
* The call tags
* A link to the call recording in Allo
* The call summary

The call transcript is not added to the event. Insightly limits event details to 4000 characters, so Allo shortens a very long summary and keeps the recording link.

The event is owned by the Insightly user whose email matches the Allo user's email. If no active Insightly user has that email, the owner of the API key owns the event.

When you edit a call's summary, tags or result in Allo, Allo updates the same event in Insightly.

## How SMS are synced

Allo groups SMS into one event per contact per day, titled for example `Text Message - Jane Whitaker - 6 Nov 2026`. Each message is added to that day's event with its time, its direction and the Allo user. The event is linked to the contact and to the contact's organization, or to the lead. When a day's event reaches Insightly's 4000-character limit, Allo starts a second event for that day.

## Click-to-call

Click-to-call is not available for this integration.

## Troubleshooting

Check the sync status of any call from the **call list on [web.withallo.com](https://web.withallo.com)**. Each call has an integration indicator showing its sync state.

> [accordion] I cannot connect my integration
>
> Only **admins** and **managers** of an Allo workspace can connect integrations. If you don't see the option, ask your workspace admin or manager to set it up.
>
> On the Insightly side, check these points:
>
> * **API Access is disabled**: an Insightly administrator turned off API access for your user. Ask them to turn it back on, then copy the API key again.
> * **API key**: paste the full API key from **User Settings** > **API**, with no space before or after it.
> * **API URL**: paste the API URL shown under the API key, such as `https://api.na1.insightly.com`. The address of your Insightly account in the browser does not work.

> [accordion] Call not synced to my integration
>
> Check the integration indicator on the call in the web app. The error will be one of these:
>
> * **Contact not found**: the contact doesn't exist in your CRM. By default, Allo only syncs calls to existing contacts. To auto-create contacts, go to your integration settings and enable **Create lead for unknown calls**. If the contact exists, check the format of its phone number (see the tip in **What syncs**).
> * **Contact deleted**: the contact was removed from your CRM. Allo is additive and won't sync calls for deleted contacts. Re-create the contact in your CRM, then retry the sync.
> * **Integration disconnected**: the Insightly API key changed. Insightly creates a new API key when someone clicks **Generate New API Key** and when a user's administrator permissions change, and the old key stops working at once. Copy the new API key, then disconnect and reconnect the integration in Allo.
> * **Daily API limit reached**: Insightly limits each account to a number of API requests per day, shared by every tool connected to it. When the limit is reached, Allo retries the call later. Check with your Insightly administrator which other tools use the API.
> * **Call pending (spinner icon)**: Allo is still matching the contact. This can take up to 24 hours before being marked as an error. Once the contact exists in your CRM, you can retry manually.
> * **Contact is a favorite**: by default, calls with a favorite contact are not synced to your CRM. Remove the contact from your favorites if you want these calls to sync.

> [accordion] Contacts not syncing
>
> The first sync can take up to **15 minutes** for large contact databases. After that, contacts and leads sync incrementally every **10 minutes** and organizations every **30 minutes**, not in real time.
>
> Allo only syncs contacts and leads that have at least one phone number. Records without a phone number will not appear in Allo. Converted leads don't appear either: their contact does.
>
> If contacts still don't appear after 15 minutes, disconnect and reconnect the integration.

> [accordion] SMS not synced
>
> SMS are added to one event per contact per day. Look for the `Text Message` event dated the day of the SMS on the contact or lead in Insightly.
>
> If the event is missing, verify the integration is connected in **Settings** > **Integrations** and check the integration indicator on the call list at [web.withallo.com](https://web.withallo.com) for error details. If SMS still don't appear, disconnect and reconnect the integration.

> [accordion] Duplicate contacts
>
> Allo mirrors your integration exactly. If your CRM has duplicate contacts with the same phone number, they appear as separate contacts in Allo.
>
> Clean up duplicates in your CRM. Allo will reflect the change on the next sync.

> [accordion] Call synced to the wrong contact
>
> When multiple contacts share the same phone number, Allo logs the call on the first matching contact. Before reporting a missing sync, check all contacts that share that phone number: the call may already be synced to another one. Click the integration indicator on any call in the web app to see exactly which contact it was synced to.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.