Introduction
The Gravity Forms Webhooks Add-On enables you to make remote HTTP requests to external services when a form is submitted.
By utilizing webhooks, you can pass form data on to 3rd party services even when there is not an official add-on available for it.
If you would like an alternative with a little less webhook work, check out our Zapier Add-On, which allows you to utilize the thousands of integration Zapier can connect to.
Configuring Webhooks
Ensure you have installed and activated the Webhooks Add-On.
You configure the webhooks for a form using a feed. Go to Form Settings → Webhooks tab, and then click the Add New button to create a new feed that will send data to your service of choice, using a webhooks.
Next, configure the request that is being made. This will vary based on the service that you’re making the request to. If you’re unsure of what settings to select here, you may want to contact the service that you’re trying to connect to.
Settings
| Setting | Description |
|---|---|
| Name | Enter a name for your feed. This is never displayed and is only used for identification purposes. You can name this anything you want. |
| Request URL | Enter the URL this request should be sent to. This setting also supports Merge Tags. You can use the {admin_ajax_url} and {rest_api_url} merge tags when you will be performing local requests. |
| Request Method | Select the HTTP method which is to be used when performing a request. The supported methods are GET, POST, PUT, PATCH, and DELETE. |
| Request Format | Select the format for the webhook request. The supported formats are FORM and JSON. |
| Request Headers | Here you can configure one or more HTTP headers to be sent with the request. See note 1. |
| Request Body | Here is where you will define what data is sent with the request. You can select from the following options: All Fields: This will send the entire unformatted entry. Select Fields: This will display the Fields Values setting. |
| Field Values | Only displayed when Request Body is set to Select Fields. This dynamic setting allows you to define the keys and values to be sent in the request body. See Note 2. |
| Webhook Condition | Like other add-ons, conditional logic can be applied. To use conditional logic, select the Enable Condition checkbox and then configure the rules which should be met for this request to be sent. |
Notes
- The Content-Type header is automatically set to application/json during feed processing when the Request Format is set to JSON and the Request Method is set to POST or PUT.
- For the values, you can select from the form fields, entry meta, or Add Custom Value which will display a text input that supports Merge Tags.