{"id":11587,"date":"2017-08-07T15:25:43","date_gmt":"2017-08-07T19:25:43","guid":{"rendered":"https:\/\/docs.gravityforms.com\/?post_type=gdoc&p=11587"},"modified":"2025-11-11T09:35:07","modified_gmt":"2025-11-11T14:35:07","slug":"triggering-webhooks-form-submissions","status":"publish","type":"post","link":"https:\/\/docs.gravityforms.com\/triggering-webhooks-form-submissions\/","title":{"rendered":"Triggering Webhooks on Form Submissions"},"content":{"rendered":"\n

Introduction<\/h2>\n\n\n\n

The Gravity Forms Webhooks Add-On enables you to make remote HTTP requests to external services when a form is submitted.<\/p>\n\n\n\n

By utilizing webhooks<\/a>, you can pass form data on to 3rd party services eve<\/span>n when there is no official add-on available for it.<\/p>\n\n\n\n

If you would like an alternative with less<\/span> webhook work, check out our Zapier Add-On<\/a>. It allows you to utilize the thousands of integrations Zapier can connect to.<\/p>\n\n\n\n

Configuring Webhooks<\/h2>\n\n\n\n

Ensure you have installed and activated<\/a> the Webhooks Add-On.<\/p>\n\n\n\n

\"Webhooks<\/a><\/figure>\n\n\n\n

You configure the webhooks for a form using a feed. Go to Form Settings \u2192 Webhooks<\/strong>, then select Add New<\/strong> to create a feed that will send data to your service of choice, using a webhook.

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.<\/p>\n\n\n\n

Settings<\/h2>\n\n\n\n
Setting<\/th>Description<\/th><\/tr><\/thead>
Name<\/strong><\/td>Enter a name for your feed. This is never displayed and is only used for identification purposes. You can name this anything you want.<\/td><\/tr>
Request URL<\/strong><\/td>Enter the URL this request should be sent to. This setting also supports Merge Tags<\/a>. You can use the {admin_ajax_url}<\/a> and {rest_api_url}<\/a> merge tags when you are performing local requests. See note 1.<\/strong><\/td><\/tr>
Request Method<\/strong><\/td>Select the HTTP method to use when performing a request. The supported methods are GET<\/strong>, POST<\/strong>, PUT<\/strong>, PATCH<\/strong>, and DELETE<\/strong>.<\/td><\/tr>
Request Format<\/strong><\/td>Select the format for the webhook request. The supported formats are FORM<\/strong> and JSON<\/strong>.<\/td><\/tr>
Request Headers<\/strong><\/td>Here you can configure one or more HTTP headers to be sent with the request. See note<\/strong> 2.<\/strong><\/td><\/tr>
Request Body<\/strong><\/td>Here is where you will define what data is sent with the request. You can select from the following options:
All Fields<\/strong>: This will send the entire unformatted entry.
Select Fields<\/strong>: This will display the Fields Values<\/strong> setting.<\/td><\/tr>
Field Values<\/strong><\/td>Setup the fields to be sent in the webhook request. This setting also supports Merge Tags<\/a>. See note 2.<\/strong><\/td><\/tr>
Webhook Condition<\/strong><\/td>When conditions are enabled, the Webhook will only be executed when the conditions are met. When disabled, the Webhook will be executed for every form submission.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

Notes<\/h2>\n\n\n\n
    \n
  1. To ensure security, the Request URL must pass WordPress core validation checks. You can find examples of valid and invalid URLs in the official WordPress documentation: https:\/\/developer.wordpress.org\/reference\/functions\/wp_http_validate_url\/<\/a><\/li>\n\n\n\n
  2. The Content-Type<\/strong> header is automatically set to application\/json<\/strong> during feed processing when the Request Format<\/strong> is set to JSON<\/strong> and the Request Method<\/strong> is set to POST<\/strong> or PUT<\/strong>.<\/li>\n\n\n\n
  3. For the values, you can select from the form fields, entry meta, or Add Custom Value,<\/strong> which will display a text input that supports Merge Tags<\/a>.<\/li>\n<\/ol>\n\n\n\n

    Note:<\/strong> Feed processing will be aborted if the URL uses a custom port or redirects to another URL that fails validation.<\/p>\n","protected":false},"excerpt":{"rendered":"

    By using the Gravity Forms Webhooks Add-On, you will be able to make remote HTTP requests to external services when a form is submitted.<\/p>\n","protected":false},"author":16,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"_autodraft_ids":[],"jetpack_post_was_ever_published":false,"_sb_is_suggestion_mode":false,"_sb_show_suggestion_boards":false,"_sb_show_comment_boards":false,"_sb_suggestion_history":"","_sb_update_block_changes":"","_is_real_time_mode":false,"_realtime_collaborators":"","footnotes":"","cf_checklist_status":["SEO Title Length","Content Word Count","Internal Links","External Links","Alt Text for All Images","Category Assigned"]},"categories":[354],"tags":[],"class_list":["post-11587","post","type-post","status-publish","format-standard","hentry","category-webhooks-add-on","wpautop"],"acf":[],"yoast_head":"\nTriggering Webhooks on Form Submissions - Gravity Forms<\/title>\n<meta name=\"description\" content=\"By using the Gravity Forms Webhooks Add-On, you will be able to make remote HTTP requests to external services when a form is submitted.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/docs.gravityforms.com\/triggering-webhooks-form-submissions\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Triggering Webhooks on Form Submissions\" \/>\n<meta property=\"og:description\" content=\"By using the Gravity Forms Webhooks Add-On, you will be able to make remote HTTP requests to external services when a form is submitted.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/docs.gravityforms.com\/triggering-webhooks-form-submissions\/\" \/>\n<meta property=\"og:site_name\" content=\"Gravity Forms Documentation\" \/>\n<meta property=\"article:published_time\" content=\"2017-08-07T19:25:43+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2025-11-11T14:35:07+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/docs.gravityforms.com\/wp-content\/uploads\/2021\/07\/image-20.png\" \/>\n\t<meta property=\"og:image:width\" content=\"785\" \/>\n\t<meta property=\"og:image:height\" content=\"857\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/png\" \/>\n<meta name=\"author\" content=\"Justin Pakes\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:creator\" content=\"@gravityforms\" \/>\n<meta name=\"twitter:site\" content=\"@gravityforms\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"Justin Pakes\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"3 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\\\/\\\/docs.gravityforms.com\\\/triggering-webhooks-form-submissions\\\/#article\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/docs.gravityforms.com\\\/triggering-webhooks-form-submissions\\\/\"},\"author\":{\"name\":\"Justin Pakes\",\"@id\":\"https:\\\/\\\/docs.gravityforms.com\\\/#\\\/schema\\\/person\\\/8a88745ec2ee5bc1bb24eea8634bf376\"},\"headline\":\"Triggering Webhooks on Form Submissions\",\"datePublished\":\"2017-08-07T19:25:43+00:00\",\"dateModified\":\"2025-11-11T14:35:07+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\\\/\\\/docs.gravityforms.com\\\/triggering-webhooks-form-submissions\\\/\"},\"wordCount\":497,\"publisher\":{\"@id\":\"https:\\\/\\\/docs.gravityforms.com\\\/#organization\"},\"image\":{\"@id\":\"https:\\\/\\\/docs.gravityforms.com\\\/triggering-webhooks-form-submissions\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/docs.gravityforms.com\\\/wp-content\\\/uploads\\\/2021\\\/07\\\/image-20.png\",\"articleSection\":[\"Webhooks Add-On\"],\"inLanguage\":\"en-US\"},{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/docs.gravityforms.com\\\/triggering-webhooks-form-submissions\\\/\",\"url\":\"https:\\\/\\\/docs.gravityforms.com\\\/triggering-webhooks-form-submissions\\\/\",\"name\":\"Triggering Webhooks on Form Submissions - Gravity Forms\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/docs.gravityforms.com\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/docs.gravityforms.com\\\/triggering-webhooks-form-submissions\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/docs.gravityforms.com\\\/triggering-webhooks-form-submissions\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/docs.gravityforms.com\\\/wp-content\\\/uploads\\\/2021\\\/07\\\/image-20.png\",\"datePublished\":\"2017-08-07T19:25:43+00:00\",\"dateModified\":\"2025-11-11T14:35:07+00:00\",\"description\":\"By using the Gravity Forms Webhooks Add-On, you will be able to make remote HTTP requests to external services when a form is submitted.\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/docs.gravityforms.com\\\/triggering-webhooks-form-submissions\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/docs.gravityforms.com\\\/triggering-webhooks-form-submissions\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/docs.gravityforms.com\\\/triggering-webhooks-form-submissions\\\/#primaryimage\",\"url\":\"https:\\\/\\\/docs.gravityforms.com\\\/wp-content\\\/uploads\\\/2021\\\/07\\\/image-20.png\",\"contentUrl\":\"https:\\\/\\\/docs.gravityforms.com\\\/wp-content\\\/uploads\\\/2021\\\/07\\\/image-20.png\",\"width\":785,\"height\":857,\"caption\":\"Webhooks Feed Settings\"},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/docs.gravityforms.com\\\/triggering-webhooks-form-submissions\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/docs.gravityforms.com\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Triggering Webhooks on Form Submissions\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/docs.gravityforms.com\\\/#website\",\"url\":\"https:\\\/\\\/docs.gravityforms.com\\\/\",\"name\":\"Gravity Forms Documentation\",\"description\":\"\",\"publisher\":{\"@id\":\"https:\\\/\\\/docs.gravityforms.com\\\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/docs.gravityforms.com\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\\\/\\\/docs.gravityforms.com\\\/#organization\",\"name\":\"Gravity Forms\",\"url\":\"https:\\\/\\\/docs.gravityforms.com\\\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/docs.gravityforms.com\\\/#\\\/schema\\\/logo\\\/image\\\/\",\"url\":\"https:\\\/\\\/docs.gravityforms.com\\\/wp-content\\\/uploads\\\/2020\\\/01\\\/gravity-forms-2020-logo-stacked.png\",\"contentUrl\":\"https:\\\/\\\/docs.gravityforms.com\\\/wp-content\\\/uploads\\\/2020\\\/01\\\/gravity-forms-2020-logo-stacked.png\",\"width\":392,\"height\":515,\"caption\":\"Gravity Forms\"},\"image\":{\"@id\":\"https:\\\/\\\/docs.gravityforms.com\\\/#\\\/schema\\\/logo\\\/image\\\/\"},\"sameAs\":[\"https:\\\/\\\/x.com\\\/gravityforms\",\"http:\\\/\\\/@gravityforms.com\"]},{\"@type\":\"Person\",\"@id\":\"https:\\\/\\\/docs.gravityforms.com\\\/#\\\/schema\\\/person\\\/8a88745ec2ee5bc1bb24eea8634bf376\",\"name\":\"Justin Pakes\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/791cb5bec00c6dd4bec2e80cf4df9638297207d8f77890c96b6b483be434ecea?s=96&d=mm&r=g\",\"url\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/791cb5bec00c6dd4bec2e80cf4df9638297207d8f77890c96b6b483be434ecea?s=96&d=mm&r=g\",\"contentUrl\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/791cb5bec00c6dd4bec2e80cf4df9638297207d8f77890c96b6b483be434ecea?s=96&d=mm&r=g\",\"caption\":\"Justin Pakes\"},\"url\":\"https:\\\/\\\/docs.gravityforms.com\\\/author\\\/pakes\\\/\"}]}<\/script>\n<!-- \/ Yoast SEO Premium plugin. -->","yoast_head_json":{"title":"Triggering Webhooks on Form Submissions - Gravity Forms","description":"By using the Gravity Forms Webhooks Add-On, you will be able to make remote HTTP requests to external services when a form is submitted.","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/docs.gravityforms.com\/triggering-webhooks-form-submissions\/","og_locale":"en_US","og_type":"article","og_title":"Triggering Webhooks on Form Submissions","og_description":"By using the Gravity Forms Webhooks Add-On, you will be able to make remote HTTP requests to external services when a form is submitted.","og_url":"https:\/\/docs.gravityforms.com\/triggering-webhooks-form-submissions\/","og_site_name":"Gravity Forms Documentation","article_published_time":"2017-08-07T19:25:43+00:00","article_modified_time":"2025-11-11T14:35:07+00:00","og_image":[{"width":785,"height":857,"url":"https:\/\/docs.gravityforms.com\/wp-content\/uploads\/2021\/07\/image-20.png","type":"image\/png"}],"author":"Justin Pakes","twitter_card":"summary_large_image","twitter_creator":"@gravityforms","twitter_site":"@gravityforms","twitter_misc":{"Written by":"Justin Pakes","Est. reading time":"3 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/docs.gravityforms.com\/triggering-webhooks-form-submissions\/#article","isPartOf":{"@id":"https:\/\/docs.gravityforms.com\/triggering-webhooks-form-submissions\/"},"author":{"name":"Justin Pakes","@id":"https:\/\/docs.gravityforms.com\/#\/schema\/person\/8a88745ec2ee5bc1bb24eea8634bf376"},"headline":"Triggering Webhooks on Form Submissions","datePublished":"2017-08-07T19:25:43+00:00","dateModified":"2025-11-11T14:35:07+00:00","mainEntityOfPage":{"@id":"https:\/\/docs.gravityforms.com\/triggering-webhooks-form-submissions\/"},"wordCount":497,"publisher":{"@id":"https:\/\/docs.gravityforms.com\/#organization"},"image":{"@id":"https:\/\/docs.gravityforms.com\/triggering-webhooks-form-submissions\/#primaryimage"},"thumbnailUrl":"https:\/\/docs.gravityforms.com\/wp-content\/uploads\/2021\/07\/image-20.png","articleSection":["Webhooks Add-On"],"inLanguage":"en-US"},{"@type":"WebPage","@id":"https:\/\/docs.gravityforms.com\/triggering-webhooks-form-submissions\/","url":"https:\/\/docs.gravityforms.com\/triggering-webhooks-form-submissions\/","name":"Triggering Webhooks on Form Submissions - Gravity Forms","isPartOf":{"@id":"https:\/\/docs.gravityforms.com\/#website"},"primaryImageOfPage":{"@id":"https:\/\/docs.gravityforms.com\/triggering-webhooks-form-submissions\/#primaryimage"},"image":{"@id":"https:\/\/docs.gravityforms.com\/triggering-webhooks-form-submissions\/#primaryimage"},"thumbnailUrl":"https:\/\/docs.gravityforms.com\/wp-content\/uploads\/2021\/07\/image-20.png","datePublished":"2017-08-07T19:25:43+00:00","dateModified":"2025-11-11T14:35:07+00:00","description":"By using the Gravity Forms Webhooks Add-On, you will be able to make remote HTTP requests to external services when a form is submitted.","breadcrumb":{"@id":"https:\/\/docs.gravityforms.com\/triggering-webhooks-form-submissions\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/docs.gravityforms.com\/triggering-webhooks-form-submissions\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/docs.gravityforms.com\/triggering-webhooks-form-submissions\/#primaryimage","url":"https:\/\/docs.gravityforms.com\/wp-content\/uploads\/2021\/07\/image-20.png","contentUrl":"https:\/\/docs.gravityforms.com\/wp-content\/uploads\/2021\/07\/image-20.png","width":785,"height":857,"caption":"Webhooks Feed Settings"},{"@type":"BreadcrumbList","@id":"https:\/\/docs.gravityforms.com\/triggering-webhooks-form-submissions\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/docs.gravityforms.com\/"},{"@type":"ListItem","position":2,"name":"Triggering Webhooks on Form Submissions"}]},{"@type":"WebSite","@id":"https:\/\/docs.gravityforms.com\/#website","url":"https:\/\/docs.gravityforms.com\/","name":"Gravity Forms Documentation","description":"","publisher":{"@id":"https:\/\/docs.gravityforms.com\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/docs.gravityforms.com\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/docs.gravityforms.com\/#organization","name":"Gravity Forms","url":"https:\/\/docs.gravityforms.com\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/docs.gravityforms.com\/#\/schema\/logo\/image\/","url":"https:\/\/docs.gravityforms.com\/wp-content\/uploads\/2020\/01\/gravity-forms-2020-logo-stacked.png","contentUrl":"https:\/\/docs.gravityforms.com\/wp-content\/uploads\/2020\/01\/gravity-forms-2020-logo-stacked.png","width":392,"height":515,"caption":"Gravity Forms"},"image":{"@id":"https:\/\/docs.gravityforms.com\/#\/schema\/logo\/image\/"},"sameAs":["https:\/\/x.com\/gravityforms","http:\/\/@gravityforms.com"]},{"@type":"Person","@id":"https:\/\/docs.gravityforms.com\/#\/schema\/person\/8a88745ec2ee5bc1bb24eea8634bf376","name":"Justin Pakes","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/secure.gravatar.com\/avatar\/791cb5bec00c6dd4bec2e80cf4df9638297207d8f77890c96b6b483be434ecea?s=96&d=mm&r=g","url":"https:\/\/secure.gravatar.com\/avatar\/791cb5bec00c6dd4bec2e80cf4df9638297207d8f77890c96b6b483be434ecea?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/791cb5bec00c6dd4bec2e80cf4df9638297207d8f77890c96b6b483be434ecea?s=96&d=mm&r=g","caption":"Justin Pakes"},"url":"https:\/\/docs.gravityforms.com\/author\/pakes\/"}]}},"jetpack_featured_media_url":"","jetpack_shortlink":"https:\/\/wp.me\/pdGaEa-30T","_links":{"self":[{"href":"https:\/\/docs.gravityforms.com\/wp-json\/wp\/v2\/posts\/11587","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/docs.gravityforms.com\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/docs.gravityforms.com\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/docs.gravityforms.com\/wp-json\/wp\/v2\/users\/16"}],"replies":[{"embeddable":true,"href":"https:\/\/docs.gravityforms.com\/wp-json\/wp\/v2\/comments?post=11587"}],"version-history":[{"count":7,"href":"https:\/\/docs.gravityforms.com\/wp-json\/wp\/v2\/posts\/11587\/revisions"}],"predecessor-version":[{"id":46882,"href":"https:\/\/docs.gravityforms.com\/wp-json\/wp\/v2\/posts\/11587\/revisions\/46882"}],"wp:attachment":[{"href":"https:\/\/docs.gravityforms.com\/wp-json\/wp\/v2\/media?parent=11587"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/docs.gravityforms.com\/wp-json\/wp\/v2\/categories?post=11587"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/docs.gravityforms.com\/wp-json\/wp\/v2\/tags?post=11587"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}