Auth API reference

Auth API · Consumer-Mfa

post/{app_slug}/v1/me/mfa/step-up/send-codeAuth

Email a step-up code

Mints a single-use 6-digit code against one of the account's enabled email factors and delivers it to the bound address. Follow with `/step-up` submitting the code. Codes expire after 5 minutes; sends are throttled per contact (30s between sends, shared with the sign-in path). Refused while step-up is locked on this session.

Path parameters

app_slug*string

Slug of the app.

Request body

factor_idstring · uuid

Email factor to deliver the code through. Defaults to the first enabled email factor on the account.

Response · 200

email_masked*string

Masked address the code was sent to.

Example: "a***a@e***e.com"

code_expires_at*string · date-time

When the emailed step-up code expires (ISO 8601).

Example

Request

POST https://api.auth.productcraft.co/{app_slug}/v1/me/mfa/step-up/send-code
Authorization: Bearer YOUR_TOKEN
Content-Type: application/json

{
  "factor_id": "00000000-0000-0000-0000-000000000000"
}

Response

{
  "email_masked": "a***a@e***e.com",
  "code_expires_at": "2026-01-01T00:00:00.000Z"
}