Webhook Error: “POST to webhook target URL failed”

January 23, 2021 Contributors

When you create a new webhook in the SparkPost UI, you may see an error similar to the following:

This error occurs when SparkPost sends a test batch to your webhook endpoint and, if an error is detected during that test, this error is shown.  There are a few common steps you can take to rectify the issue:

  • Webhooks require you to publish an HTTP service (the "target URL" above) to receive event data.  Your service must be in place before you register the webhook with SparkPost.
  • Your receiving HTTP service must return a 200 status code when it successfully receives an event batch.  Any non 200 response is treated as an error.

For more details on managing your webhooks and handling webhook event data, check out this support article and this blog post on the topic.