Skip to main content
POST
/
api
/
v1
/
webhooks
/
auth0
/
email-verified
Auth0 email verification webhook
curl --request POST \
  --url http://localhost:9001/api/v1/webhooks/auth0/email-verified \
  --header 'Content-Type: application/json' \
  --header 'x-webhook-secret: <api-key>' \
  --data '
{
  "event": "email_verified",
  "timestamp": "2024-01-15T10:35:00Z",
  "user": {
    "user_id": "auth0|abc123",
    "email": "user@example.com",
    "name": "John Doe",
    "picture": "https://example.com/avatar.jpg",
    "email_verified": true
  }
}
'
{
  "received": true,
  "processed_at": "2024-01-15T10:35:01Z"
}

Authorizations

x-webhook-secret
string
header
required

Auth0 webhook secret for authenticating webhook requests. For local development only, use 'dev-bypass' to skip authentication.

Body

application/json

Generic webhook payload from Auth0

event
string
required

Event type (e.g., "user_signup", "email_verified")

Example:

"user_signup"

user
object
required

User data in Auth0 webhook payload

timestamp
string<date-time>

When the event occurred in Auth0

Example:

"2024-01-15T10:30:00Z"

Response

200 - application/json

Webhook received and processed (or acknowledged with error logged)

Standard webhook acknowledgment response. Always returns success to prevent webhook retries from external services.

received
boolean

Whether the webhook was received

Example:

true

processed_at
string<date-time>

UTC timestamp when webhook was processed (optional)

Example:

"2024-01-15T10:30:01Z"