---
title: "Introduction"
slug: "introduction-1"
updated: 2026-06-25T16:15:55Z
published: 2026-06-25T16:15:55Z
canonical: "support.jacquard.com/introduction-1"
---

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

# Introduction

**Jacquard Webhooks**<small class='article-version'>1.0.0</small>
									
										
										

This is a collection of the REST API requests for Jacquards's webhook / tracking pixel which can be used to send data to Jacquard about the performance metrics of experiments. The following metrics are currently supported:

- Opens
- Clicks
- Unsubscribes
- Conversions

More help and support, along with step-by-step setup guides for individual ESPs, can be found here: [https://support.jacquard.com](https://support.jacquard.com)

## Parameters

| Parameter | Description | Example Value | **Required?** |
| --- | --- | --- | --- |
| variant_id | The Jacquard variant id | 62a857d781b6eb23b1e77f8e | Sometimes |
| campaign_id | The Jacquard experiment / campaign id | 62a3479f8fcd86d5704b546d | Sometimes |
| account_id | The Jacquard account id | 62a34835f1cba8d71359cb0b | No |
| batch_id | The Jacquard batch id, if using Dynamic Optimization | 10002 | Sometimes |
| project_id | The Jacquard project id | 62a34d79d87a17b87f74bb10 | No |
| delivery_id | The id for the message delivery, usually provided by your ESP | 742322 | Sometimes |
| recipient_id | The id of the recipient receiving the delivery, usually provided by your ESP. **Note: Jacquard hashes the recipient id, and never stores the raw passed in value.** | 9283672739 | Sometimes |
| send_id | The unique ID identifying this specific send to a recipient | 673457-11235-34235-23523 | Sometimes |
| return_pixel | Whether the API call should return a 1x1 pixel, intended for use with the GET open request. This defaults to true if no value is passed. | false | No |

The required parameters change depending on a number of factors, including if you are using the realtime API.

If using the realtime API, only ***delivery_id*** and ***recipient_id*** are required, and as long as the same ids were provided on the call to the realtime API, Jacquard can infer the other values from what has already been stored.

If using Dynamic Optimization without the realtime API, the following fields are required: ***variant_id***, ***campaign_id***, ***batch_id*** and ***send_id***.

## GET Requests

Parameters can be passed as query parameters.

## POST Requests

Parameters can be passed as query or body parameters. Query parameters take precedence over body parameters.

For certain ESPs which are less flexible about what can be defined in the POST body, Jacquard can map to the expected field names. This includes:

- Iterable: When the body is received, `dataFields.campaignId` gets mapped to `delivery_id`, and `email` gets mapped to `recipient_id`.

## Open Tracking Pixel in email

Where webhooks can't be used, opens can also be tracked by utilising the Open webhook as a 1x1 tracking pixel in an email. This involves adding an image to the HTML body of the email, with the webhook url as the value for the **src** property, for example:

```html
<img class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; src="https://mail-tracking.jacquard.com/live/open?campaign_id={{jacquard_campaign_id}}&delivery_id={{delivery_id}}&recipient_id={{email}}" style="visibility:hidden" width="1px" height="1px" />
```

   
										
										  
 
										
										

| **Servers** |
| --- |
| [https://mail-tracking.phrasee.co](https://mail-tracking.phrasee.co) |