Auth API reference

Auth API · Consumer-Auth

post/{app_slug}/v1/auth/request-verificationAuth

Mint a contact-verification code (PAK-required)

Mints a fresh 6-digit verification code bound to the email or phone contact named in the body. Body must contain exactly one of `email` / `phone`. PAK-required — `Authorization: Bearer <pcft_live_*>` carrying `auth.user.verify.create` narrowed to this app's URN. Public mint flows are refused with 401 — any anonymous mint endpoint is a spam-forwarder vector. Returns `{ code, expires_at }` for delivery via the customer's own SMTP / SMS provider. Returns `{}` (no code) when the contact doesn't match an account in this app or is already verified — uniform shape prevents enumeration. Issuing a code invalidates any previously issued, unconsumed code for the same contact — including the one auto-emailed at signup. Only the most recently minted code is accepted.

Path parameters

app_slug*string

Slug of the app.

Request body

emailstring

Email contact value to target. Set this OR `phone`, not both.

Example: "jane@example.com"

phonestring

Phone contact value (any format the customer normalised; recommended E.164). Set this OR `email`, not both.

Example: "+15551234567"

Response · 201 `{ code, expires_at }` when the contact exists and is unverified; `{}` otherwise.

code*string

Plaintext 6-digit code. Returned when the contact matches an EndUser in this app and the precondition is satisfied (contact unverified, for verification; contact verified, for reset). Otherwise the response is `{}` (no code) — same shape on both branches to prevent enumeration.

Example: "123456"

expires_at*string

Code expiry, ISO 8601. Codes live for 10 minutes.

Example: "2026-05-09T17:30:00.000Z"

Example

Request

POST https://api.auth.productcraft.co/{app_slug}/v1/auth/request-verification
Authorization: Bearer YOUR_TOKEN
Content-Type: application/json

{
  "email": "jane@example.com",
  "phone": "+15551234567"
}

Response

{
  "code": "123456",
  "expires_at": "2026-05-09T17:30:00.000Z"
}