How to use webhook to send form & promo results to any third-party system, instantly
Feversocial’s Form System includes built-in Webhook notifications. Register a Webhook URL in your dashboard, and every time someone submits a new form, Feversocial automatically notifies that URL and sends the submission data along with it.
What is a webhook?
Have you ever given your email address to a service so it could notify you whenever there was news? A webhook works on a similar idea to an email subscription — it’s a subscription mechanism between two systems. The difference is that instead of an email address, the two systems communicate through a URL, and that URL is called the webhook URL.
In short, think of a webhook as a web notification technology, or simply a web address. Two different systems can exchange data with each other through this agreed-upon address.
Feversocial’s forms and promos support the same notification feature. Register a Webhook URL in your dashboard, and Feversocial will notify that URL whenever a form receives a new submission or someone completes a promo — sending the form or promo data straight to that address. (See the data format below.)
Plenty of database and marketing systems accept webhook data out of the box — Google Sheets, CRM (Customer Relationship Management) and CDP (Customer Data Platform) tools, chatbots, email platforms, and integration platforms like Zapier and Make.
You can also have your IT team log form submissions directly into your company’s database in real time.
Feversocial form webhook format
Outer fields (header)
| Header/Key | Data Type | Description |
|---|---|---|
| X-Fever-Signature | string | Digital signature from Feversocial, generated with HMAC-SHA256 |
| webhook_id | string | Unique webhook ID |
| event_type | string | Webhook event type |
| version | string | Webhook API version number |
| payload | object | The main data payload |
Payload field reference
| Key | Data Type | Description |
|---|---|---|
| form_id | number | Unique form ID |
| title | string | Form Title |
| serial_number | number | Promo participant sequence number |
| uid | string | Feversocial’s internal unique identifier |
| login_id | string | User ID (Facebook, LINE, or member ID) |
| submitted_at | number | UNIX timestamp |
| fields | array | Form field data |
| fields[].id | number | Unique field ID |
| fields[].name | string | Field display name |
| fields[].value | string, bool | Value submitted by the respondent |
| fields[].ref | string | Key-Value settings for data mapping |
| fields[].is_multiple_choice | bool | Whether this is a multiple-choice field |
| tracking | object | Tracking code — automatically saved if the form’s URL contains UTM parameters |
| tracking.ga_client_id | string | |
| tracking.utm_campaign | string | |
| tracking.utm_source | string | |
| tracking.utm_medium | string | |
| tracking.utm_term | string | |
| tracking.utm_content | string |
