Help

Troubleshoot webhooks in Zapier

tutorial
Last updated:

I need to send a nested JSON array in the request data.

To send a nested JSON array, use the Custom Request action. That will allow more flexibility for the payload.

I Got an Error -2. How Do I Fix This?

This error means the domain lookup for your URL failed. If the URL seems okay, check for extra spaces before or after the URL in your webhook settings. Remove the space and you should be good to go!

Why Is It Always 200 or Success Status? Can I customize the response?

For High Availability and High Throughput reasons - we always return a success message with a payload of debugging information when collecting a webhook - regardless of whether there is a Zap behind the webhook or if it is paused or not. The only way to know if a URL is live is to visit the editor and look at the URL (which never changes for a Zap). There is no way to customize the response to the request you send to the Catch Hook URL, as the response is sent before the Zap triggers and runs on the webhook request.

Can I do redirects?

We cannot 301 or 302 you to a different URL and deliver/retrieve payloads from the new address. Doing so will result in a failure!

Why Do I Receive A "413 Request Entity Too Large" Error Status?

The maximum webhook size we currently support is 10MB. Any payloads that exceed this limit with receive a 413 status code.

Why do I get a "Connection Failure"?

This is very common if you have a firewall in place to limit access to your local intranet or company network. Open up your instance to the wider internet to give Zapier and similar services access to your server. Be sure to use good passwords if you can!

How do I fix a SSL Certificate Failure?

Chances are there are a few reasons why you might be running into an SSL certificate failure:

  1. Using a self-signed certificate. We currently only support SSL certificates issued by public certificate authorities. A free SSL certificate can be obtained from letsencrypt.org. Let’s Encrypt is a free, automated, and open certificate authority provided by the non-profit Internet Security Research Group (ISRG).
  2. Incorrect usage of a www.example.com and example.com certificate on a domain like testing.example.com. The reverse can be the case as well, for example: a *.example.com wildcard certificate for example.com.
  3. Other improper installation of the certificate (missing chain certificates, improper modes, etc). Use a tool like https://www.ssllabs.com/ssltest/ to test.

Webhook Not Returning Results for next Steps

Unfortunately, not all apps can send back data in a way that our system can interpret in subsequent steps.

If you're familiar with Python or Javascript, a potential workaround is to do this with a Code step. Please note that the Code app is an advanced feature and we aren't able to help troubleshoot the code if there are errors.

Posting JSON from Web Browser + Access-Control-Allow-Headers in Preflight Response Error

Specifically, the error:

Request header field Content-Type is not allowed by Access-Control-Allow-Headers in preflight response.

This happens when trying to send data to the Zapier webhooks from inside a web browser and altering the Content-Type header during the process. Because of Cross Browser Security restrictions, your browser will reject these requests. To combat this, do not set a custom Content-Type header in the request.

Nothing Found on Trigger Test Stage

We need to have received a payload of data to that webhook URL before testing for us to be able to find that data.

The request cannot be completely blank, so be sure to add something in the payload (or the url parameters if it's a GET request) so the Zap can trigger.

If you are still having some trouble, drop us an email and let us know as much as possible about your planned workflow for this Zap so we can help!

Error: "Bargle. We hit an error creating a post. :-( Error: -11"

This means we can't get a reliable IP for the domain. Even though you may be able to access the URL via the browser or an API client, it may still fail our requirements. When it does, this often means there are issues with the DNS configuration for the domain. You can run it through http://dnscheck.pingdom.com/ to find them.

My Zap triggered multiple times and I see many entries in Task History with the same time-stamp

If the webhook response data is an array of objects, that will run the subsequent steps in your Zap multiple times — once for each object in the array. If this isn't what you're looking to do, you'll need to check the documentation for the API you're connecting to and see if there's a way to limit the number of objects returned in the response to just one (e.g. a limit parameter). If that isn't possible, take a look at building a custom integration using our Developer Platform which will give you full control over the data received from webhook requests and how it is handled in your Zaps.


Need More Help?

Zapier Community

Connect with other Zapier users and industry professionals to get help crafting the perfect workflow.
Check out the community

Hire an Expert

We have a directory of professionals across the globe who are ready to help.
Find a Zapier Expert

Zapier Support

Contact our world class support team and we’ll be happy to help you get up and running!
Contact Us