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): sendoso@domain.com
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
URL: https://app.sendoso.com/api/v3/marketo
Request Type: Post
Request Token Encoding: JSON
The payload template is located here:
{
"send":
{
"lead_id": {{lead.id}},
"email": {{lead.Email Address}},
"name": {{lead.First Name}},
"last_name": {{lead.Last Name}},
"company_name": {{company.Company Name}},
"address": {{lead.address}},
"city": {{lead.city}},
"state": {{lead.state}},
"zip": {{lead.Postal Code}},
"country": {{lead.country}},
"mobile_no": {{lead.Phone Number}}
},
"uuid": {{lead.Sendoso Touch ID}},
"key": "ENTER USER KEY FROM SENDOSO"
}
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 additional training on Marketo integration, feel free to check out these Sendoso University courses.
If you are a prospect, see how you can use Sendoso to send from your CRM.