Registration and verification

Register + OTP is the front door: without verifying your phone you won’t receive the apiKey that unlocks the rest of the API.

The Platform API separates account auth from API auth (apiKey).

What is `verificationToken`?

A short-lived JWT (~15 minutes) returned when a second step is required. It is not the API key.

Source	When	Next step
`POST /v1/platform/register`	After signup; OTP sent to phone	`POST /v1/platform/verify` with `code` (WhatsApp/SMS)
`POST /v1/platform/login`	Account with 2FA; `requiresSecondFactor: true`	Another `POST /v1/platform/login` with `totpCode` or `backupCode`

POST /v1/platform/verify is only for phone OTP after register. TOTP from an authenticator app goes in POST /login, not verify.

Full flow for agents

First account and first workspace

The first workspace is created automatically on phone verification — not on register.

# Register → verify → apiKey + workspaceId
# See OpenAPI examples on POST /register, /verify, /login

Second workspace

curl -X POST https://api.notifique.dev/v1/workspaces \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"name": "Staging", "color": "#3B82F6"}'

Requires workspace:create (or empty scopes during onboarding).

curl -X POST https://api.notifique.dev/v1/platform/login \
  -H "Content-Type: application/json" \
  -d '{
    "email": "dev@company.com",
    "password": "SecurePass123!",
    "createApiKey": true,
    "workspaceId": "clws_02H..."
  }'

Optional workspaceId: defaults to most recent OWNER workspace.
Only workspaces where you are OWNER or ADMIN accept a new key via login.
createApiKey: false → only sessionToken.

Step A — email + password → requiresSecondFactor + verificationToken. Step B — same endpoint with that token + totpCode (+ optional createApiKey, workspaceId).

Endpoint	Purpose
`POST /register`	Account + OTP; returns `verificationToken`
`POST /verify`	Phone OTP only; returns `apiKey`, first `workspaceId`
`POST /login`	Credentials, 2FA completion, optional new API key

Next: Quick start · Workspaces

Simple guides

Learn more

Workspaces

OAuth 2.1

AI and no-code

BYOK

Changelog

Platform API

Account

API Keys

Billing

Credits

Team

Metadata

OAuth

Webhooks

Deliveries

Logs

Workspaces

Registration and verification

What is `verificationToken`?

Full flow for agents

First account and first workspace

Second workspace

​What is verificationToken?

​Full flow for agents

​First account and first workspace

​Second workspace

​Login with workspaceId

​2FA login

​Register / verify / login summary

What is `verificationToken`?

Full flow for agents

First account and first workspace

Second workspace

Login with `workspaceId`

2FA login

Register / verify / login summary