A webhook is an https:// address of yours that ONCORR calls as soon as something happens. Create one under API & webhooks in ONCORR, or subscribe from code with the REST-hook endpoints below (this is how the Zapier and Make apps do it).
Events
| Event | When it is sent |
|---|---|
| registration.created | A registration was created |
| registration.updated | A registration was changed |
| registration.cancelled | A registration was cancelled |
| checkin.created | A guest checked in |
| flight.changed | A tracked flight changed (delay, gate, landing…) |
| payment.succeeded | A payment was received |
| invitation.responded | An invitee registered or declined |
What you receive
A POST with a JSON body {id, type, created_at, data} and these headers:
X-Oncorr-Event— the event name, e.g.registration.createdX-Oncorr-Delivery— the delivery number (the same on every retry)X-Oncorr-Signature—t={unix time},v1={HMAC-SHA256 hex of "t.rawBody" with your signing secret}
Answer with any 2xx within 10 seconds. Anything else is retried after 1 min, 5 min, 30 min, 2 h, 6 h, 12 h and 24 h (8 attempts). After 50 failures in a row the endpoint is switched off.
Use the event id to ignore duplicates.
Sample payloads
{
"id": "evt_01jbz9x3y8k2m4q6r7s8t9v0w1",
"type": "registration.created",
"created_at": "2026-10-04T14:05:09+00:00",
"data": {
"id": 98123,
"object": "registration",
"event_id": 1234,
"status": "registered",
"first_name": "Ann",
"last_name": "Lee",
"email": "ann.lee@example.com",
"company": "Acme Pharma",
"attendee_type": "Investigator",
"registered_at": "2026-10-04T14:05:09+00:00",
"check_in": {
"checked_in": false,
"checked_in_at": null,
"method": null
}
}
}
{
"id": "evt_01jbz9x3y8k2m4q6r7s8t9v0w1",
"type": "registration.updated",
"created_at": "2026-10-04T14:05:09+00:00",
"data": {
"id": 98123,
"object": "registration",
"event_id": 1234,
"status": "registered",
"first_name": "Ann",
"last_name": "Lee",
"email": "ann.lee@example.com",
"company": "Acme Pharma",
"attendee_type": "Investigator",
"registered_at": "2026-10-04T14:05:09+00:00",
"check_in": {
"checked_in": false,
"checked_in_at": null,
"method": null
},
"changed": [
"OfficePhone"
]
}
}
{
"id": "evt_01jbz9x3y8k2m4q6r7s8t9v0w1",
"type": "registration.cancelled",
"created_at": "2026-10-04T14:05:09+00:00",
"data": {
"status": "cancelled",
"id": 98123,
"object": "registration",
"event_id": 1234,
"first_name": "Ann",
"last_name": "Lee",
"email": "ann.lee@example.com",
"company": "Acme Pharma",
"attendee_type": "Investigator",
"registered_at": "2026-10-04T14:05:09+00:00",
"check_in": {
"checked_in": false,
"checked_in_at": null,
"method": null
}
}
}
{
"id": "evt_01jbz9x3y8k2m4q6r7s8t9v0w1",
"type": "checkin.created",
"created_at": "2026-10-04T14:05:09+00:00",
"data": {
"object": "checkin",
"id": 5521,
"event_id": 1234,
"registration_id": 98123,
"name": "Ann Lee",
"email": "ann.lee@example.com",
"session": null,
"guests": 0,
"method": "qr",
"checked_in_at": "2026-11-02T08:41:00+00:00"
}
}
{
"id": "evt_01jbz9x3y8k2m4q6r7s8t9v0w1",
"type": "flight.changed",
"created_at": "2026-10-04T14:05:09+00:00",
"data": {
"change": {
"type": "delay",
"old": "0",
"new": "45"
},
"flights": [
{
"registration_id": 98123,
"direction": "arrival",
"airline": "DL",
"flight_number": "1234",
"status": "delayed",
"delay_minutes": 45
}
]
}
}
{
"id": "evt_01jbz9x3y8k2m4q6r7s8t9v0w1",
"type": "payment.succeeded",
"created_at": "2026-10-04T14:05:09+00:00",
"data": {
"object": "payment",
"id": 771,
"event_id": 1234,
"registration_id": 98123,
"amount": 450,
"currency": "USD"
}
}
{
"id": "evt_01jbz9x3y8k2m4q6r7s8t9v0w1",
"type": "invitation.responded",
"created_at": "2026-10-04T14:05:09+00:00",
"data": {
"id": 4410,
"object": "invitation",
"event_id": 1234,
"participant_id": 55012,
"registration_id": 98123,
"code": "K7PQ2M",
"status": "registered",
"response": "registered",
"first_name": "Ann",
"last_name": "Lee",
"email": "ann.lee@example.com",
"invited_at": "2026-09-20T09:00:00+00:00",
"email_sent_at": "2026-09-20T09:01:00+00:00",
"confirmed_at": "2026-10-04T14:05:09+00:00"
}
}
Check the signature
Always verify the signature against the raw body before trusting a delivery, and reject old timestamps (replay protection).
$raw = file_get_contents('php://input');
$header = $_SERVER['HTTP_X_ONCORR_SIGNATURE'] ?? '';
preg_match('/^t=(\d+),v1=([a-f0-9]{64})$/', $header, $m) || exit(http_response_code(400));
if (abs(time() - (int) $m[1]) > 300) { exit(http_response_code(400)); } // replay window: 5 minutes
$expected = hash_hmac('sha256', $m[1] . '.' . $raw, getenv('ONCORR_WEBHOOK_SECRET'));
if (! hash_equals($expected, $m[2])) { exit(http_response_code(401)); }
$event = json_decode($raw, true); // ['id' => 'evt_…', 'type' => 'registration.created', 'data' => [...]]
http_response_code(200);
const crypto = require('crypto');
// Express: app.post('/oncorr', express.raw({ type: 'application/json' }), handler)
function verify(req, secret) {
const m = /^t=(\d+),v1=([a-f0-9]{64})$/.exec(req.get('X-Oncorr-Signature') || '');
if (!m || Math.abs(Date.now() / 1000 - Number(m[1])) > 300) return false;
const expected = crypto.createHmac('sha256', secret).update(`${m[1]}.${req.body}`).digest('hex');
return crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(m[2]));
}
import hmac, hashlib, re, time
def verify(raw_body: bytes, header: str, secret: str) -> bool:
m = re.fullmatch(r"t=(\d+),v1=([a-f0-9]{64})", header or "")
if not m or abs(time.time() - int(m.group(1))) > 300:
return False
signed = m.group(1).encode() + b"." + raw_body
expected = hmac.new(secret.encode(), signed, hashlib.sha256).hexdigest()
return hmac.compare_digest(expected, m.group(2))
using System.Security.Cryptography; using System.Text; using System.Text.RegularExpressions;
static bool Verify(string rawBody, string header, string secret) {
var m = Regex.Match(header ?? "", @"^t=(\d+),v1=([a-f0-9]{64})$");
if (!m.Success || Math.Abs(DateTimeOffset.UtcNow.ToUnixTimeSeconds() - long.Parse(m.Groups[1].Value)) > 300) return false;
using var h = new HMACSHA256(Encoding.UTF8.GetBytes(secret));
var expected = Convert.ToHexString(h.ComputeHash(Encoding.UTF8.GetBytes(m.Groups[1].Value + "." + rawBody))).ToLowerInvariant();
return CryptographicOperations.FixedTimeEquals(Encoding.ASCII.GetBytes(expected), Encoding.ASCII.GetBytes(m.Groups[2].Value));
}
Subscribe from code (REST hooks)
Scope webhooks:manage. The answer contains the signing secret once.
curl -X POST https://oncorr.info/api/v1/webhooks \
-H "Authorization: Bearer onc_your_token_here" -H "Content-Type: application/json" \
-d '{"url":"https://hooks.example.com/oncorr","events":["registration.created","checkin.created"],"event_id":1608}'
curl https://oncorr.info/api/v1/webhooks -H "Authorization: Bearer onc_your_token_here"
curl -X DELETE https://oncorr.info/api/v1/webhooks/42 -H "Authorization: Bearer onc_your_token_here"