By setting up webhooks for contacts, you can send your contact data to your own tools whenever a specific action is triggered. For example, when a new contact is created, you can send the contact data to your own marketing automation.
You can find out more about what webhooks are and how they work here and what actions are in automations here.
You can use contact webhooks with automations for the following:
- Share contact data with external teams or agencies without giving them full access to your Typeform account
- Automatically sync contacts to a separate record system
- Build custom integrations with your existing software
- Connect Typeform to tools that don't have a native integration
Here’s what you'll need:
- A Typeform account with access to the Contacts & Automations add-on
- A destination for your webhook data (for example, low-code and no-code integration platforms, like Pipedream, Make, or n8n, or a custom application)
Here’s how to get started:
- Log into your Typeform account and navigate to the Automations tab.
- Click + Create automation to set up a new automation, or open up an existing one.
- Select one of the contact-related triggers.
You can select one of the following to trigger the automation:
- When a contact is created
- When a contact is added to a list
- When a contact property is updated
- When a contact is removed from a list
If you want to deliver email messages with webhooks upon form submission, check out this setup guide.
- Once you’ve set up a trigger, click + to add an action.
- Select the Webhook option as the action to be triggered.
- Now you can start setting up your webhook. Enter your website URL in the Endpoint URL field. This is where the automation will be sent when the conditions specified in your trigger are met. Click Next.
- Toggle the switch to verify SSL certificates when delivering payloads. It is recommended to secure your webhooks this way, and you can find out more about how to secure your webhooks here.
- Optionally, you can also enter your webhook secret to verify that requests are coming from Typeform and nobody else. You can find out more about webhook secrets here.
- You can click the eye icon to show or hide the secret value you’ve entered. When you’re done setting up your webhook, click Finish.
- Now you’ll see that delivering a webhook has been set up as an action in your contacts automations. Click Activate to start the automation.
Now you’ll see that your automation is active. You can click Stop automation to do just that.
Click Send webhook to manage your webhook action. You can click Delete action to delete a webhook, or the Edit button to change your endpoint URL.
How to test your webhook
Now you’ll see your Webhook settings. Navigate to Deliveries and click Test endpoint to send test event data to your webhook URL.
To verify your automation works as expected, you can create a test URL to collect test submissions on websites like https://requestbin.com. Your test deliveries will look similar to the screenshot below:
Once you’ve tested your webhook, your new contact automation is ready to go!