The Marketo connector allows you to connect Marketo with One Identity Starling enabling you to take advantage of the features and products available with Starling Connect that complement and enhance the services provided by Marketo.

Marketo provides marketing automation software for all types of digital marketing. It provides services to capture the interaction with each customer, enabling users to identify the most profitable channels and campaigns.

Supervisor configuration parameters

To configure the connector, following parameters are required:

• Connector name

• Client Id

• Client Secret

• Target URI

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

Supported objects and operations

Users

Table 242: Supported operations for Users

Operation	VERB
Create(Invite) User	POST
Update User	PUT
Delete User	DELETE
Get User	GET
Get All Users	GET
Add RoleAndWorkspace to User	PUT
Remove RoleAndWorkspace from User	PUT

Roles

Table 243: Supported operations for Roles

Operation	VERB
Get all Roles	GET

Workspaces

Table 244: Supported operations for Workspaces

Operation	VERB
Get all Workspaces	GET

Mandatory fields

This section lists the mandatory fields required to create a User or Group:

Users

• FirstName

• LastName

• EmailAddress

• accessRoleId

• WorkspaceId

Mappings

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

Table 245: User mapping

SCIM Parameter	Marketo parameter
Id	userid
UserName	userid
DisplayName	firstName + lastName
name.GivenName	firstName
name.FamilyName	lastName
emails[].value	emailAddress
Active	isLocked == false
Extension.rolesAndWorkspaces[].accessRoleId	userRoleWorkspaces[].accessRoleId
Extension.rolesAndWorkspaces[].accessRoleName	userRoleWorkspaces[].accessRoleName
Extension.rolesAndWorkspaces[].workspaceId	userRoleWorkspaces[].workspaceId
Extension.rolesAndWorkspaces[].workspaceName	userRoleWorkspaces[].workspaceName

Roles

Table 246: Roles mapping

SCIM parameter	Marketo parameter
id	id
name	name
description	description
Type	type
Meta.Created	createdAt
Meta.LastModified	updatedAt

Workspaces

Table 247: Workspaces mapping

SCIM parameter	Marketo parameter
id	id
name	name
description	description
Status	Status
Meta.Created	createdAt
Meta.LastModified	updatedAt

Connector limitations

1. Create User is a multiple steps operation.
   1. Once the Create User request is successfully submitted to One Identity Manager, the user will receive an email on the email ID mentioned in the request.
   2. User must click on the link provided in the email and set a password.
   3. User is now activated and will be available at the target instance.
2. To Create a User, at least one pair of accessRoleId and WorkspaceId must be provided.
3. One Identity Manager must have multi-value arrays of string type to hold the values of the User properties: accessRoleId, accessRoleName, WorkspaceId and WorkspaceName.
4. Update User is a multiple steps operation.
   1. Only confirmed Users can be updated.

   2. One round of full synchronization is required before submitting the UPDATE request on a newly created User. This must be done to synchronize the User details after activation. This applies to newly created Users only, however existing User UPDATE will work as usual.

5. Roles and Workspaces endpoints are used only to retrieve data from target and store it in One Identity Manager and can not to be used to assign or unassign Roles and Workspaces to a User.
6. Connector supports cursor pagination and hence TotalResults are not returned.
7. Duplicate User CREATE request will return Internal Server Error: 500 with the message System Error: This userid is in use. Choose another email for already existing activated User. However, error 409 is returned if the User is not activated.

8. The pagination scenarios are not tested for Marketo Connector due to unavailability of adequate target system instance.

Synchronization and integration of Roles object type with One Identity Manager

For more information, see Synchronization and integration of Roles object type with One Identity Manager.

Synchronization and integration of Workspaces object type with One Identity Manager

For more information, see Synchronization and integration of Workspaces object type with One Identity Manager.

Add Roles ID and Workspaces ID to create and update users for Marketo connector

To create a user successfully using Marketo connector, you must provide valid values for mandatory properties such as Roles ID and Workspaces ID in the request. Roles ID and Workspaces ID are the sub-attributes of the main attribute RolesAndWorkspaces, which is a complex multi-valued string attribute defined under User extensions in the connector schema.

One Identity Manager must have fields where you can enter complex multi-value array values but it does not display such fields by default. However, it is possible to create custom multi-value array fields. For more information, see Creating multi-valued custom fields in One Identity Manager.