Prompt
identity verification webhook
Latest observation
Oct 29, 2026
OpenAI APIWeb search: off
If you’re implementing an identity verification webhook, here’s a practical checklist and a sample shape you can use.
What a verification webhook usually does
Your identity provider sends your server an event when a user’s verification status changes, for example:
verification.startedverification.pendingverification.verifiedverification.failedverification.requires_action
Typical webhook requirements
-
Public HTTPS endpoint
- Example:
POST https://api.yourapp.com/webhooks/identity
- Example:
-
Verify authenticity
- Use a shared secret, HMAC signature, or provider-specific signing key.
- Reject requests that fail signature verification.
-
Handle retries safely
- Webhook providers often retry on failure.
- Make your handler idempotent using event IDs.
-
Respond quickly
- Return
200 OKfast. - Process heavy work asynchronously if possible.
- Return
-
Log and monitor
- Store raw event payloads for debugging.
- Track failed deliveries and duplicate events.
Example payload
{
"event_id": "evt_123",
"type": "verification.verified",
"created_at": "2026-10-29T12:34:56Z",
"data": {
"user_id": "user_456",
"verification_id": "ver_789",
"status": "verified",
"provider": "example_idp"
}
}
Example handler logic
- Check signature header
- Parse event body
- Ignore if
event_idalready processed - Update user verification status in your database
- Trigger downstream actions if needed
Example response
HTTP/1.1 200 OK
Content-Type: application/json
{"received": true}
If you want, I can also help with one of these:
- Node.js/Express webhook implementation
- Python/FastAPI implementation
- Webhook signature verification
- Database schema for verification events
- Testing the webhook locally