# Insightly API Documentation

This is the complete API documentation for connecting to the Insightly API using MindCloud's Universal API.

MindCloud offers one normalized API to access 3,400+ apps from a single place. It centralizes authentication and normalizes app APIs so they are easier and more consistent to use.

## Quickstart

1. A **MindCloud account** — sign in or create an account at [MindCloud](https://app.mindcloud.co).
2. A **MindCloud API Key** — create one in [API Keys](https://app.mindcloud.co/user/api-keys). Keep it on your server.
3. At least one **Insightly connection** — create or choose one in [Connections](https://app.mindcloud.co/credentials). Note its `connectionId`.

```text
POST https://connect.mindcloud.co/v2/universal/apps/insightly/actions/{actionSlug}/run
```

## Insightly actions

- POST `create-contact` Create Contact
- POST `create-lead` Create Lead
- POST `create-opportunity` Create Opportunity
- POST `create-organisation` Create Organisation
- POST `create-project` Create Project
- POST `create-task` Create Task
- GET `get-contact` Get Contact
- GET `get-lead` Get Lead
- GET `get-opportunity` Get Opportunity
- GET `get-organisation` Get Organisation
- GET `get-project` Get Project
- GET `get-task` Get Task
- GET `list-contacts` List Contacts
- GET `list-leads` List Leads
- GET `list-opportunities` List Opportunities
- GET `list-organisations` List Organisations
- GET `list-projects` List Projects
- GET `list-tasks` List Tasks
- GET `search-contacts` Search Contacts
- GET `search-leads` Search Leads
- GET `search-opportunities` Search Opportunities
- GET `search-organisations` Search Organisations
- GET `search-projects` Search Projects
- GET `search-tasks` Search Tasks
- PUT `update-contact` Update Contact
- PUT `update-lead` Update Lead
- PUT `update-opportunity` Update Opportunity
- PUT `update-organisation` Update Organisation
- PUT `update-project` Update Project
- PUT `update-task` Update Task