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