> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thnks.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Marketo

> This integration allows you to set up a webhook in Marketo that automatically triggers sending a Thnks through a Smart Campaign.

# Configuring a Smart Campaign in Marketo to Automatically Send a Thnks

This guide walks you through automatically triggering the sending of a Thnks as part of a Marketo Smart Campaign.

## Prerequisites

* Access to the Thnks API.

* Thnks API Key (Authorization Token).

* URL for Thnks API endpoint.

## Setup

**1. Prepare Webhook Data**

Before setting up the webhook, ensure you have the following details:

**1. Thnks API URL**

`https://api.thnks.com/api/v1/gift_requests`

**2. HTTP Method**

`POST`

**3. Data (JSON format)**

Here’s an example of the JSON payload you will need to include in the request. You’ll need to replace the placeholders with the appropriate tokens from your Marketo leads:

```json theme={null}
{
  "gift_id": "<GIFT_ID>",
  "recipients": [
    {
      "email": "{{lead.Email Address}}",
      "first_name": "{{lead.First Name}}",
      "last_name": "{{lead.Last Name}}",
      "message": "Thank you for your time and support!",
      "gift_redeem_type": "email"
    }
  ]
}
```

* Replace `<GIFT_ID>` with the Thnks ID of the gift you want to send.

* Use Marketo tokens (e.g., `{{lead.Email Address}}`) to populate dynamic lead information.

**4. Headers**

You will need to add the following headers in the webhook:

* **Content-Type**: `application/json`

* **Authorization**: Your Thnks API key (Authorization Token).

**2. Create a Webhook in Marketo**

**1. Log into Marketo and go to the Admin section**

**2. Under Integrations, click Webhooks**

**3. Click New Webhook to create a new webhook**

* **Webhook Name**: Give your webhook a meaningful name, e.g., `Thnks_Welcome_Program_CA`.

* **URL**: Use the Thnks API URL:\
  `https://api.thnks.com/api/v1/gift_requests`

* **Request Type**: Set this to `POST`.

* **Template**: Copy the JSON template mentioned above and adjust as needed with the correct tokens for dynamic data population.

* **Request Token Encoding**: None.

* **Response Type**: Set to `JSON`.

**4. Add Custom Headers**

* **Content-Type**: `application/json`

* **Authorization**: Paste your Thnks API Key.

**3. Map Webhook Response (Optional)**

**1. Response Mappings**

If you want to capture response data, you can map response attributes to Marketo fields. For example, you can capture a response code or success status.

**4. Add Webhook to Smart Campaign**

**1. Create or Edit a Smart Campaign in Marketo**

**2. In the Flow tab of the campaign, add the Call Webhook action**

**3. Select the webhook you just created (e.g., Thnks\_Welcome\_Program\_CA)**

**4. Adjust other flow actions and campaign settings as needed**

**5. Test and Verify**

**1. Run a test by triggering the Smart Campaign with a test lead**

**2. Check the response from Thnks in the webhook log**

**3. Make any necessary adjustments to the payload or tokens based on the test results**

**6. Best Practices**

**1. Error Handling**

Include error handling in your campaign to manage cases where the webhook might fail.

**2. Security**

Ensure your webhook is set up securely and tokens are protected.

**3. Testing**

Run multiple tests with different scenarios to ensure all lead tokens and variables are working correctly.

Following this process, you can automatically trigger a Thnks gift to be sent as part of a Marketo Smart Campaign using webhooks.

## References

* [Use a Webhook in a Smart Campaign](https://experienceleague.adobe.com/en/docs/marketo/using/product-docs/core-marketo-concepts/smart-campaigns/flow-actions/use-a-webhook-in-a-smart-campaign)

* [Create a Webhook](https://experienceleague.adobe.com/en/docs/marketo/using/product-docs/administration/additional-integrations/create-a-webhook)

* [Thnks API Documentation](https://docs.thnks.com/api-reference/endpoint/create_gift_request.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.