Docs
Integrations
Send submissions to chat, to a mailing list, or into thousands of other tools through a webhook.
Slack, Discord and Microsoft Teams
Each form has one chat destination. In the admin panel at https://app.formham.co.uk/admin, edit the form
and paste an incoming webhook URL into Slack / Discord / Teams Webhook URL. Every new
submission is posted to that channel. We only accept URLs from the services themselves:
| Service | Where to get the URL | Looks like |
|---|---|---|
| Slack | Create an app with Incoming Webhooks and add it to a channel. | https://hooks.slack.com/services/… |
| Discord | Channel settings → Integrations → Webhooks → New Webhook. | https://discord.com/api/webhooks/… |
| Microsoft Teams | Use a Workflows (Power Automate) “post to a channel when a webhook request is received” flow. The older Office 365 connector URLs are not accepted. | https://….logic.azure.com/… or ….environment.api.powerplatform.com/… |
Mailchimp
Add people who fill in a form to a Mailchimp audience. Create a mailing list destination on the
Lists screen with your Mailchimp API key, its server prefix (the us21 part of
the key) and the audience, then choose that list under Add subscribers to on the form's
General tab and tell it which field holds the email address (and, optionally, first and
last name). Make sure your form collects the consent the law requires before you do this. A plain webhook
destination is available on the same screen if your mailing tool is not Mailchimp.
Zapier, Make and n8n
There are two ways in. Both use the same signed payload described in Webhooks.
The simple way: a catch hook
- In Zapier, create a Zap with Webhooks by Zapier → Catch Hook. In Make, add a
Webhooks → Custom webhook module. In n8n, add a Webhook node set
to
POST. - Copy the URL it gives you into the form's Webhook URL (Notifications tab).
- Send a test submission so the tool can see the fields, then map
data.name,data.emailand so on to the next step.
The subscription API
For your own connector, or to manage hooks in code, create an Integrations token on the
API tokens screen and call the REST API. All requests use
Authorization: Bearer YOUR-TOKEN.
| Request | What it does |
|---|---|
GET /api/v1/forms | Lists the forms the token can see. |
GET /api/v1/forms/{uuid}/submissions/sample | An example payload, for mapping fields. |
GET /api/v1/hooks | Lists your subscriptions. |
POST /api/v1/hooks | Subscribes a URL: {"form_uuid": "…", "target_url": "https://…"}. HTTPS only, up to 10 per form. |
DELETE /api/v1/hooks/{id} | Removes a subscription. |
curl -X POST https://app.formham.co.uk/api/v1/hooks \
-H "Authorization: Bearer YOUR-TOKEN" \
-H "Content-Type: application/json" \
-d '{"form_uuid":"YOUR-FORM-ID","target_url":"https://hooks.example.com/abc"}'
The API allows 120 requests a minute, and 30 a minute for creating or deleting hooks.
Agencies
If you look after many client sites, the Agency API gives you one credential across all of them, for pulling leads into your own systems and creating forms as part of building a site.