SynapseDocumentation

Verify pending email code

Confirms the 6-digit code sent to a pending email address. Only after this succeeds does Gateway bind the email to the wallet account.

POST/api/v1/auth/email/verify-codeWallet JWT

For AI agents

Step 3 of email binding. Submit the code from the verification email. Codes expire after 10 minutes and lock after 5 bad attempts.

Requires: PUT /auth/me/profile must have staged a pendingEmail first

Generated OpenAPI reference

POST/api/v1/auth/email/verify-code

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

[key: string]?any

Response Body

application/json

application/json

curl -X POST "https://api-staging.synapse-network.ai/api/v1/auth/email/verify-code" \  -H "Content-Type: application/json" \  -d '{    "email": "new@example.com",    "code": "123456"  }'
{
  "profile": {
    "walletAddress": "0x...",
    "email": "new@example.com",
    "emailVerified": true,
    "pendingEmail": null
  }
}
{
  "code": "EMAIL_VERIFICATION_EXPIRED",
  "message": "The code expired; request a new one"
}
Back to API Reference