Pipedrive
Pipedrive is a cloud-based sales management tool offered on a web platform and as a mobile app.
Supervisor Configuration Parameters
To configure the connector, following parameters are required:
-
Connector name
-
API key
- SCIM URL (Cloud application's instance URL used as targetURL in payload)
Supported Objects and Operations
Users
|
Operation |
VERB |
|---|---|
|
Create |
POST |
|
Update |
PUT |
|
Delete |
DELETE |
|
Get user by Id |
GET |
|
Get all users |
GET |
Mandatory Fields
Users
- Emails.value
- DisplayName
Connector Limitations
-
The Groups object type is not supported.
- Pagination is not supported.
- Deleted user object can be retrieved using Get user by ID.
- Creation of a duplicate user does not return an error. Instead, the existing object is returned.
-
Deactivated or Deleted users can be deactivated or deleted multiple number of times.
-
Deactivated or Deleted users can be activated again.
- The Update operation supports only the change of active flag field.
SuccessFactorsHR
SuccessFactorsHR is an integrated human-resources platform. It offers users tools for onboarding, social business, and collaboration along with tools for learning management, performance management, recruiting, applicant tracking, succession planning, talent management, and HR analytics. It is also cloud-based.
Supervisor Configuration Parameters
To configure the connector, following parameters are required:
- Connector Name
- Username
- Password
-
SuccessFactorsHR instance URL (https://apps.support.sap.com/sap/support/knowledge/public/en/2215682)
-
Minimal Attributes
NOTE: The default value is false. When the value is set to true, only the minimal set of attributes for all the objects including Employee, Department, Location, CostCenter will be queried from the SuccessFactorsHR system.
|
SuccessFactorsHR |
Attributes |
|---|---|
| Location | externalCode, name, description, timezone, geozoneFlx, status |
| Employee | EmpJob attributes: userId, department, costCenter, businessUnit, location, division, startDate, endDate, managerId, jobTitle, contractType, company |
| User attributes: userId, username, defaultFullName, hireDate, lastModified, status, department, location, firstName, lastName, mi, suffix, email, addressLine1, state, city, zipCode, country, businessPhone, cellPhone | |
| Department | name, description, externalCode, status, parent |
|
CostCenter |
name, description, externalCode, status |
Supported Objects and Operations
Employees
|
Operation |
VERB |
|---|---|
|
Get Employee |
GET |
|
Get All Employees with Pagination |
GET |
|
Update Employees |
PUT |
Business Units
|
Operation |
VERB |
|---|---|
| Get BusinessUnit | GET |
|
Get All Business Units with Pagination |
GET |
Companies
|
Operation |
VERB |
|---|---|
| Get Company | GET |
|
Get All Companies with Pagination |
GET |
Departments
|
Operation |
VERB |
|---|---|
| Get Department | GET |
|
Get All Departments with Pagination |
GET |
Locations
|
Operation |
VERB |
|---|---|
| Get Location | GET |
|
Get All Locations with Pagination |
GET |
Divisions
|
Operation |
VERB |
|---|---|
| Get Division | GET |
|
Get All Divisions with pagination |
GET |
Cost Centers
|
Operation |
VERB |
|---|---|
| Get CostCenter | GET |
|
Get All CostCenters with Pagination |
GET |
| SCIM Parameter | SuccessFactorsHR Parameter |
|---|---|
| DepartmentName | id |
| Description | description |
|
ImportSource |
sourceSystem |
| Remarks | status |
| ShortName | name |
|
vrtCostCentersMapping |
costCenter |
|
vrtDepartmentHead |
headOfUnit |
|
vrtLocationsMapping |
location |
| SCIM Parameter | SuccessFactorsHR Parameter |
|---|---|
| Building | externalCode |
| Description | description |
| Ident_locality | id |
|
ImportSource |
sourceSystem |
| LongName | name |
| Room | status |
|
RoomRemarks |
locationGroup |
Connector Limitations
-
Create and Delete operations are not supported for any object.
-
Currently, the Update functionality is functional only for the following attributes of the Employee object:
- cellPhone
- businessPhone
Nutshell
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
Supported Objects and Operations
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
|
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
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.
Insightly
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)
Supported Objects and Operations
Users
|
Operation |
VERB |
|---|---|
|
Get user by Id |
GET |
|
Get all users |
GET |
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
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.