{"activeVersionTag":"latest","latestAvailableVersionTag":"latest","collection":{"info":{"_postman_id":"bef0f546-59ac-4718-a7b1-d71e2323bf01","name":"Jacquard Webhooks","description":"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:\n\n- Opens\n    \n- Clicks\n    \n- Unsubscribes\n    \n- Conversions\n    \n\nMore help and support, along with step-by-step setup guides for individual ESPs, can be found here: [https://support.jacquard.com](https://support.phrasee.co)\n\n## Parameters\n\n| Parameter | Description | Example Value | **Required?** |\n| --- | --- | --- | --- |\n| variant_id | The Jacquard variant id | 62a857d781b6eb23b1e77f8e | Sometimes |\n| campaign_id | The Jacquard experiment / campaign id | 62a3479f8fcd86d5704b546d | Sometimes |\n| account_id | The Jacquard account id | 62a34835f1cba8d71359cb0b | No |\n| batch_id | The Jacquard batch id, if using Dynamic Optimization | 10002 | Sometimes |\n| project_id | The Jacquard project id | 62a34d79d87a17b87f74bb10 | No |\n| delivery_id | The id for the message delivery, usually provided by your ESP | 742322 | Sometimes |\n| 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 |\n| send_id | The unique ID identifying this specific send to a recipient | 673457-11235-34235-23523 | Sometimes |\n| 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 |\n\nThe required parameters change depending on a number of factors, including if you are using the realtime API.\n\nIf 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, Phrasee can infer the other values from what has already been stored.\n\nIf using Dynamic Optimization without the realtime API, the following fields are required: _**variant_id**_, _**campaign_id**_, _**batch_id**_ and _**send_id**_.\n\n## GET Requests\n\nParameters can be passed as query parameters.\n\n## POST Requests\n\nParameters can be passed as query or body parameters. Query parameters take precedence over body parameters.\n\nFor certain ESPs which are less flexible about what can be defined in the POST body, Phrasee can map to the expected field names. This includes:\n\n- Iterable: When the body is received, `dataFields.campaignId` gets mapped to `delivery_id`, and `email` gets mapped to `recipient_id`.\n    \n\n## Open Tracking Pixel in email\n\nWhere 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:\n\n``` html\n<img 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\" />\n\n ```","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","isPublicCollection":false,"owner":"3533473","collectionId":"bef0f546-59ac-4718-a7b1-d71e2323bf01","publishedId":"UzBgvqD3","public":true,"publicUrl":"https://docs.mail-tracking.phrasee.co","privateUrl":"https://go.postman.co/documentation/3533473-bef0f546-59ac-4718-a7b1-d71e2323bf01","customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"fe5000"},"documentationLayout":"classic-double-column","customisation":null,"version":"8.10.0","publishDate":"2022-06-14T13:31:06.000Z","activeVersionTag":"latest","documentationTheme":"light","metaTags":{},"logos":{}},"statusCode":200},"environments":[{"name":"Live","id":"103d5694-b110-4a0e-8c55-dde57c76ecf3","owner":"3533473","values":[{"key":"webhookUrl","value":"https://mail-tracking.phrasee.co","enabled":true,"type":"default"},{"key":"environment","value":"live","enabled":true,"type":"default"},{"key":"realtimeUrl","value":"https://realtime.phrasee.co","enabled":true,"type":"default"}],"published":true}],"user":{"authenticated":false,"permissions":{"publish":false}},"run":{"button":{"js":"https://run.pstmn.io/button.js","css":"https://run.pstmn.io/button.css"}},"web":"https://www.getpostman.com/","team":{"logo":"https://res.cloudinary.com/postman/image/upload/t_team_logo_pubdoc/v1/team/768118b36f06c94b0306958b980558e6915839447e859fe16906e29d683976f0","favicon":"https://phrasee.co/favicon.ico"},"isEnvFetchError":false,"languages":"[{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"HttpClient\"},{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"RestSharp\"},{\"key\":\"curl\",\"label\":\"cURL\",\"variant\":\"cURL\"},{\"key\":\"dart\",\"label\":\"Dart\",\"variant\":\"http\"},{\"key\":\"go\",\"label\":\"Go\",\"variant\":\"Native\"},{\"key\":\"http\",\"label\":\"HTTP\",\"variant\":\"HTTP\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"OkHttp\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"Unirest\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"Fetch\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"jQuery\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"XHR\"},{\"key\":\"c\",\"label\":\"C\",\"variant\":\"libcurl\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Axios\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Native\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Request\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Unirest\"},{\"key\":\"objective-c\",\"label\":\"Objective-C\",\"variant\":\"NSURLSession\"},{\"key\":\"ocaml\",\"label\":\"OCaml\",\"variant\":\"Cohttp\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"cURL\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"Guzzle\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"HTTP_Request2\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"pecl_http\"},{\"key\":\"powershell\",\"label\":\"PowerShell\",\"variant\":\"RestMethod\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"http.client\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"Requests\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"httr\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"RCurl\"},{\"key\":\"ruby\",\"label\":\"Ruby\",\"variant\":\"Net::HTTP\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"Httpie\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"wget\"},{\"key\":\"swift\",\"label\":\"Swift\",\"variant\":\"URLSession\"}]","languageSettings":[{"key":"csharp","label":"C#","variant":"HttpClient"},{"key":"csharp","label":"C#","variant":"RestSharp"},{"key":"curl","label":"cURL","variant":"cURL"},{"key":"dart","label":"Dart","variant":"http"},{"key":"go","label":"Go","variant":"Native"},{"key":"http","label":"HTTP","variant":"HTTP"},{"key":"java","label":"Java","variant":"OkHttp"},{"key":"java","label":"Java","variant":"Unirest"},{"key":"javascript","label":"JavaScript","variant":"Fetch"},{"key":"javascript","label":"JavaScript","variant":"jQuery"},{"key":"javascript","label":"JavaScript","variant":"XHR"},{"key":"c","label":"C","variant":"libcurl"},{"key":"nodejs","label":"NodeJs","variant":"Axios"},{"key":"nodejs","label":"NodeJs","variant":"Native"},{"key":"nodejs","label":"NodeJs","variant":"Request"},{"key":"nodejs","label":"NodeJs","variant":"Unirest"},{"key":"objective-c","label":"Objective-C","variant":"NSURLSession"},{"key":"ocaml","label":"OCaml","variant":"Cohttp"},{"key":"php","label":"PHP","variant":"cURL"},{"key":"php","label":"PHP","variant":"Guzzle"},{"key":"php","label":"PHP","variant":"HTTP_Request2"},{"key":"php","label":"PHP","variant":"pecl_http"},{"key":"powershell","label":"PowerShell","variant":"RestMethod"},{"key":"python","label":"Python","variant":"http.client"},{"key":"python","label":"Python","variant":"Requests"},{"key":"r","label":"R","variant":"httr"},{"key":"r","label":"R","variant":"RCurl"},{"key":"ruby","label":"Ruby","variant":"Net::HTTP"},{"key":"shell","label":"Shell","variant":"Httpie"},{"key":"shell","label":"Shell","variant":"wget"},{"key":"swift","label":"Swift","variant":"URLSession"}],"languageOptions":[{"label":"C# - HttpClient","value":"csharp - HttpClient - C#"},{"label":"C# - RestSharp","value":"csharp - RestSharp - C#"},{"label":"cURL - cURL","value":"curl - cURL - cURL"},{"label":"Dart - http","value":"dart - http - Dart"},{"label":"Go - Native","value":"go - Native - Go"},{"label":"HTTP - HTTP","value":"http - HTTP - HTTP"},{"label":"Java - OkHttp","value":"java - OkHttp - Java"},{"label":"Java - Unirest","value":"java - Unirest - Java"},{"label":"JavaScript - Fetch","value":"javascript - Fetch - JavaScript"},{"label":"JavaScript - jQuery","value":"javascript - jQuery - JavaScript"},{"label":"JavaScript - XHR","value":"javascript - XHR - JavaScript"},{"label":"C - libcurl","value":"c - libcurl - C"},{"label":"NodeJs - Axios","value":"nodejs - Axios - NodeJs"},{"label":"NodeJs - Native","value":"nodejs - Native - NodeJs"},{"label":"NodeJs - Request","value":"nodejs - Request - NodeJs"},{"label":"NodeJs - Unirest","value":"nodejs - Unirest - NodeJs"},{"label":"Objective-C - NSURLSession","value":"objective-c - NSURLSession - Objective-C"},{"label":"OCaml - Cohttp","value":"ocaml - Cohttp - OCaml"},{"label":"PHP - cURL","value":"php - cURL - PHP"},{"label":"PHP - Guzzle","value":"php - Guzzle - PHP"},{"label":"PHP - HTTP_Request2","value":"php - HTTP_Request2 - PHP"},{"label":"PHP - pecl_http","value":"php - pecl_http - PHP"},{"label":"PowerShell - RestMethod","value":"powershell - RestMethod - PowerShell"},{"label":"Python - http.client","value":"python - http.client - Python"},{"label":"Python - Requests","value":"python - Requests - Python"},{"label":"R - httr","value":"r - httr - R"},{"label":"R - RCurl","value":"r - RCurl - R"},{"label":"Ruby - Net::HTTP","value":"ruby - Net::HTTP - Ruby"},{"label":"Shell - Httpie","value":"shell - Httpie - Shell"},{"label":"Shell - wget","value":"shell - wget - Shell"},{"label":"Swift - URLSession","value":"swift - URLSession - Swift"}],"layoutOptions":[{"value":"classic-single-column","label":"Single Column"},{"value":"classic-double-column","label":"Double Column"}],"versionOptions":[],"environmentOptions":[{"value":"0","label":"No Environment"},{"label":"Live","value":"3533473-103d5694-b110-4a0e-8c55-dde57c76ecf3"}],"canonicalUrl":"https://docs.mail-tracking.phrasee.co/view/metadata/UzBgvqD3"}