Skip to main content

​
Email Verification (Self-serve)

Send a magic link to verify a user’s email address. User clicks the link, done.

​
Setup

  1. Create an app in the dashboard
  2. Get an M2M token from Settings > M2M Tokens

​
Send verification

curl -X POST "https://api.scute.io/v1/verify/{app_id}/verifications/intent" \
  -H "Content-Type: application/json" \
  -H "X-Authorization: Bearer {m2m_token}" \
  -d '{
    "intent_name": "Email Verification",
    "method": "email",
    "verification_type": "magic_link",
    "meta_data": {
      "contact_email": "user@example.com",
      "contact_name": "Jane"
    }
  }'
Response: 
{
  "verification_id": "uuid",
  "status": 200,
  "message": "Verification needed, sent to an email ending in user@example.com"
}

​
What happens

  1. User receives an email with a magic link
  2. User clicks the link, lands on the verification page
  3. Identity confirmed, status updates to verified
  4. Webhook fires to your endpoint (if configured)

​
Check status

curl "https://api.scute.io/v1/verify/{app_id}/verifications/{verification_id}" \
  -H "X-Authorization: Bearer {m2m_token}"

​
Webhook

Configure in Settings > Webhooks. You’ll get: 
{
  "event_type": "verification.email.verified",
  "data": {
    "verification_id": "uuid",
    "meta_data": { "contact_email": "user@example.com" }
  }
}
See Webhooks Guide for setup and signature verification.