Signup

POST /auth/signup

No credential

This operation is public: it authenticates by its own mechanism — a webhook signature or a channel token — rather than by a platform credential.

Request body — SignupRequest

Field	Type		Notes
email	string	required	min length 3 max length 254
organization_name	string | null	optional	min length 1 max length 200

Responses

Status	Description	Body
202	Successful Response	SignupPending
422	Validation Error	HTTPValidationError

Only the success paths are declared

Any operation may also answer any status in the error catalogue, and every failure body is the platform envelope — including the 422 this document types as HTTPValidationError.

Example

The body shows the fields the schema always carries. Which combination is legal is a service rule the schema cannot express, so read the description above before copying this.

curl -X POST https://your-deployment.example.com/auth/signup \
  -H "Content-Type: application/json" \
  -d '{
       "email": "string"
     }'

Response — SignupPending

Field	Type		Notes
status	string	optional	Default "confirmation_pending".
expires_in	integer	required	—