Troubleshoot webhooks in Zapier

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.

 

How do I fix Error -2. ?

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!

 

Can I set up redirects?

Zapier cannot set up 301 or 302 redirects to a different URL and deliver/retrieve payloads from the new address. Doing so will result in a failure.

 

How do I fix the error: "413 Request Entity Too Large"?

The maximum webhook size we currently support is 10 MB for triggers and 5MB for actions. 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 awww.example.comandexample.comcertificate on a domain liketesting.example.com. The reverse can be the case as well, for example: a*.example.comwildcard certificate forexample.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 Zapier can interpret in subsequent steps.

If you're familiar with Python or Javascript, a potential workaround is to do this with a Code step. Keep in mind that the Code app is an advanced feature, and the Zapier support team can't help to 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 step

Zapier needs to have received a payload of data to that webhook URL before testing 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.

 

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

This means that Zapier 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 Zapier's 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.

 

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

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 fix this, do not set a customContent-Typeheader in the request.

 

My Zap triggered multiple times and I see many entries in Zap 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 Zapier's Developer Platform which will give you full control over the data received from webhook requests and how it is handled in your Zaps.

If you need further assistance with your webhooks, contact Zapier support.

 

My Zap isn't triggering

If the Zap receives an invalid payload, it may be ignored and the Zap may fail to trigger. Zapier can accept payloads that are valid XML, JSON, or URL-Encoded format only. If you have a payload that didn't trigger the Zap, make sure to check if it is valid. The Zap will still respond with a Success status.

 

I'm not receiving webhooks data when I click Test trigger

Webhooks triggers will display the three most recent webhooks sent to the URL. If you're having trouble finding any samples, send new test data to your webhook URL and then click Test trigger.