Skip to content

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, url or headers. { status: "active" } turns a paused one back on and sends what it held.
DELETE /v1/connections/{id}connections:write
Removes it. Refused with 409 while 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:

Terminal window
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" }
}'
Response
{
"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 https on 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-Agent and any webhook-* header are refused. Authorization is 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.

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, from and to.
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.

Was this helpful?

Your answer goes straight to the person who wrote it.

Thanks. We read every note and update the article.

Thanks, that helps us keep these useful.

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