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

# Insightly

## What's supported

### Supported actions

This connector supports:

* [Write Actions](/write-actions).
* [Read Actions](/read-actions), including full historic backfill and incremental read.
* [Proxy Actions](/proxy-actions), using the base URL `https://api.insightly.com`.

### Supported Objects

The Insightly connector supports reading from and writing to the following objects:

* [ActivitySets](https://api.insightly.com/v3.1/Help#!/ActivitySets/GetActivitySets)
* [CommunityComments](https://api.insightly.com/v3.1/Help#!/ForumComments/GetEntities)
* [CommunityForums](https://api.insightly.com/v3.1/Help#!/Forums/GetEntities)
* [CommunityPosts](https://api.insightly.com/v3.1/Help#!/ForumPosts/GetEntities)
* [Contacts](https://api.insightly.com/v3.1/Help#!/Contacts/GetEntities)
* [Countries](https://api.insightly.com/v3.1/Help#!/Countries/GetCountries)
* [Currencies](https://api.insightly.com/v3.1/Help#!/Currencies/GetCurrencies)
* [CustomObjects](https://api.insightly.com/v3.1/Help#!/CustomObjects/GetCustomObjects)
* [DocumentTemplates](https://api.insightly.com/v3.1/Help#!/DocumentTemplates/GetEntities)
* [Emails](https://api.insightly.com/v3.1/Help#!/Emails/GetEntities)
* [Events](https://api.insightly.com/v3.1/Help#!/Events/GetEntities)
* [FileCategories](https://api.insightly.com/v3.1/Help#!/FileCategories/GetFileCategories)
* [Follows](https://api.insightly.com/v3.1/Help#!/Follows/GetFollows)
* [ForumCategories](https://api.insightly.com/v3.1/Help#!/ForumCategories/GetEntities)
* [KnowledgeArticle](https://api.insightly.com/v3.1/Help#!/KnowledgeArticles/GetEntities)
* [KnowledgeArticleCategory](https://api.insightly.com/v3.1/Help#!/KnowledgeArticleCategories/GetEntities)
* [KnowledgeArticleFolder](https://api.insightly.com/v3.1/Help#!/KnowledgeArticleFolders/GetEntities)
* [LeadSources](https://api.insightly.com/v3.1/Help#!/LeadSources/GetLeadSources)
* [LeadStatuses](https://api.insightly.com/v3.1/Help#!/LeadStatuses/GetLeadStatuses)
* [Leads](https://api.insightly.com/v3.1/Help#!/Leads/GetEntities)
* [MarketingVisits](https://api.insightly.com/v3.1/Help#!/MarketingVisits/GetMarketingVisits)
* [Milestones](https://api.insightly.com/v3.1/Help#!/Milestones/GetEntities)
* [Notes](https://api.insightly.com/v3.1/Help#!/Notes/GetEntities)
* [Opportunities](https://api.insightly.com/v3.1/Help#!/Opportunities/GetEntities)
* [OpportunityCategories](https://api.insightly.com/v3.1/Help#!/OpportunityCategories/GetOpportunityCategories)
* [OpportunityLineItem](https://api.insightly.com/v3.1/Help#!/OpportunityProducts/GetEntities)
* [OpportunityStateReasons](https://api.insightly.com/v3.1/Help#!/OpportunityStateReasons/GetOpportunityStateReasons)
* [Organisations](https://api.insightly.com/v3.1/Help#!/Organisations/GetEntities)
* [Permissions](https://api.insightly.com/v3.1/Help#!/Permissions/GetPermissions)
* [PipelineStages](https://api.insightly.com/v3.1/Help#!/PipelineStages/GetPipelineStages)
* [Pipelines](https://api.insightly.com/v3.1/Help#!/Pipelines/GetPipelines)
* [Pricebook](https://api.insightly.com/v3.1/Help#!/PriceBooks/GetEntitiesBySearch)
* [PricebookEntry](https://api.insightly.com/v3.1/Help#!/PriceBookEntries/GetEntities)
* [Product](https://api.insightly.com/v3.1/Help#!/Products/GetEntities)
* [ProjectCategories](https://api.insightly.com/v3.1/Help#!/ProjectCategories/GetProjectCategories)
* [Projects](https://api.insightly.com/v3.1/Help#!/Projects/GetEntities)
* [Prospect](https://api.insightly.com/v3.1/Help#!/Prospects/GetEntities)
* [Quotation](https://api.insightly.com/v3.1/Help#!/Quotes/GetEntities)
* [QuotationLineItem](https://api.insightly.com/v3.1/Help#!/QuoteProducts/GetEntitiesBySearch)
* [Relationships](https://api.insightly.com/v3.1/Help#!/Relationships/GetRelationships)
* [TaskCategories](https://api.insightly.com/v3.1/Help#!/TaskCategories/GetTaskCategories)
* [Tasks](https://api.insightly.com/v3.1/Help#!/Tasks/GetEntities)
* [TeamMembers](https://api.insightly.com/v3.1/Help#!/TeamMembers/GetTeamMembers)
* [Teams](https://api.insightly.com/v3.1/Help#!/Teams/GetTeams)
* [Ticket](https://api.insightly.com/v3.1/Help#!/Tickets/GetEntities)
* [Users](https://api.insightly.com/v3.1/Help#!/Users/GetUsers)

#### Custom Objects and Fields

In addition to standard objects, the connector fully supports any custom objects you have created in your Insightly dashboard.
Custom objects are treated as first-class citizens and can be read from and written to like any standard entity.
For each supported object — standard or custom — you can select and request any built-in fields listed in the Insightly API
documentation as well as any custom fields you have defined.

### Example integration

To define an integration for Insightly, create a manifest file that looks like this:

```YAML theme={null}
# amp.yaml
specVersion: 1.0.0
integrations:
  - name: insightly-integration
    displayName: My Insightly Integration
    provider: insightly
    proxy:
      enabled: true
```

## Using the connector

This connector uses Basic Auth, which means that you do not need to set up a Provider App before getting started. (Provider apps are only required for providers that use OAuth2 Authorization Code grant type.)

To start integrating with Insightly:

* Create a manifest file like the example above.
* Deploy it using the [amp CLI](/cli/overview).
* Embed the [InstallIntegration](/embeddable-ui-components#install-integration) UI component. The UI component will prompt the customer for their username and password.
* Start making [Proxy Calls](/proxy-actions), and Ampersand will automatically attach the correct header required by Basic Auth. Please note that this connector's base URL is `https://api.insightly.com`.