Connecting Marketo Engage to Sendoso

  • Updated

Sendoso integrates directly into Marketo Engage to make sending both physical and eGifts easy! Follow these steps to get your Marketo Engage instance connected to Sendoso: 
Please note you MUST be an admin in Marketo Engage

Set up in Marketo Engage for Sendoso 

This setup is a one-time process.

The first step is to create a new user for Sendoso. To do this, click on Admin:


Then, click on "Users & Roles" 


Next, you'll need to invite a new user. You can use the following information to set up your new user:

Email (use your company domain):
Name: Sendoso API
Role: Choose a role that will align with an API only user
Check API Only

Here is a document related to creating an API Only User


The next step is to create a new LaunchPoint:

Click on LaunchPoint and then click New Service:



Enter the New Service details:

Display Name: Sendoso
Service: Custom
Description: Sendoso
API Only User: Select the user we just created above

*Marketo Engage’s REST APIs are authenticated with 2-legged OAuth 2.0. Client IDs and Client Secrets are provided by custom services that you define. Each custom service is owned by an API-Only user which has a set of roles and permissions which authorize the service to perform specific actions. An access token is associated with a single custom service. Access token expiration is independent of tokens associated with other custom services that may be present in an instance.


Now that you have created the LaunchPoint, there are 3 pieces of information needed to connect Marketo to Sendoso:

Client ID & Client Secret (from the new LaunchPoint)
Rest API Endpoint URL (without "/rest")

Locating Sendoso Required Information

After creating the LaunchPoint, click on View Details:


Take note of the Client ID and Secret. Both of these are needed for Sendoso. 


The Base URL can be found by clicking Admin > Web Services:


Copy/Paste the REST API Endpoint URL (without the "/rest")


Take note of these as they will be added at the time of the Sendoso campaign setup. Continue below to finalize the last few pieces in Marketo, or head to our Creating a Marketo Engage Campaign article to see where this information is entered.

Setting up a Marketo Engage Custom Field for Sendoso 

There is one custom field required for the Sendoso + Marketo Engage integration to work.

To start, head to the Admin tab:


Click on Field Management:


Click on New Custom Field:


Now, enter the below custom field details:

Type: String
Name: Sendoso Touch ID
API Name: sendosoTouchID


That's it!

Setting up a Marketo Engage Webhook for Sendoso

We'll need to create a new Webhook just for Sendoso. 

Go back to the Admin tab:


Click on Webhooks:


Click on New Webhook:


Enter the below Webhook details:

Webhook Name: Sendoso
Request Type: Post
Request Token Encoding: JSON

The payload template is located here:

   "lead_id": {{}},
   "email": {{lead.Email Address}},
   "name": {{lead.First Name}},
   "last_name": {{lead.Last Name}}, 
   "company_name": {{company.Company Name}},
   "address": {{lead.address}},
   "city": {{}},
   "state": {{lead.state}},
   "zip": {{lead.Postal Code}},
   "country": {{}},
   "mobile_no": {{lead.Phone Number}}
 "uuid": {{lead.Sendoso Touch ID}},

The template above assumes you are using the standard fields in Marketo Engage. If you plan on leveraging custom fields from Marketo please let us know to assist with setting up the correct payload template.

To locate your Sendoso user key, click here.

The final webhook should look like this:


Next, you'll need to add a Custom Header to the Webhook that you just created.

Click on the new webhook and then hit, Webhook Actions > Set Custom Header


Now, click on "Add"

Enter "content-type" in the header

Enter "application/json" in the value


The webhook set up is completed!

Setting up a Marketo Engage Channel for Sendoso for Member Statuses 

This is optional but recommended. It will help you map the member status (i.e. shipped, delivered, etc)

Go to the admin tab


Click on Tags


Create a New Channel


We suggest you title it "Direct Mail" (or a similar variation).

You'll need to add a handful of statuses for Sendoso:


These statuses are assuming you will only be sending physical gifts through Marketo Engage webhooks. If you have questions about the statuses for triggering eGifts through a webhook, please reach out to us.

That's it! You have successfully completed all the necessary steps to integrate Marketo Engage with Sendoso.

Now, let's create a Campaign! Use our Creating a Marketo Engage Campaign to get started.

How do I find my Sendoso user key?

You can find your Sendoso user key by navigating to the User Settings section of Sendoso. Here you will see the "Key" field. Copy that and insert it into your payload template.


For a deep dive into the Marketo integration, check out this webinar and this Sendoso University course

Was this article helpful?

13 out of 13 found this helpful

Have feedback about this article? Click here to share your thoughts.