Skip to content
O ONCORR

Colour theme

Text size

Contrast

Request a quote

Webhooks

Events, sample payloads and signature checks.

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

Webhook events
EventWhen it is sent
registration.createdA registration was created
registration.updatedA registration was changed
registration.cancelledA registration was cancelled
checkin.createdA guest checked in
flight.changedA tracked flight changed (delay, gate, landing…)
payment.succeededA payment was received
invitation.respondedAn 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.created
  • X-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"
Nothing leaves ONCORR until an administrator has allowed the receiving host (System → Integrations). Deliveries to a host that is not allowed yet are kept and can be retried from the delivery log.