Marketo Engage Errors and Troubleshooting

Sendoso allows our senders to trigger sends through Marketo Engage via webhooks and dynamic eGift links.

Unfortunately, the following errors can be shown if the Marketo Engage setup is incorrectly set up. 

Marketo Engage Webhook Errors

200 - This is a successful response but if you're seeing no activity in Sendoso after 30 minutes. The following steps should be taken: 

  • Touch must be active
  • Products have to be in stock
  • Funding source in touch setup must be funded
  • Touch setup must not be showing errors(ex: 600 error - Marketo Engage token is no longer valid) - New touch will resolve this.
  • Check your trigger approvals, sends could have been sent to the trigger approval queue based on the trigger approval option being selected in the touch set up at one point.

If the issue persists, please connect with the support team to help provide more insight. 

400 -  Webhook Failed. Server Returned code 400 

  • All Payload template fields are required in the webhook.
  • Touch must be active
  • The touch ID must match what is listed in the touch setup in Marketo Engage Flow

112dd40ce330e868ab1b5bb321b80fa246cb1ad9.png

400 - Webhook failed. Bad URL Request, No Response

  • User Key issues
  • Payload template is incorrect (typos/missing fields)

Screen_Shot_2022-08-03_at_7.07.31_AM.png

  • The webhook must be pasted into Marketo Engage Payload Template with the exact format shown

Default Marketo Engage webhook fields

{
 "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"
}


Marketo Engage Custom webhook (Custom Address confirmation form

{
"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.personalAddress}},
  "city": {{lead.personalCity}},
  "state": {{lead.personalState}},
  "zip": {{lead.personalZip Code}},
  "country": {{lead.personalCountry}},
"mobile_no": {{lead.personalPhone}}
},
"uuid": {{lead.Sendoso Touch ID}},
"key": "ENTER USER KEY FROM SENDOSO"
}

401 - HTTP Error 401: Unauthorized access to URL

  • The custom header must be assigned to webhook
  • Customer Header should be "content-type" and Value should be "application/json"
  • To update the customer header in Marketo:
    • Admin Tab > Webhooks > Select Webhook > Webhook Actions > Set Custom Header
  • Webhook format could be corrupted and new Marketo Engage Payload template for this article is needed.

20328515f13e179e57fe2c1d931a1e5f91324b9c-3.jpg

409 - Server Returned code 409 

  • Do not remove the quotations around the touch ID in the Marketo Engage Payload template
"key": "ENTER YOUR USER KEY HERE"
  • Webhook Format could be causing this and new Payload Template is needed to pasted

601 - Error 2 (Invalid User Credentials): 601: Access token invalid 

  • Marketo Engage API permissions aren't set to the following for the Marketo Engage User that created the Client ID, Client Secret, and Base URL.
    • Read-Only Asset
    • Read-Write Person

Please see the following documentation for details: 

Descriptions of Role Permissions in Marketo

Create an API Only User Role in Marketo

Dynamic eGift Link Errors

If you receive the following "Email is not verified" error, then the following will solve this issue. Please note that no send activity is created in Sendoso when this error is shown. Also, please note that dynamic eGift Links cannot be sent to a recipient more than once.

Screen_Shot_2021-01-13_at_3.22.53_PM.png

  1. All Marketo Engage emails containing the eGift link must be live and not test emails 
  2. Egift URL must be hyperlinked in the email template
  3. Recipients must exist as contacts/leads with Marketo Engage.
  4. The URL cannot have any augmentation. Any changes will result in no send activity and inactive eGift links for your recipients.
  5. Within Marketo Engage - if clients are using any of the modular templates that are part of the launch pack, there is a global entry for tracking params in the template. 
    • This 'feature' appends params to buttons IF params are added. Otherwise, it's a harmless '?' that is appended to the URL. Removal is easy within the template (removing the string of variables and the input fields). 

If the following error 'Invalid URL!' results then the following will solve this issue. No send activity is created in Sendoso when this error is shown.

Screen_Shot_2021-01-14_at_2.11.51_PM.png

  1. Touch must be active.
  2. Valid Client ID, Client Secret, and Base URL is used in Touch setup
  3. The recipient email cannot have a 'plus sign modifier' in it. The plus modifier is not handled properly within the dynamic link redirect and an unmodified email address must be used.
  4. The "Include mtk_tok" check box in the hyperlink setup can also prohibit redemption. Please ensure you do NOT have this checked.

Screen_Shot_2021-12-17_at_3.11.04_PM.png

Still running into issues? Please reach out to our Support team for assistance.

Was this article helpful?
1 out of 1 found this helpful

Comments

0 comments

Article is closed for comments.