/v1/me/mfa/emailAuthStart 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
labelstringName for the factor (max 64).
Response · 200
destination_masked*stringMasked address the code went to.
code_expires_at*string · date-timeWhen the code stops working (5 minutes).
factor_id*string · uuidThe 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"
}