Insightly provides customer relationship management software for small and midsize businesses. It can be integrated with other applications such as Box, Dropbox, Gmail, Outlook, and QuickBooks. Its dashboard lets users create custom reports and track projects.

Supervisor configuration parameters

To configure the connector, following parameters are required:

• Connector name

• API Key

• SCIM URL (Cloud application's instance URL, used as the target URL in payload)

• Instance DateTime Offset (refer Configuring additional datetime offset in connectors for more details).

Users

Table 138: Supported operations for Users

Operation	VERB
Get user by Id	GET
Get all users	GET

Groups

Table 139: Supported operations for Groups

Operation	VERB
Create	POST
Update	PUT
Delete	DELETE
Get group by Id	GET
Get all groups	GET

Mandatory fields

Users

• Creation of users is not supported.

Groups

• DisplayName

User and Group mapping

The user and group mappings are listed in the tables below.

Table 140: User Mapping

SCIM Parameter	Insightly Parameter
Id	USER_ID
emails[0].value	EMAIL_ADDRESS
DisplayName	FIRST_NAME + LAST_NAME
name.FirstName	FIRST_NAME
name.LastName	LAST_NAME
name.Formatted	FIRST_NAME + LAST_NAME
active	ACTIVE
timezone	TIMEZONE_ID
meta.created	DATE_CREATED_UTC
userName	EMAIL_ADDRESS
meta.lastModified	DATE_UPDATED_UTC

 

Table 141: Group mapping

SCIM parameter	Insightly parameter
id	TEAM_ID
displayName	TEAM_NAME
created	DATE_CREATED_UTC
lastModified	DATE_UPDATED_UTC
members[].value	TEAMMEMBERS[].MEMBER_USER_ID

Connector limitations

• Create, Update, and Delete operation (for Users) are not supported.

• During the process of creating or updating a group, if the member data is incorrect, the operation fails with Bad request status code.

• It is possible to create multiple groups with the same name in Insightly cloud application.