How to configure and activate a Marketo webhook for use with App Connect

If you want Marketo to trigger flows in App Connect, configure and activate a webhook in Marketo with the webhook callback URL that is provided by App Connect.

To configure a webhook in Marketo for use with App Connect, use the following settings.

The URL is the value of the webhook callback URL that is provided on the Marketo event node in an App Connect flow. To get this value from App Connect, create an event-driven flow and add a Marketo event (for example, a new lead). Copy the Webhook callback URL value that is shown.
Note: A webhook URL in App Connect is associated with an account. Therefore, all flows that use that account have the same webhook URL and are triggered when an event occurs.
For the Template, specify the fields of the Marketo object that you want to pass to other applications in the App Connect flow. For example, for the Marketo new lead event set the Payload Template in the following format.
```
firstName={{Lead.First Name}}&lastName={{Lead.Last Name}}&email={{Lead.Email Address}}&company={{Company.Company Name}}&id={{lead.Id}}
```
You can add more fields if needed, with the format &appconnect_fieldid={{marketo_token}}; for example, &salutation={{lead.Salutation}}.
Tip:
- To identify a field ID for Marketo in App Connect, insert a Marketo field into a field in another application, then click or edit the field. The field ID is shown after the trigger in the JSONata expression; for example: {{Trigger.firstName}}.
- To identify a Marketo token when you edit the webhook in Marketo, use the INSERT TOKEN function.
To configure Webhooks in Marketo, you need to be logged in as an administrator, or you can ask your Marketo administrator to create the webhook.
The following example steps are based on the use of Marketo for a new lead event in App Connect. For more information, see the following Marketo documentation.
- Administration > Additional Integrations > Create a Webhook
- Core Marketo Concepts > Smart Campaigns > Flow Actions > Use a Webhook in a Smart Campaign

Configure a Marketo webhook

To configure a webhook in Marketo for use with App Connect, complete the following steps.

Log in to Marketo with an administrator account.
On the Admin tab, click Integration > Webhooks to open the Webhooks configuration page.
Click New Webhook.
Specify the following webhook details.
- For the Webhook Name, specify a unique webhook name.
- For Description, describe the webhook.
- For URL, specify the webhook callback URL that you got from App Connect.
- For Template, specify the fields of the Marketo object that you want to pass to the App Connect flow, as described previously. For example, for the Marketo new lead event, use the following format.
```
firstName={{Lead.First Name}}&lastName={{Lead.Last Name}}&email={{Lead.Email Address}}&company={{Company.Company Name}}&id={{lead.Id}}
```
- Set the Request Type to post.
- Set Response Format to JSON.

These configuration details are sufficient, but you can add more details, such as request type and token encoding. When you click Create, the new webhook appears in the list.

Marketo Webhook for use in App Connect to trrigger a flow — Figure 1. Marketo webhook for use in App Connect to trrigger a flow.

Activating the webhook in a Smart Campaign

To activate a webhook in a Smart Campaign, complete the following steps in Marketo.

Click the Marketo icon and select Marketing Activities.
In the configuration pane, click New > New Smart Campaign.
Select a folder (or create one) to contain the campaign.
Provide a unique name and description for the campaign, then click CREATE.
On the Smart List tab, drag the Lead is created trigger from the search to the space provided.
Add any constraints that you need.
On the Flow tab, drag Call Webhook from the Integration tab to the space provided, and select the campaign that you created.
On the Schedule tab, click ACTIVATE.

The webhook is now ready. When a new lead is created in Marketo (for the ‘Lead is created’ trigger), the lead is passed to the App Connect flow (with the Marketo New Lead event). For more information, see How to use IBM® App Connect with Marketo.