{"id":15134,"date":"2026-01-21T12:44:41","date_gmt":"2026-01-21T09:44:41","guid":{"rendered":"https:\/\/snov.io\/knowledgebase\/?p=15134"},"modified":"2026-02-01T15:47:52","modified_gmt":"2026-02-01T12:47:52","slug":"how-to-use-snov-io-webhooks","status":"publish","type":"post","link":"https:\/\/snov.io\/knowledgebase\/how-to-use-snov-io-webhooks\/","title":{"rendered":"How to set up webhooks via Snov.io API"},"content":{"rendered":"

In this article, you\u2019ll learn how to set up and manage webhooks via the Snov.io API for your custom integrations.<\/p>\n

What is a webhook<\/strong><\/h2>\n

Webhooks allow you to get notified of events that happen in your campaigns, like prospect replies or campaign completion.<\/p>\n

When the event you subscribed to occurs, Snov.io sends data related to that event to your endpoint (webhook URL) in real-time. You can use this data for integrations or automations via apps like Zapier or Make.<\/p>\n

\n
\"note\"<\/div>\n
Webhooks require a paid Snov.io plan (premium). You can create up to 50 webhooks.<\/div>\n<\/div>\n

How to create webhooks<\/strong><\/h2>\n
\n

To subscribe to webhooks, choose the event you want to track, prepare your endpoint URL and send a request to Snovio API.<\/p>\n<\/div>\n

Choose the event<\/strong><\/h3>\n

Decide the event you want to track from the supported events list.<\/p>\n

When the selected event occurs, Snov.io will automatically send event data to your endpoint.<\/p>\n

Currently supported webhook events are listed below. For example, you can receive webhook data when a prospect replies to a campaign email, an email bounces, or a prospect completes a campaign.<\/p>\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
Webhook object (event_object)<\/em><\/th>\nAction (event_action)<\/em><\/th>\nWhen activates<\/th>\n<\/tr>\n<\/thead>\n
campaign_email<\/td>\nsent<\/td>\nWhen any email is sent to a recipient in any campaign<\/td>\n<\/tr>\n
campaign_email<\/td>\nfirst_sent<\/td>\nWhen the first email is sent to a recipient in any campaign<\/td>\n<\/tr>\n
campaign_email<\/td>\nopened<\/td>\nWhen a recipient opens any email from a campaign<\/td>\n<\/tr>\n
campaign_email<\/td>\nbounced<\/td>\nWhen an email sent from a campaign cannot be delivered and results in a bounce<\/td>\n<\/tr>\n
campaign_reply<\/td>\nreceived<\/td>\nWhen a recipient replies to any email in any campaign<\/td>\n<\/tr>\n
campaign_reply<\/td>\nfirst_received<\/td>\nWhen a recipient replies to a campaign email for the first time<\/td>\n<\/tr>\n
prospect<\/td>\ncampaign_finished<\/td>\nWhen a prospect reaches the end of a campaign and no further steps are scheduled<\/td>\n<\/tr>\n
company<\/td>\nfound_domains_by_names<\/td>\nWhen a company domain is found based on its name<\/td>\n<\/tr>\n
prospect<\/td>\nfound_by_li_url<\/td>\nWhen a prospect profile is found based on a LinkedIn URL<\/td>\n<\/tr>\n
email_verification<\/td>\nverified<\/td>\nWhen an email verification request is completed<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
\n
\n

Prepare your endpoint URL<\/strong><\/h3>\n

This is your own public URL that can accept inbound HTTP requests. For example, a webhook URL in Zapier\/Make, or your app endpoint.<\/p>\n

Send the request to create the webhook<\/strong><\/h3>\n

To create a webhook in your Snov.io account, use the Add webhook<\/a> endpoint from the Snovio API.<\/p>\n

\n
\"learn\"<\/div>\n
You can subscribe to and manage webhooks through a set of API calls. Refer to API documentation<\/a> for full details.<\/div>\n<\/div>\n

Send an API request with the following parameters. The webhook parameters are predefined based on the type of event you want to track.<\/p>\n

    \n
  • Method:<\/strong> POST<\/li>\n
  • Request URL: <\/strong>https:\/\/api.snov.io\/v2\/webhooks<\/li>\n<\/ul>\n

    Webhook parameters<\/strong><\/h3>\n
      \n
    • \n

      event_object<\/strong> \u2014 what you want to track, like prospect or email (copy the corresponding values from the table above)<\/p>\n<\/li>\n

    • \n

      event_action<\/strong> \u2014 the specific event that needs to happen so webhook activates (copy the corresponding values from the table above)<\/p>\n<\/li>\n

    • \n

      endpoint_url<\/strong> \u2014 provide your own public URL where Snov.io will send data<\/p>\n<\/li>\n<\/ul>\n

      To create a webhook for prospect replies (when a recipient replies to any email in any campaign), choose these parameters.<\/p>\n

        \n
      • event_object:<\/em> campaign_reply<\/li>\n
      • event_action:<\/em> received<\/li>\n<\/ul>\n
        \n
        \n

        Example API request body:<\/strong><\/p>\n

        { \"event_object\": \"campaign_reply\", \"event_action\": \"received\", \"endpoint_url\": \"https:\/\/your-domain.com\/webhooks\/snov-replies\" }<\/em><\/p>\n<\/div>\n<\/div>\n

        Verify the webhook is working<\/strong><\/h3>\n

        After you create the webhook:<\/p>\n

          \n
        • \n

          Make sure your endpoint returns an HTTP status 200\u2013299<\/strong> within 3 seconds<\/strong><\/p>\n<\/li>\n

        • \n

          If the endpoint returns a different status (or times out), Snov.io retries to send the webhook automatically<\/p>\n<\/li>\n<\/ul>\n<\/div>\n<\/div>\n

          \n
          \"learn\"<\/div>\n
          \n

          Retry policy: <\/strong>The behavior below reflects how Snov.io delivers webhook events in practice.<\/p>\n

           <\/p>\n

          The webhook is considered successful if Snov.io receives an HTTP status in the 200\u2013299 range within 3 seconds.<\/p>\n

          If we get any other HTTP status or a timeout occurs, we make seven retry attempts with increasing intervals up to 38 hours after the event which triggered a webhook:<\/p>\n

          If all retries are unsuccessful, the webhook becomes deactivated.<\/p>\n

            \n
          • 1st: immediately after the event<\/li>\n
          • 2nd: 20 minutes after the last attempt (20 minutes after the event)<\/li>\n
          • 3rd: 40 minutes after the last attempt (1 hour after the event)<\/li>\n
          • 4th: 60 minutes after the last attempt (2 hours after the event)<\/li>\n
          • 5th: 4 hours after the last attempt (6 hours after the event)<\/li>\n
          • 6th: 8 hours after the last attempt (14 hours after the event)<\/li>\n
          • 7th: 24 hours after the last attempt (38 hours after the event)<\/li>\n<\/ul>\n<\/div>\n<\/div>\n","protected":false},"excerpt":{"rendered":"

            In this article, you\u2019ll learn how to set up and manage webhooks via the Snov.io API for your custom integrations. What is a webhook Webhooks allow you to get notified of events that happen in your campaigns, like prospect replies or campaign completion. When the event you subscribed to occurs, Snov.io sends data related to […]<\/p>\n","protected":false},"author":16,"featured_media":0,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[1986],"tags":[],"_links":{"self":[{"href":"https:\/\/snov.io\/knowledgebase\/wp-json\/wp\/v2\/posts\/15134"}],"collection":[{"href":"https:\/\/snov.io\/knowledgebase\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/snov.io\/knowledgebase\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/snov.io\/knowledgebase\/wp-json\/wp\/v2\/users\/16"}],"replies":[{"embeddable":true,"href":"https:\/\/snov.io\/knowledgebase\/wp-json\/wp\/v2\/comments?post=15134"}],"version-history":[{"count":35,"href":"https:\/\/snov.io\/knowledgebase\/wp-json\/wp\/v2\/posts\/15134\/revisions"}],"predecessor-version":[{"id":44491,"href":"https:\/\/snov.io\/knowledgebase\/wp-json\/wp\/v2\/posts\/15134\/revisions\/44491"}],"wp:attachment":[{"href":"https:\/\/snov.io\/knowledgebase\/wp-json\/wp\/v2\/media?parent=15134"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/snov.io\/knowledgebase\/wp-json\/wp\/v2\/categories?post=15134"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/snov.io\/knowledgebase\/wp-json\/wp\/v2\/tags?post=15134"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}