Platform API reference

Platform API · Me

post/v1/me/mfa/emailAuth

Start adding email codes

Creates a pending email factor bound to the account's verified primary email and sends it a code (valid 5 minutes). Not idempotent and takes no `Idempotency-Key`: the answer carries a secret (an authenticator seed, a ceremony challenge or recovery codes) that a replay cache must not hold.

Request body

labelstring

Name for the factor (max 64).

Response · 200

destination_masked*string

Masked address the code went to.

code_expires_at*string · date-time

When the code stops working (5 minutes).

factor_id*string · uuid

The pending factor; confirm it with the emailed code.

Example

Request

POST https://api.platform-auth.productcraft.co/v1/me/mfa/email
Authorization: Bearer YOUR_TOKEN
Content-Type: application/json

{
  "label": "string"
}

Response

{
  "destination_masked": "string",
  "code_expires_at": "2026-01-01T00:00:00.000Z",
  "factor_id": "00000000-0000-0000-0000-000000000000"
}