Connections and deliveries
A connection is a linked account or endpoint that belongs to a site: a webhook address, Discord, Teams or Slack, a Cal.com, Mailchimp or Kit key, or a Stripe account. A form then switches it on in its live config.
- GET
/v1/connectionsforms:read - A site's connections, by
site. Addresses are masked after the host, and secrets never come back. - POST
/v1/connectionsconnections:write - Connects a webhook, Discord, Teams or more. A webhook's signing secret is in this answer only.
- GET
/v1/connections/{id}forms:read - One connection, and which forms use it.
- GET
/v1/connections/{id}/choices/{kind}forms:read - What can be picked in it, such as Cal.com's
event-types. - PATCH
/v1/connections/{id}connections:write - Changes
name,urlorheaders.{ status: "active" }turns a paused one back on and sends what it held. - DELETE
/v1/connections/{id}connections:write - Removes it. Refused with
409while a form uses it. - POST
/v1/connections/{id}/testconnections:write - Sends a sample, marked as a test. Ten an hour.
- POST
/v1/connections/{id}/rotate-secretconnections:write - A new signing secret. The old one keeps signing for 24 hours.
Connecting a webhook:
curl -X POST https://api.seaforms.io/v1/connections \ -H "Authorization: Bearer $SEAFORMS_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "siteId": "site_01JC8H2K4M9V6Q3T7X0B5N2R8D", "provider": "webhook", "name": "My CRM", "url": "https://hooks.northwind.co/seaforms", "headers": { "Authorization": "Bearer my-crm-key" } }'{ "connection": { "id": "con_01JC8H2K4M7P9X3V5B8N1Q6W2T", "siteId": "site_01JC8H2K4M9V6Q3T7X0B5N2R8D", "provider": "webhook", "name": "My CRM", "status": "active", "url": "https://hooks.northwind.co/•••", "headerNames": ["Authorization"], "createdAt": "2026-11-12T09:41:07Z", "usedBy": [] }, "secret": "whsec_…"}- The address must be
httpson port 443, a hostname rather than an IP address, and not one of Seaforms’ own. - Header values are write-only.
Host,Content-Length,Content-Type,Transfer-Encoding,Connection,User-Agentand anywebhook-*header are refused.Authorizationis fine. - Addresses are credentials. Discord, Teams and Zapier addresses work for anyone who has them, so they’re stored encrypted and only ever shown up to the host.
- A site holds up to 50 connections.
Deliveries
Section titled “Deliveries”One delivery is one target (an email alert, a thank-you email, an app or a webhook) for one submission.
- GET
/v1/submissions/{id}/deliveriessubmissions:read - Where one submission went, and how each try ended.
- GET
/v1/forms/{formId}/deliveriessubmissions:read - A form's deliveries. Takes
status,target,fromandto. - POST
/v1/deliveries/{id}/resendsubmissions:write - Sends it again.
A delivery’s status is pending, delivered, failed, held or skipped. Retries and pausing are on Retries and repeats.
ChatGPT is a trademark of OpenAI, and Claude and Claude Code are trademarks of Anthropic. Other product names and logos belong to their owners. None of them makes or endorses Seaforms. Trademarks