Installing the Alyce for Marketo Integration

Follow

To set up the integration, you will need to make sure you have an Alyce user account and a Marketo user with admin rights, as well as these three pieces of information from your Marketo account: 

  1. REST API Endpoint
  2. Client ID
  3. Client Secret

First, login to your Marketo account here.

Find your REST API Endpoint

  1. Click Admin in the top right of the screen
  2. Click Web Services on the sidebar
  3. Find the REST API Endpoint in the REST API box

2020-02-12_18h07_31.png

Create a new Marketo User with a custom role

For accessing both your Client ID and Client Secret, you’ll first have to create a new User who is assigned a custom Role with the correct API access permissions in Marketo.

1. Click Admin in the top right of the screen.

2. Click Users & Roles on the sidebar (under Security).

3. Click the Roles tab and then create a new role by clicking New Role.

4. In Permissions, click on ”+” to expand Access API and check the boxes for 
Read-Write Activity
Read-Write Activity Metadata
Read-Write Assets
Read-Write Person
Read-Only Custom Object
Read-Write Custom Object
Read-Only Custom Object Type
Read-Write Custom Object Type

(Suggested Role Name: Alyce Role, Suggested Description: API Access)

 

5. Click Create and you should now see your new User Role listed. You can double click to edit this at any time. For now, there are still no Users assigned this Role. 

2020-02-12_18h13_43.png

Next, create an API-Only User to assign the role to.  To do so:

  1. Click the Users tab.
  2. Invite a New User by clicking the Invite New User button. 
  3. Create a new user. For example:

    Email: api.user@alyce.com

    First Name: API

    Last Name: User

    Reason: Alyce User

    Access Expires: Never

  4. On the Step 2: Permissions step, assign an API-Only User to the New Role.

  5. Check the box for API Only. Then hit Next. 

  6. Click Send, which you should be able to because an Invitation won't be required for API only access. 2020-02-12_18h18_58.png

  7.  After successfully doing so, the User that you just invited should appear at the bottom of your Users list. 

 

Create a new Service for Alyce in Marketo to find your Client ID and Client Secret

  1. Click LaunchPoint from the sidebar. (If you are unfamiliar with how LaunchPoint works, refer to Marketo's description here.)   
  2. Create a new Service using the toolbar dropdown labeled New: 
  3. Select Custom for the Service, and for API Only User, select the new API-only user that you just created and assigned the new custom role to. Our suggested description is "Service to allow Alyce access". 
  4. After clicking Create to complete adding the new Service, the Alyce Integration should again be listed at the bottom of the table list. Finally, you can click View Details to find both your Client ID and Client Secret.

2020-02-12_18h25_00.png

 

Connecting the Integration in Alyce 

Once you have your REST API Endpoint, Client ID, and Client Secret, navigate in Alyce to your user drop-down > Organization Settings > Integrations > Marketo and click Connect.

mceclip0.png

Input your REST API Endpoint, Client ID, and Client Secret in the three text fields provided then click the Connect Integration button.

mceclip1.png

Once you're successfully connected, the app should look like this: 

mceclip0.png

 

Enable custom objects to leverage gift data (currently gift name and URL) for personalized follow-up.

mceclip0.png

Select the custom activities (gift statuses) want to sync directly from Alyce to Marketo as well.

mceclip4.png

Note: Your Marketo subscription dictates the number of Custom Activities available to you.  Trouble connecting to all Alyce activities is normally indicative of having reached your limit.  Please work with your CSM to select the necessary subset of activities or your Marketo contact to increase your Custom Activities limit.

 

Congrats - the Alyce for Marketo integration is now successfully installed!

 

Disconnecting your Marketo Integration

If you choose to Disconnect the Marketo Integration, you can click the Disconnect integration button within the Marketo integration settings page.

mceclip3.png

1 out of 1 found this helpful

Comments

0 comments

Please sign in to leave a comment.