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 isplatform: "npm". - GET
/v1/sites/{siteId}account:read - One site.
- PATCH
/v1/sites/{siteId}forms:write - Changes
nameordomains.domainsreplaces 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,toandform.
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.
Who can be emailed
Section titled “Who can be emailed”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 (
409past 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.
Dev tokens
Section titled “Dev tokens”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.
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