Webhooks
Deformity's webhook integration allows you to instantly send data to other apps or websites when a Deformity form is submitted.
This real-time update system lets you create automatic workflows, so you can quickly act on new form responses.
Webhooks are great for posting notifications to Slack channels, appending rows in Airtable, creating leads in your CRM, triggering follow-up emails, or updating tasks in your project management tool. And best of all, it’s free!
How it works
Deformity webhooks send data to a service of your choosing automatically each time a form is completed. Here's how it works:
- A user completes a Deformity form
- Deformity immediately sends the response data to a URL you choose via a POST request
This lets you receive and process new responses in other tools or applications.
Add a webhook
Here are the steps to set up a webhook:
- Make sure your form is published
- Navigate to your Deformity > Settings > Integrations > Webhook
- Click connect to Webhooks
- Add your endpoint URL and save webhook
That's it! The next time you submit a published form (not in Preview in the builder) it will send the response data to the specified URL.Setting Up Your Webhook Endpoint
Your endpoint URL should be an HTTP or HTTPS address capable of:
- Accepting POST requests
- Processing JSON payloads
- Responding with a 2XX status code
- Completing all operations within 10 seconds
Ensure your endpoint meets these criteria for seamless webhook integration.
Testing Your Webhook
To easily test your webhook, go to webhook.site and copy your unique test URL.
Paste that URL into the Webhook endpoint field in your form’s integrations settings, then submit a test form response. In the webhook.site dashboard, you’ll see the JSON payload delivered in real time, allowing you to verify that all values are passed correctly.
Example Webhook Payload
{
"id": "LkHb6c6KqdjH",
"name": "Elon",
"email": "elon@tesla.com",
"submittedAt": "2025-05-14T17:03:07.038Z",
"completionPercentage": 100,
"completed": true,
"allAnswers": "File:
https://deformity.ai/api/files/private/IMG.jpeg?id=[ID]&expires=[EXPIRATION]&signature=[SIGNATURE]
Name:
Cameron
Email:
elon@tesla.com
Ranking:
[Ranked] Deformity, Typeform, Google Forms
Website:
https://tesla.com
Signature:
https://deformity.ai/api/files/private/signature.png?id=[ID]&expires=[EXPIRATION]&signature=[SIGNATURE]
Phone number:
+1 (801) 824-9283
Favorite day of the year:
2025-01-01T07:00:00.000Z
Did you enjoy taking this form?:
Yes
You agree to all of these terms.:
[Yes]
Watch this video of a billionaire:
[I watched it]
On a scale of 1-10, how is your day today?:
10
",
"transcript": "Assistant: Name
Respondent: Elon
Assistant: Email
Respondent: elon@tesla.com
Assistant: Website
Respondent: https://tesla.com
Assistant: Phone number
Respondent: +1 (801) 824-9283
Assistant: File
Respondent: https://deformity.ai/api/files/private/IMG.jpeg?id=[ID]&expires=[EXPIRATION]&signature=[SIGNATURE]
Assistant: Ranking
Respondent: [Ranked] Deformity, Typeform, Google Forms
Assistant: Favorite day of the year
Respondent: 2025-01-01T07:00:00.000Z
Assistant: On a scale of 1-10, how is your day today?
Respondent: 10
Assistant: Signature
Respondent: https://deformity.ai/api/files/private/signature.png?id=[ID]&expires=[EXPIRATION]&signature=[SIGNATURE]
Assistant: You agree to all of these terms.
Respondent: [Yes]
Assistant: Watch this video of a billionaire
Respondent: [I watched it]
Assistant: Did you enjoy taking this form?
Respondent: Yes
Assistant: That's it! Thank you for completing the form.
",
"individualTranscriptItems": [
{
"question": "Name",
"answer": "Elon"
},
{
"question": "Email",
"answer": "elon@tesla.com"
},
{
"question": "Website",
"answer": "https://tesla.com"
},
{
"question": "Phone number",
"answer": "+1 (801) 824-9283"
},
{
"question": "File",
"answer": "https://deformity.ai/api/files/private/IMG.jpeg?id=[ID]&expires=[EXPIRATION]&signature=[SIGNATURE]"
},
{
"question": "Ranking",
"answer": "[Ranked] Deformity, Typeform, Google Forms"
},
{
"question": "Favorite day of the year",
"answer": "2025-01-01T07:00:00.000Z"
},
{
"question": "On a scale of 1-10, how is your day today?",
"answer": "10"
},
{
"question": "Signature",
"answer": "https://deformity.ai/api/files/private/signature.png?id=[ID]&expires=[EXPIRATION]&signature=[SIGNATURE]"
},
{
"question": "You agree to all of these terms.",
"answer": "[Yes]"
},
{
"question": "Watch this video of a billionaire",
"answer": "[I watched it]"
},
{
"question": "Did you enjoy taking this form?",
"answer": "Yes"
},
{
"question": "That's it! Thank you for completing the form.",
"answer": ""
}
],
"answer_File": "https://deformity.ai/api/files/private/IMG.jpeg?id=[ID]&expires=[EXPIRATION]&signature=[SIGNATURE]",
"answer_Name": "Elon",
"answer_Email": "elon@tesla.com",
"answer_Ranking": "[Ranked] Deformity, Typeform, Google Forms",
"answer_Website": "https://tesla.com",
"answer_Signature": "https://deformity.ai/api/files/private/signature.png?id=[ID]&expires=[EXPIRATION]&signature=[SIGNATURE]",
"answer_Phone number": "+1 (801) 824-9283",
"answer_Favorite day of the year": "2025-01-01T07:00:00.000Z",
"answer_Did you enjoy taking this form?": "Yes",
"answer_You agree to all of these terms.": "[Yes]",
"answer_Watch this video of a billionaire": "[I watched it]",
"answer_On a scale of 1-10, how is your day today?": "10"
}