Post Api Organizations Production Account

POST

/api/organizations/production-account

Authentication

AuthorizationBearer

Bearer token in the Authorization header. Integrators send an API key; the SpreadSpace dashboard sends a WorkOS JWT. The key prefix selects the mode against the same base URL: ss_live_… operates on live workspace data, while ss_test_… routes to the isolated developer sandbox tenant (test mode) where uploads return canned $0 sample extractions. See the “Testing (test mode)” section of the API description for details. Example: Authorization: Bearer ss_live_….

Bearer token in the `Authorization` header. Integrators send an API key; the SpreadSpace dashboard sends a WorkOS JWT. The key prefix selects the mode against the same base URL: `ss_live_…` operates on live workspace data, while `ss_test_…` routes to the isolated developer sandbox tenant (test mode) where uploads return canned $0 sample extractions. See the "Testing (test mode)" section of the API description for details. Example: `Authorization: Bearer ss_live_…`.

Headers

SpreadSpace-VersionstringOptionalformat: "^\d{4}-\d{2}-\d{2}$"

Date-stamped API surface version. Optional; sending no header (and having no per-key pin) resolves to the latest supported version 2026-05-03. Supported versions: 2026-05-03. Future breaking changes ship under new date stamps; existing callers keep the version they pinned.

Request

This endpoint expects an object.

organization_namestringRequired<=200 characters

organization_typeintegerRequired

user_roleintegerRequired

lending_programslist of integersRequired

monthly_document_volumeintegerRequired

current_processing_methodinteger or nullOptional

document_typesinteger or nullOptional

pain_pointinteger or nullOptional

team_inviteslist of objects or nullOptional

require_mfaboolean or nullOptional

checklist_completedboolean or nullOptional

Response headers

X-Request-IDstring

Stripe-style per-request correlation ID. Echoed from the inbound X-Request-ID header when the client provides one, otherwise minted server-side as req_<24 hex chars>. Quote in support tickets so we can find the request’s logs.

SpreadSpace-Versionstring

The API surface version the server resolved for this request. Always present, regardless of whether the client supplied the request-side SpreadSpace-Version header. Default: 2026-05-03.

Response

idstringformat: "uuid"

namestring

tierstring

workspace_modestring

onboarding_completedboolean

live_activatedboolean

current_user_rolestring

member_countinteger

created_atdatetime

workos_organization_idstring or null

business_typestring or null

intended_underwriter_countinteger or null

monthly_loan_volumestring or null

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

429

Too Many Requests Error

500

Internal Server Error

$	curl -X POST https://api.spreadspace.ai/api/organizations/production-account \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"organization_name": "string",
>	"organization_type": 1,
>	"user_role": 1,
>	"lending_programs": [
>	1
>	],
>	"monthly_document_volume": 1
>	}'

1	{
2	"id": "string",
3	"name": "string",
4	"tier": "string",
5	"workspace_mode": "string",
6	"onboarding_completed": true,
7	"live_activated": true,
8	"current_user_role": "string",
9	"member_count": 1,
10	"created_at": "2024-01-15T09:30:00Z",
11	"workos_organization_id": null,
12	"business_type": null,
13	"intended_underwriter_count": null,
14	"monthly_loan_volume": null
15	}