{"id":97394,"date":"2023-03-13T16:17:21","date_gmt":"2023-03-13T20:17:21","guid":{"rendered":"https:\/\/optinmonster.com\/?post_type=optinmonster_docs&#038;p=97394"},"modified":"2025-11-18T12:39:28","modified_gmt":"2025-11-18T17:39:28","slug":"how-to-connect-optinmonster-with-a-webhook","status":"publish","type":"optinmonster_docs","link":"https:\/\/optinmonster.com\/docs\/how-to-connect-optinmonster-with-a-webhook\/","title":{"rendered":"How to Connect OptinMonster with a Webhook"},"content":{"rendered":"\n<p>OptinMonster offers seamless integration with webhooks using our native integration.<\/p>\n\n\n\n<p>In this article, you&#8217;ll learn how to connect a webhook to OptinMonster.<\/p>\n\n\n\n<div class=\"wp-block-columns is-layout-flex wp-container-core-columns-is-layout-28f84493 wp-block-columns-is-layout-flex\">\n<div class=\"wp-block-column alert alert-info is-layout-flow wp-block-column-is-layout-flow\">\n<p><strong><em>Before you start<\/em><\/strong>, this integration is available with a <a title=\"Pro and higher subscription\" href=\"https:\/\/optinmonster.com\/pricing\" target=\"_blank\" rel=\"noopener\">Pro and higher subscription<\/a>.<br>All subscription plans can add custom forms using the <a href=\"https:\/\/optinmonster.com\/docs\/how-to-connect-optinmonster-with-any-custom-html-form\/\">Form Embed block<\/a>.<\/p>\n\n\n\n<p>As a best practice, we recommend you also connect your campaigns to <a href=\"https:\/\/optinmonster.com\/docs\/connect-monster-leads-optinmonster\/\">Monster Leads<\/a>\u00a0as a backup.<\/p>\n<\/div>\n<\/div>\n\n\n\n<h2 class=\"wp-block-heading\">Connect Webhook<\/h2>\n\n\n\n<p>When you <a href=\"https:\/\/optinmonster.com\/docs\/creating-your-first-optin\/\" target=\"_blank\" rel=\"noopener\" title=\"\">create a campaign<\/a> in OptinMonster that you intend to collect leads with you\u2019ll want to integrate with one or more services to send those leads to.<\/p>\n\n\n\n<p>To send those leads to a webhook, follow these steps:<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Navigate to the Integrations view in the campaign builder, search for and select <strong>Webhook<\/strong>.<br><img decoding=\"async\" width=\"800\" height=\"362\" class=\"alignnone size-full wp-image-177403\" src=\"https:\/\/optinmonster.com\/wp-content\/uploads\/2023\/03\/webhook-integration.jpg\" alt=\"Select Webhook to integrate with OptinMonster.\" srcset=\"https:\/\/optinmonster.com\/wp-content\/uploads\/2023\/03\/webhook-integration.jpg 800w, https:\/\/optinmonster.com\/wp-content\/uploads\/2023\/03\/webhook-integration-300x136.jpg 300w, https:\/\/optinmonster.com\/wp-content\/uploads\/2023\/03\/webhook-integration-768x348.jpg 768w\" sizes=\"(max-width: 800px) 100vw, 800px\" \/><\/li>\n\n\n\n<li>Next, enter a <strong>Webhook<\/strong><strong>&nbsp;Account Name<\/strong> (*internal use only) and enter the <strong>Webhook URL<\/strong> into the appropriate fields, then select the <strong>Connect to Webhook<\/strong>&nbsp;button.<br><img decoding=\"async\" width=\"800\" height=\"349\" class=\"alignnone size-full wp-image-177402\" src=\"https:\/\/optinmonster.com\/wp-content\/uploads\/2023\/03\/webhook-connect-button.jpg\" alt=\"Connect OptinMonster with your Webhook.\" srcset=\"https:\/\/optinmonster.com\/wp-content\/uploads\/2023\/03\/webhook-connect-button.jpg 800w, https:\/\/optinmonster.com\/wp-content\/uploads\/2023\/03\/webhook-connect-button-300x131.jpg 300w, https:\/\/optinmonster.com\/wp-content\/uploads\/2023\/03\/webhook-connect-button-768x335.jpg 768w\" sizes=\"(max-width: 800px) 100vw, 800px\" \/><br><em>*The Webhook Account Name can be anything that helps you identify the specific integration within OptinMonster. It\u2019s possible to add more than one Webhook integration to your account and this is an easy way to differentiate between them when assigning integrations to individual campaigns.<\/em><\/li>\n\n\n\n<li>Once connected, you&#8217;ll be provided with an example of how Lead data will be submitted via JSON to your Webhook URL.<br><img decoding=\"async\" width=\"800\" height=\"553\" class=\"alignnone size-full wp-image-177401\" src=\"https:\/\/optinmonster.com\/wp-content\/uploads\/2023\/03\/webhook-example.jpg\" alt=\"Sample Webhook Data\" srcset=\"https:\/\/optinmonster.com\/wp-content\/uploads\/2023\/03\/webhook-example.jpg 800w, https:\/\/optinmonster.com\/wp-content\/uploads\/2023\/03\/webhook-example-300x207.jpg 300w, https:\/\/optinmonster.com\/wp-content\/uploads\/2023\/03\/webhook-example-768x531.jpg 768w\" sizes=\"(max-width: 800px) 100vw, 800px\" \/><\/li>\n\n\n\n<li>The same section of your integration will also confirm the Webhook URL data submits to.<br><img decoding=\"async\" width=\"800\" height=\"484\" class=\"alignnone size-full wp-image-177399\" src=\"https:\/\/optinmonster.com\/wp-content\/uploads\/2023\/03\/webhook-url.jpg\" alt=\"Webhook URL for individual integrations.\" srcset=\"https:\/\/optinmonster.com\/wp-content\/uploads\/2023\/03\/webhook-url.jpg 800w, https:\/\/optinmonster.com\/wp-content\/uploads\/2023\/03\/webhook-url-300x182.jpg 300w, https:\/\/optinmonster.com\/wp-content\/uploads\/2023\/03\/webhook-url-768x465.jpg 768w\" sizes=\"(max-width: 800px) 100vw, 800px\" \/><\/li>\n\n\n\n<li><strong>Optional<\/strong>: You can also configure a&nbsp;<strong>List Name<\/strong>, assign&nbsp;<strong>Tags<\/strong>, additional&nbsp;<strong>Data<\/strong>, and configure the <strong>Store IP Addresses? (Turn off for GDPR)<\/strong>&nbsp;option.<br><img decoding=\"async\" width=\"800\" height=\"555\" class=\"alignnone size-full wp-image-177400\" src=\"https:\/\/optinmonster.com\/wp-content\/uploads\/2023\/03\/webhook-optional-settings.jpg\" alt=\"Webhook optional settings in OptinMonster.\" srcset=\"https:\/\/optinmonster.com\/wp-content\/uploads\/2023\/03\/webhook-optional-settings.jpg 800w, https:\/\/optinmonster.com\/wp-content\/uploads\/2023\/03\/webhook-optional-settings-300x208.jpg 300w, https:\/\/optinmonster.com\/wp-content\/uploads\/2023\/03\/webhook-optional-settings-768x533.jpg 768w\" sizes=\"(max-width: 800px) 100vw, 800px\" \/><\/li>\n\n\n\n<li>When you&#8217;re finished, <strong>Save<\/strong> your campaign.<\/li>\n<\/ol>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"data-structure\">Data Structure<\/h2>\n\n\n\n<p>For Webhook integrations created on and after November 30, 2023, lead data is formatted via JSON and resembles the example below:<\/p>\n\n\n\n<div class=\"alert-box alert-blue\">\n<p class=\"alert-box-title\"><\/p>\n\n\n\n<p>Looking for the payload structure of integrations created before November 30, 2023? See the <strong>Changelog <\/strong>section below.<\/p>\n\n\n\n<p class=\"is-style-arrow-link has-link-color\"><\/p>\n<\/div>\n\n\n\n<script src=\"https:\/\/library.wpcode.com\/embedjs\/d2z3dero.js\/\"><\/script>\n\n\n\n<p>Your webhook can receive the following lead data:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><code>lead<\/code>\n<ul class=\"wp-block-list\">\n<li><code>email<\/code> &#8211; the email address submitted<\/li>\n\n\n\n<li><code>ipAddress<\/code> &#8211; the IP Address of the computer the lead was submitted from<\/li>\n\n\n\n<li><code>referrer<\/code> &#8211; the URL of the page the campaign was submitted from<\/li>\n\n\n\n<li><code>timestamp<\/code> &#8211; the timestamp when the campaign was submitted<\/li>\n\n\n\n<li><code>privacyConsent<\/code> &#8211; set to <code>true<\/code> if the <a href=\"https:\/\/optinmonster.com\/docs\/how-to-add-a-privacy-policy\/\" target=\"_blank\" rel=\"noopener\">Privacy Checkbox field<\/a> is present in your campaign form<\/li>\n\n\n\n<li><code>firstName<\/code> &#8211; the first name submitted if the name field is present in your campaign<\/li>\n\n\n\n<li><code>lastName<\/code> &#8211; the last name submitted if the name field is present in your campaign form<\/li>\n\n\n\n<li><code>phone<\/code> &#8211; the phone submitted if the <a href=\"https:\/\/optinmonster.com\/docs\/capture-phone-numbers-with-optinmonster\/\" target=\"_blank\" rel=\"noopener\">phone field<\/a> is present in your campaign form<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><code>lead_options<\/code>\n<ul class=\"wp-block-list\">\n<li><code>list<\/code> &#8211; list name (optional)<\/li>\n\n\n\n<li><code>tags<\/code> &#8211; tags to assign to lead (optional)<\/li>\n\n\n\n<li><code>data<\/code> &#8211; additional custom data that you want associated with each lead (optional)<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><code>campaign<\/code>\n<ul class=\"wp-block-list\">\n<li><code>id<\/code> &#8211; the unique ID of the campaign submitted<\/li>\n\n\n\n<li><code>title<\/code> &#8211; the title of the campaign submitted<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><code>meta<\/code>\n<ul class=\"wp-block-list\">\n<li>Extra fields from your campaign are passed through here, by field ID<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><code>smart_tags<\/code>\n<ul class=\"wp-block-list\">\n<li><code>day<\/code> &#8211; the day of the week the lead was captured<\/li>\n\n\n\n<li><code>month<\/code> &#8211; the month of the year the lead was captured<\/li>\n\n\n\n<li><code>year<\/code> &#8211; the year the lead was captured<\/li>\n\n\n\n<li><code>date<\/code> &#8211; the date the lead was captured<\/li>\n\n\n\n<li><code>page_url<\/code> &#8211; the URL of the page where the campaign converted<\/li>\n\n\n\n<li><code>referrer_url<\/code> &#8211; the URL of the page where user landed on converted page<\/li>\n\n\n\n<li><code>pages_visited<\/code> &#8211; total number of pages visited by the user in current visit<\/li>\n\n\n\n<li><code>time_on_site<\/code> &#8211; total time on site spent before converting<\/li>\n\n\n\n<li><code>visit_timestamp<\/code> &#8211; time of conversion<\/li>\n\n\n\n<li><code>page_title<\/code> &#8211; title of the page<\/li>\n\n\n\n<li><code>coupon_label<\/code> &#8211; coupon code label<\/li>\n\n\n\n<li><code>coupon_code<\/code> &#8211; coupon code that was displayed to user on conversion<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n\n\n\n<p>You can also pass Smart Tag data along with the lead data using our Webhook integration. <a href=\"https:\/\/optinmonster.com\/docs\/how-to-use-smart-tags-in-optinmonster\/\" target=\"_blank\" rel=\"noopener\" title=\"\">Learn more about Smart Tags<\/a><\/p>\n\n\n\n<div class=\"alert-box alert-white\">\n<p class=\"alert-box-title\"><\/p>\n\n\n\n<p><strong>Note: <\/strong>Our Webhook integration only includes location smart tag values automatically in the Webhook request body if a <a href=\"https:\/\/optinmonster.com\/docs\/how-to-geo-target-your-optins\/\" target=\"_blank\" rel=\"noreferrer noopener\">geolocation rule<\/a> is added as a display rule in the campaign.<\/p>\n\n\n\n<p class=\"is-style-arrow-link has-link-color\"><\/p>\n<\/div>\n\n\n\n<h3 class=\"wp-block-heading\">Example:<\/h3>\n\n\n\n<script src=\"https:\/\/library.wpcode.com\/embedjs\/x5n1vppo.js\/\"><\/script>\n\n\n\n<h2 class=\"wp-block-heading\">Add Extra Fields<\/h2>\n\n\n\n<div class=\"wp-block-columns is-layout-flex wp-container-core-columns-is-layout-28f84493 wp-block-columns-is-layout-flex\">\n<div class=\"wp-block-column alert alert-info is-layout-flow wp-block-column-is-layout-flow\">\n<p>This integration supports Field Mapping, so you can easily add radio buttons, phone fields, text areas, number fields, lists, and more!<\/p>\n\n\n\n<p class=\"is-style-arrow-link\"><a title=\"How to Use Field Mapping to Add Extra Fields to Your Campaign Form\" href=\"https:\/\/optinmonster.com\/docs\/use-field-mapping-to-add-extra-fields-to-your-optin-form\/\" target=\"_blank\" rel=\"noopener\">Get started using Field Mapping today<\/a><\/p>\n<\/div>\n<\/div>\n\n\n\n<p><em><strong>Before you<\/strong> begin using Field Mapping with Webhooks, please consider the following:<\/em><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Custom fields<\/strong> are passed into the <code>meta<\/code> key of the JSON payload.<\/li>\n\n\n\n<li>You can also pass Custom Smart Tag data using our Webhook integration. <a href=\"https:\/\/optinmonster.com\/docs\/how-to-use-smart-tags-in-optinmonster\/\" target=\"_blank\" rel=\"noopener\" title=\"\">Learn more about Smart Tags<\/a>.<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Email Automations<\/h2>\n\n\n\n<p>To send emails automatically to new leads you\u2019ll want to configure email automations within the Email Service Provider account your Webhook sends data to.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Testing<\/h2>\n\n\n\n<p>We strongly recommend you test the optin form before publishing your campaign to ensure it is working as you expect.<\/p>\n\n\n\n<div class=\"alert-box alert-blue\">\n<p class=\"alert-box-title\"><\/p>\n\n\n\n<p><a href=\"https:\/\/webhook.site\/#!\/\" target=\"_blank\" rel=\"noopener nofollow\" title=\"\">Webhook.site<\/a> is a great free Webhook testing tool you can use to quickly expose the JSON data sent from OptinMonster via Webhook.<\/p>\n\n\n\n<p class=\"is-style-arrow-link has-link-color\"><\/p>\n<\/div>\n\n\n\n<p><em>Before you begin<strong>, please be aware of the following details when testing Webhook integrations:<\/strong><\/em><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>When testing Webhook submissions, we recommend you pay particular attention to the JSON data captured to ensure all <code>lead<\/code>, <code>lead_options<\/code>, <code>campaign<\/code>, and <code>smart_tags<\/code> data is being captured as you expect. The <a href=\"https:\/\/optinmonster.com\/docs\/how-to-enable-test-mode\/\" target=\"_blank\" rel=\"noopener\" title=\"\">Live Site Inspector tool<\/a> is the testing feature you&#8217;ll want to use for test-submitting an optin form before you&#8217;ve Published a campaign live to your site.<\/li>\n\n\n\n<li>We recommend using a completely unique email address each time you test submit your campaign\u2019s form. You can use a free tool like <a href=\"https:\/\/temp-mail.io\/\" target=\"_blank\" rel=\"nofollow noopener\">TempMail.io<\/a>&nbsp;or learn how to&nbsp;<a href=\"https:\/\/medium.com\/@liamhammett\/make-infinite-gmail-addresses-for-one-inbox-ec7080de859d\" target=\"_blank\" rel=\"nofollow noopener\">create unlimited unique email addresses from a single Gmail account<\/a>.<\/li>\n\n\n\n<li><strong>If the lead is captured by your Webhook but no automated emails are sent (and they are expected to)<\/strong> it indicates the integration from OptinMonster to Webhook is correct, and the issue is with the automated email configuration. Email automation is not controlled by OptinMonster in any capacity. If you require assistance in troubleshooting email automations we recommend you reach out to the Email Service Provider you&#8217;ve configured the email automations through directly.<\/li>\n<\/ul>\n\n\n\n<p>Get started testing with the <strong>Live Site Inspector<\/strong> tool explained in our guide on <a href=\"https:\/\/optinmonster.com\/docs\/how-to-enable-test-mode\/\" target=\"_blank\" rel=\"noreferrer noopener\">how to test an OptinMonster campaign<\/a>.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Spin-a-Wheel Support<\/h2>\n\n\n\n<p>If you are configuring a&nbsp;<a href=\"https:\/\/optinmonster.com\/docs\/how-to-create-a-gamified-spin-to-win-coupon-wheel-popup-campaign\/\" target=\"_blank\" rel=\"noopener\" title=\"\">Gamified spin-to-win campaign<\/a>, Spin-a-Wheel support is automatically enabled. This will pass the <strong>Coupon Label<\/strong>&nbsp;and&nbsp;<strong>Coupon Code<\/strong> to your Webhook in the <code>smart_tags<\/code> key with each lead.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">FAQs<\/h2>\n\n\n\n<h5 class=\"wp-block-heading\">What Authentication methods does your Webhook integration support?<\/h5>\n\n\n\n<p>At this time we do not support Authentication for Webhook. The data is passed directly to the Webhook endpoint you&#8217;ve set for your integration.<\/p>\n\n\n\n<h5 class=\"wp-block-heading\" id=\"opt-in\">Can I send leads to more than one Webhook URL?<\/h5>\n\n\n\n<p>Yes! See our&nbsp;<a href=\"https:\/\/optinmonster.com\/docs\/send-data-to-multiple-providers\/\" target=\"_blank\" rel=\"noopener\" title=\"\">Lead Sharing guide<\/a>&nbsp;to accomplish this.<\/p>\n\n\n\n<h5 class=\"wp-block-heading\" id=\"more-info\">I&#8217;m new to Webhooks, how can I find out more about them?<\/h5>\n\n\n\n<p>Some good resources to learn more about the basics of webhooks include:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><a href=\"http:\/\/culttt.com\/2014\/01\/22\/webhooks\/\" target=\"_blank\" rel=\"external nofollow noopener noreferrer\">What Are Webhooks?<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/zapier.com\/blog\/what-are-webhooks\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">Webhooks Guide<\/a><\/li>\n<\/ul>\n\n\n\n<h5 class=\"wp-block-heading\" id=\"zapier\">I&#8217;d like to use Webhooks, but am not technical. Can I use Webhooks without writing any code?<\/h5>\n\n\n\n<p>Yes, in that instance we recommend using our <a href=\"https:\/\/optinmonster.com\/docs\/connect-optinmonster-with-zapier\/\" target=\"_blank\" rel=\"noopener\" title=\"\">Zapier integration<\/a> and <a href=\"https:\/\/zapier.com\/apps\/webhook\/integrations\/optinmonster\" target=\"_blank\" rel=\"nofollow noopener\">configure the Zap to send data from OptinMonster to Webhook<\/a>. That is the best approach to get started using Webhooks without having to know how to code anything.<\/p>\n\n\n\n<p>See our documentation for more ways to connect OptinMonster and Zapier:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><a href=\"https:\/\/optinmonster.com\/docs\/connect-optinmonster-with-zapier\/\" target=\"_blank\" rel=\"noopener noreferrer\" title=\"How to Connect OptinMonster with Zapier\">How to Connect OptinMonster with Zapier<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/optinmonster.com\/docs\/add-subscribers-to-a-google-spreadsheet-with-zapier\/\" target=\"_blank\" rel=\"noopener noreferrer\" title=\"How to Add Subscribers to a Google Spreadsheet with Zapier\">How to Add Subscribers to a Google Spreadsheet with Zapier<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/optinmonster.com\/docs\/how-to-add-subscribers-to-google-contacts-with-zapier\/\" target=\"_blank\" rel=\"noopener noreferrer\" title=\"How to Add Subscribers to Google Contacts with Zapier\">How to Add Subscribers to Google Contacts with Zapier<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/optinmonster.com\/docs\/how-to-receive-leads-to-your-email-with-zapier-optinmonster\/\" target=\"_blank\" rel=\"noopener noreferrer\">How to Receive Leads to Your Email with Zapier and OptinMonster<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/optinmonster.com\/docs\/how-to-send-subscribers-an-email-from-gmail-with-zapier-and-optinmonster\/\" target=\"_blank\" rel=\"noopener noreferrer\" title=\"How to Send Subscribers an Email from Gmail with Zapier and OptinMonster\">How to Send Subscribers an Email from Gmail with Zapier and OptinMonster<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/optinmonster.com\/docs\/how-to-send-text-messages-to-new-subscribers-using-twilio-and-zapier\/\" target=\"_blank\" rel=\"noopener noreferrer\" title=\"How to Send Text Messages to New Subscribers using Twilio and Zapier\">How to Send Text Messages to New Subscribers using Twilio and Zapier<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/optinmonster.com\/docs\/how-to-receive-text-messages-of-new-subscribers-using-sms-by-zapier\/\" target=\"_blank\" rel=\"noopener noreferrer\" title=\"How to Receive Text Messages of New Subscribers using SMS by Zapier\">How to Receive Text Messages of New Subscribers using SMS by Zapier<\/a><\/li>\n<\/ul>\n\n\n\n<h5 class=\"wp-block-heading\" id=\"name\">How do I collect the First and Last Names?<\/h5>\n\n\n\n<p>OptinMonster will automatically detect if someone has entered their first and last names into the Name input field. You only need to enable the <strong>Name<\/strong> field in the <strong>Fields Element<\/strong> to collect both the First and Last Name.<\/p>\n\n\n\n<h5 class=\"wp-block-heading\" id=\"error\">How can I update the Webhook URL the campaign data is sent to for my integration?<\/h5>\n\n\n\n<p>To change the Webhook URL your integration sends data to, follow these steps:<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Navigate to the <strong>OptinMonster Account<\/strong> &gt; <a href=\"https:\/\/app.optinmonster.com\/integrations\/\" target=\"_blank\" rel=\"noopener\">Integrations page<\/a>.<br><img decoding=\"async\" width=\"800\" height=\"422\" class=\"alignnone wp-image-177412 size-full\" src=\"https:\/\/optinmonster.com\/wp-content\/uploads\/2023\/03\/integrations-link-e1678653868965.jpg\" alt=\"Navigate to the Integrations page for your OptinMonster account.\" srcset=\"https:\/\/optinmonster.com\/wp-content\/uploads\/2023\/03\/integrations-link-e1678653868965.jpg 800w, https:\/\/optinmonster.com\/wp-content\/uploads\/2023\/03\/integrations-link-e1678653868965-300x158.jpg 300w, https:\/\/optinmonster.com\/wp-content\/uploads\/2023\/03\/integrations-link-e1678653868965-768x405.jpg 768w\" sizes=\"(max-width: 800px) 100vw, 800px\" \/><\/li>\n\n\n\n<li>From the Integrations page, select the <strong>Configure&nbsp;<\/strong>button for your Webhook integration.<br><img decoding=\"async\" width=\"800\" height=\"355\" class=\"alignnone size-full wp-image-177411\" src=\"https:\/\/optinmonster.com\/wp-content\/uploads\/2023\/03\/webhook-configure-integration.jpg\" alt=\"Configure Webhook integrations for your OptinMonster account.\" srcset=\"https:\/\/optinmonster.com\/wp-content\/uploads\/2023\/03\/webhook-configure-integration.jpg 800w, https:\/\/optinmonster.com\/wp-content\/uploads\/2023\/03\/webhook-configure-integration-300x133.jpg 300w, https:\/\/optinmonster.com\/wp-content\/uploads\/2023\/03\/webhook-configure-integration-768x341.jpg 768w\" sizes=\"(max-width: 800px) 100vw, 800px\" \/><\/li>\n\n\n\n<li>Locate the specific Webhook integration you want to edit from the list and select the <strong>Edit<\/strong> button.<br><img decoding=\"async\" width=\"800\" height=\"387\" class=\"alignnone size-full wp-image-177410\" src=\"https:\/\/optinmonster.com\/wp-content\/uploads\/2023\/03\/webhook-integration-edit.jpg\" alt=\"Edit individual Webhook integrations.\" srcset=\"https:\/\/optinmonster.com\/wp-content\/uploads\/2023\/03\/webhook-integration-edit.jpg 800w, https:\/\/optinmonster.com\/wp-content\/uploads\/2023\/03\/webhook-integration-edit-300x145.jpg 300w, https:\/\/optinmonster.com\/wp-content\/uploads\/2023\/03\/webhook-integration-edit-768x372.jpg 768w, https:\/\/optinmonster.com\/wp-content\/uploads\/2023\/03\/webhook-integration-edit-620x300.jpg 620w\" sizes=\"(max-width: 800px) 100vw, 800px\" \/><\/li>\n\n\n\n<li>Enter the <strong>new Webhook URL<\/strong> into the second input field to change where JSON data is sent for this integration.<br><img decoding=\"async\" width=\"800\" height=\"358\" class=\"alignnone size-full wp-image-177409\" src=\"https:\/\/optinmonster.com\/wp-content\/uploads\/2023\/03\/webhook-change-url.jpg\" alt=\"Update the Webhook URL in OptinMonster.\" srcset=\"https:\/\/optinmonster.com\/wp-content\/uploads\/2023\/03\/webhook-change-url.jpg 800w, https:\/\/optinmonster.com\/wp-content\/uploads\/2023\/03\/webhook-change-url-300x134.jpg 300w, https:\/\/optinmonster.com\/wp-content\/uploads\/2023\/03\/webhook-change-url-768x344.jpg 768w\" sizes=\"(max-width: 800px) 100vw, 800px\" \/><\/li>\n\n\n\n<li>When you&#8217;re finished,&nbsp;selectthe <strong>Update Integration to Webhook <\/strong>button to apply the changes to all campaigns using this specific Webhook integration.<br><img decoding=\"async\" width=\"800\" height=\"352\" class=\"alignnone size-full wp-image-177408\" src=\"https:\/\/optinmonster.com\/wp-content\/uploads\/2023\/03\/webhook-update-integration.jpg\" alt=\"Update the Webhook integration changes.\" srcset=\"https:\/\/optinmonster.com\/wp-content\/uploads\/2023\/03\/webhook-update-integration.jpg 800w, https:\/\/optinmonster.com\/wp-content\/uploads\/2023\/03\/webhook-update-integration-300x132.jpg 300w, https:\/\/optinmonster.com\/wp-content\/uploads\/2023\/03\/webhook-update-integration-768x338.jpg 768w\" sizes=\"(max-width: 800px) 100vw, 800px\" \/><\/li>\n<\/ol>\n\n\n\n<h5 class=\"wp-block-heading\">Is there a way to provide a custom error message from my Webhook?<\/h5>\n\n\n\n<p>If you manage the Webhook server and response, then you can specify your own error message via the Webhook response. If the response contains the &#8220;om_error_message&#8221; parameter, the error message will show that instead of the default &#8220;There was an error submitting your data.&#8221; message.<\/p>\n\n\n\n<h5 class=\"wp-block-heading\" id=\"response\">Is there a way to provide response data from my Webhook?<\/h5>\n\n\n\n<p>If you manage the Webhook server and response, then you can send back arbitrary data via the Webhook response. If the response contains the &#8220;om_response_data&#8221; parameter, this will be passed along to the webhook request response in the <code>data<\/code> parameter. Why would you want this? One example would be to modify the redirect URL for your form action.<\/p>\n\n\n\n<p>Send the following response from your webhook:<\/p>\n\n\n\n<script src=\"https:\/\/library.wpcode.com\/embedjs\/x5n6mrg2.js\/\"><\/script>\n\n\n\n<p>And place the following on your site to automatically use the response redirect data for a given campaign:<\/p>\n\n\n\n<script src=\"https:\/\/library.wpcode.com\/embedjs\/wox14d75.js\/\"><\/script>\n\n\n\n<h5 class=\"wp-block-heading\" id=\"ip-addresses\">How can I allowlist webhook requests from OptinMonster IP addresses?<\/h5>\n\n\n\n<p>Our webhooks will be sent from one of the following IP addresses:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>50.19.60.226<\/li>\n\n\n\n<li>50.17.52.222<\/li>\n\n\n\n<li>54.147.244.173<\/li>\n\n\n\n<li>35.153.24.227<\/li>\n\n\n\n<li>50.19.138.155<\/li>\n\n\n\n<li>50.19.173.212<\/li>\n\n\n\n<li>52.44.205.147<\/li>\n\n\n\n<li>34.198.233.235<\/li>\n\n\n\n<li>50.16.98.100<\/li>\n<\/ul>\n\n\n\n<h5 class=\"wp-block-heading\" id=\"force-connection\">How can I force the webhook to connect?<\/h5>\n\n\n\n<p>Occasionally, the method we use to authenticate and connect your webhook URL may fail. If you would like to force the connection, this is possible using a special query parameter on your webhook URL, <code>ignore_connection_failure=1<\/code>, e.g.:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code><code>https:\/\/example.com?ignore_connection_failure=1<\/code><\/code><\/pre>\n\n\n\n<p>If your webhook URL already has query parameters, you can add it like this:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code><code>https:\/\/example.com?param=1&amp;ignore_connection_failure=1<\/code><\/code><\/pre>\n\n\n\n<p>The actual <code>ignore_connection_failure=1<\/code> parameter will be remove from the URL during the webhook requests, but we use this flag to determine if we should force the connection.<\/p>\n\n\n\n\n\n<h2 class=\"wp-block-heading\">Troubleshooting<\/h2>\n\n\n\n<h5 class=\"wp-block-heading\">The campaign is capturing leads but shows 0 conversions in analytics.<\/h5>\n\n\n\n<p>Confirm that conversion tracking is turned on for the submit button in your campaign. See our guide on <a href=\"https:\/\/optinmonster.com\/docs\/how-to-enable-conversion-tracking\/\" target=\"_blank\" rel=\"noopener\" title=\"\">How to Enable Conversion Tracking<\/a>.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Changelog<\/h2>\n\n\n\n<h5 class=\"wp-block-heading\">Version 2.0.0 &#8211; Release Date: November 30, 2023<\/h5>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Addition of the <code>privacyConsent<\/code> field to the <code>lead<\/code> key in the JSON payload. The <code>privacyConsent<\/code> field will map the <em>Privacy Checkbox<\/em> field;<\/li>\n\n\n\n<li>Removal of redundant fields of the <code>smart_tags<\/code> key in the JSON payload. <em>Deleted fields: <code>form_*<\/code> (Ex.: <code>form_email<\/code>, <code>form_name<\/code>, <code>form_phone<\/code>, etc), <code>campaign_name<\/code>, <code>cn<\/code><\/em>;<\/li>\n\n\n\n<li>Addition of the <code>X-OptinMonster-Webhook-Version<\/code> header to the webhook request;<\/li>\n<\/ul>\n\n\n\n<p><em>Note: if your integration was created before November 30, 2023, the webhook request will still contain the removed fields.<\/em><\/p>\n\n\n\n<h5 class=\"wp-block-heading\">Version 1.0.0 &#8211; Before November 30, 2023:<\/h5>\n\n\n\n<script src=\"https:\/\/library.wpcode.com\/embedjs\/924zrk0o.js\/\"><\/script>\n","protected":false},"excerpt":{"rendered":"<p>OptinMonster offers seamless integration with webhooks using our native integration. In this article, you&#8217;ll learn how to connect a webhook to OptinMonster. Connect Webhook When you create a campaign in OptinMonster that you intend to collect leads with you\u2019ll want to integrate with one or more services to send those leads to. To send those&nbsp;&hellip;<\/p>\n","protected":false},"author":4657,"comment_status":"open","ping_status":"closed","template":"","documentation\/categories":[10],"documentation\/tags":[31399,31411,31454,31416,31410,31455,31946],"class_list":["post-97394","optinmonster_docs","type-optinmonster_docs","status-publish","hentry","categories-integrations"],"acf":[],"aioseo_notices":[],"_links":{"self":[{"href":"https:\/\/optinmonster.com\/wp-json\/wp\/v2\/documentation\/97394","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/optinmonster.com\/wp-json\/wp\/v2\/documentation"}],"about":[{"href":"https:\/\/optinmonster.com\/wp-json\/wp\/v2\/types\/optinmonster_docs"}],"author":[{"embeddable":true,"href":"https:\/\/optinmonster.com\/wp-json\/wp\/v2\/users\/4657"}],"replies":[{"embeddable":true,"href":"https:\/\/optinmonster.com\/wp-json\/wp\/v2\/comments?post=97394"}],"version-history":[{"count":43,"href":"https:\/\/optinmonster.com\/wp-json\/wp\/v2\/documentation\/97394\/revisions"}],"predecessor-version":[{"id":209491,"href":"https:\/\/optinmonster.com\/wp-json\/wp\/v2\/documentation\/97394\/revisions\/209491"}],"wp:attachment":[{"href":"https:\/\/optinmonster.com\/wp-json\/wp\/v2\/media?parent=97394"}],"wp:term":[{"taxonomy":"categories","embeddable":true,"href":"https:\/\/optinmonster.com\/wp-json\/wp\/v2\/documentation\/categories?post=97394"},{"taxonomy":"internal_tags","embeddable":true,"href":"https:\/\/optinmonster.com\/wp-json\/wp\/v2\/documentation\/tags?post=97394"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}