Skip to content

Sites

A site is one website on one platform. Its forms share its addresses, its connected apps and its plan.

GET /v1/sitesaccount:read
The sites this key can see.
POST /v1/sitesforms:write
Adds a site: { name, platform, platformSiteId?, domains? }. A site built with code is platform: "npm".
GET /v1/sites/{siteId}account:read
One site.
PATCH /v1/sites/{siteId}forms:write
Changes name or domains. domains replaces the whole list.
GET /v1/sites/{siteId}/usageaccount:read
This month's submissions and AI drafts against the plan's allowance.
GET /v1/sites/{siteId}/statssubmissions:read
Sessions, submissions, finish rate, paid, booked, top sources and each day's numbers. Takes from, to and form.
Site
interface Site {
id: string; // site_…
name: string;
platform: "framer" | "webflow" | "wordpress" | "npm"; // npm: a site built with code
platformSiteId: string | null; // the builder's own id for the site
domains: string[]; // exact origins, such as "https://northwind.co"
plan: { plan: "free" | "starter" | "pro" | "agency"; source: string }; // source: "subscription" unless the site has its own
createdAt: string;
}

domains are the addresses the site’s forms take submissions from. A submission from anywhere else is kept as spam. Each is a whole origin: scheme and host, no path.

Email alerts can go to your team and to any address that has confirmed. Someone who isn’t a member gets a link to confirm first, and nothing is sent to them until they do.

GET /v1/sites/{siteId}/recipientsforms:read
The addresses that can be emailed about submissions, and whether each has confirmed.
POST /v1/sites/{siteId}/recipientsforms:write
Adds an address: { email }. Someone outside your team gets a link to confirm before they're sent anything.
DELETE /v1/sites/{siteId}/recipients/{recipientId}forms:write
Removes an address.
  • At most 25 addresses can be waiting to confirm on a site (409 past that), and 20 new ones can be added per workspace in a day (429).
  • A form’s settings may name an address that’s still waiting. Its emails are skipped until it confirms.

For trying forms on localhost.

GET /v1/sites/{siteId}/dev-tokensforms:read
The site's dev tokens, without their values.
POST /v1/sites/{siteId}/dev-tokensforms:write
Makes one: { name }. The value (sfd_…) is in this answer only.
DELETE /v1/sites/{siteId}/dev-tokens/{id}forms:write
Ends one.
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