Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.scute.io/llms.txt

Use this file to discover all available pages before exploring further.

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.