Signatures
MFA Initiate
Initiates the multi-factor authentication (MFA) process.
- The request generates an authentication code and sends it to the specified phone number or email address. No request body - the server reads nothing from the body for this operation.
AuthorizationBearer <token>
JWT token to authenticate the request.
In: header
X-Api-Key<token>
API key, sent as a request header.
In: header
Query Parameters
tid?string
Transaction token identifying a specific recipient+envelope pair. Required for anonymous/recipient access (no Authorization header, or the header doesn't resolve to the envelope owner).
Format
uuidResponse Body
application/json
application/json
application/json
curl -X POST "https://example.com/signatures/mfa/initiate"{ "result": { "statusCode": 200, "message": "OK", "data": { "recipient": { "method": "email", "destination": { "email": "name@example.com" }, "expiresAt": "string", "message": "Please review and sign at your earliest convenience." } } }, "origin": "POST https://api.doctavian.com/v1/signatures/mfa/initiate", "dateTime": "2026-07-20T12:00:00.000Z", "userId": "810353f4-ea17-41d0-b72d-bb1eb9997205"}{ "error": { "message": "Envelope not found.", "statusCode": 400, "innerErrors": [ { "code": "ENVELOPE_ID_INVALID", "message": "Envelope not found.", "userMessage": "Envelope not found." } ] }, "origin": "POST https://api.doctavian.com/v1/signatures/mfa/initiate", "dateTime": "2026-07-20T12:00:00.000Z", "userId": "e407fd7d-eb6a-4820-b312-29b479692f2a", "operationId": "c482520dfeea9df36ed5b8daf50924dd"}{ "error": { "message": "Envelope not found.", "statusCode": 500, "innerErrors": [ { "code": "ENVELOPE_ID_INVALID", "message": "Envelope not found.", "userMessage": "Envelope not found." } ] }, "origin": "POST https://api.doctavian.com/v1/signatures/mfa/initiate", "dateTime": "2026-07-20T12:00:00.000Z", "userId": "1800594c-6824-4b03-ab9d-c8afab21d74c", "operationId": "63ce6a2e149f093a82fb0fbe389259eb"}