A valid request URL is required to generate request examples{
"success": true,
"data": {
"subscription": {
"legalName": "Acme Home Services LLC",
"sellerName": "Acme Home Services",
"ein": "84-1234567",
"posture": "tenant_seller",
"subscribedAreaCodes": [
"415",
"628"
],
"provider": "direct",
"status": "submitted",
"submittedAt": "2026-07-13T15:00:00.000Z",
"createdAt": "2026-07-13T14:00:00.000Z",
"updatedAt": "2026-07-13T15:00:00.000Z"
},
"readiness": {
"scrubSubscriptionActive": false,
"pewcDisclosureApproved": false,
"pewcDisclosureStored": false,
"sellerIdentitySet": true,
"listEvaluated": false,
"launchBlockedReason": "scrub subscription not active",
"ready": false
}
}
}{
"type": "about:blank",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>",
"code": "<string>",
"errors": [
{
"field": "<string>",
"message": "<string>"
}
]
}{
"type": "about:blank",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>",
"code": "<string>",
"errors": [
{
"field": "<string>",
"message": "<string>"
}
]
}Submit seller identity + DNC SAN
Save the org’s seller identity (sellerName, legalEntity, ein, sellerAddress, sellerPhone, posture) + the National-DNC SAN + per-area-code entitlement, and move the registration draft → submitted. posture (‘tenant_seller’ default | ‘flowyte_caller’) is the liability-posture stored as DATA. THE SAFETY INVARIANT — this CAPTURES state, it does NOT ACTIVATE: it never sets status=active (the scrub-vendor/credential validation does that off-box) and never approves the PEWC disclosure. So a marketing campaign stays un-launchable until the founder completes onboarding. A raw SAN secret is never stored in a column.
A valid request URL is required to generate request examples{
"success": true,
"data": {
"subscription": {
"legalName": "Acme Home Services LLC",
"sellerName": "Acme Home Services",
"ein": "84-1234567",
"posture": "tenant_seller",
"subscribedAreaCodes": [
"415",
"628"
],
"provider": "direct",
"status": "submitted",
"submittedAt": "2026-07-13T15:00:00.000Z",
"createdAt": "2026-07-13T14:00:00.000Z",
"updatedAt": "2026-07-13T15:00:00.000Z"
},
"readiness": {
"scrubSubscriptionActive": false,
"pewcDisclosureApproved": false,
"pewcDisclosureStored": false,
"sellerIdentitySet": true,
"listEvaluated": false,
"launchBlockedReason": "scrub subscription not active",
"ready": false
}
}
}{
"type": "about:blank",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>",
"code": "<string>",
"errors": [
{
"field": "<string>",
"message": "<string>"
}
]
}{
"type": "about:blank",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>",
"code": "<string>",
"errors": [
{
"field": "<string>",
"message": "<string>"
}
]
}Authorizations
Flowyte secret API key (Authorization: Bearer flowyte_sk_live_…). Scope-gated; is scoped to your organization — a key can never reach another tenant. The listed scopes in each operation's apiKey requirement are the scopes that key must hold. The tokenUrl is nominal: keys are minted in the dashboard.
- Token URL
- /api/v1/api-keys
Body
The responsible seller name (PEWC element c).
The seller legal entity (stored as legalName).
Normalized to E.164.
National-DNC SAN; required to move the registration to submitted.
Show child attributes
Show child attributes
direct (default) | vendor.
tenant_seller (default) | flowyte_caller.