NutShell is a customer relationship management (CRM) service. It can be integrated with other SaaS services for small businesses, including Google Apps.

Supervisor configuration parameters

To configure the connector, following parameters are required:

• Connector name

• Username for the cloud account

• Password - API Key

• Target URL of the cloud account

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

Supported objects and operations

Users

Table 134: Supported operations for Users

Operation	VERB
Create	POST
Update	PUT
Delete	DELETE
Get user by Id	GET
Get all users	GET
Get all users with pagination	GET

Groups

Table 135: Supported operations for Groups

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

Mandatory fields

Users

• emails.value

Groups

• displayName

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

Table 136: User mapping

SCIM parameter	NutShell parameter
id	id
userName	email
name.familyName	lastName
name.givenName	firstName
displayName	name
emails[0].value	email
active	isEnabled
groups	teams
meta.created	createdTime
meta.lastModified	modifiedTime

 

Table 137: Group mapping

SCIM parameter	NutShell parameter
id	id
displayName	name
enterpriseExtension.division	division
meta.created	createdTime
meta.lastModified	modifiedTime

Connector limitations

• Error messages and status codes are not customized. The following status codes are returned:

  • 200
  • 201
  • 204
  • 400
  • 401
  • 404
• Members cannot be added or retrieved from teams (groups) via the team endpoints. This can be achieved using the user endpoints and, updating the individual users. However, considering the large number of users in live production environments, membership management is not supported by the connector, as performance issues may arise.
• The delete operation is soft delete. Hence, it is possible to delete, or retrieve the deleted user or group multiple number of times. However, a deleted group will not be retrieved as part of the list groups response.
• Multiple email addresses can be associated to a user. Hence, the first email Id from the Nutshell user response is considered as the email id for the SCIM user.

• The NutShell API does not provide information on retrieval of all resources through paginated requests. Hence, the connector provides a nextCursor value, when the total resource count is divisible by requested count.