Skip to main content
Webhooks allow your application to receive real-time HTTP callbacks when data changes in Sessionboard. Instead of polling the API for updates, you can subscribe to specific events and receive notifications as they happen.

Event Catalog

Subscribe to any combination of the following webhook events.
EventDescription
contact.createdA new contact was created in the organization.
contact.updatedA contact’s details were updated.
contact.deletedA contact was deleted from the organization.
contact.event.associatedA contact was associated with an event.
contact.event.disassociatedA contact was removed from an event.
EventDescription
session.createdA new session was created.
session.updatedA session’s details were updated.
session.deletedA session was deleted.
EventDescription
exhibitor.createdA new exhibitor was created.
exhibitor.updatedAn exhibitor’s details were updated.
exhibitor.deletedAn exhibitor was deleted.
exhibitor.event.associatedAn exhibitor was associated with an event.
exhibitor.event.disassociatedAn exhibitor was removed from an event.
EventDescription
sponsor.createdA new sponsor was created.
sponsor.updatedA sponsor’s details were updated.
sponsor.deletedA sponsor was deleted.
sponsor.event.associatedA sponsor was associated with an event.
sponsor.event.disassociatedA sponsor was removed from an event.

Payload Structure

Every webhook delivery sends a JSON payload with the following structure:
{
  "data": {
    "actor_id": 7,
    "id": "fd4e0275-f018-40bc-909a-f8cdfa0df354"
  },
  "metadata": {
    "action": "session.created",
    "event_id": 4001,
    "org_id": "757e8d5b-ce66-45f5-ab36-273414f8ab2f",
    "resource_url": "https://public-api.sessionboard.com/v1/event/4001/sessions/fd4e0275-f018-40bc-909a-f8cdfa0df354"
  }
}

Payload Attributes

FieldDescription
data.actor_idThe ID of the user who performed the action.
data.idThe unique identifier of the affected resource.
metadata.actionThe webhook event type (e.g., session.created).
metadata.event_idThe Sessionboard event ID associated with the change, if applicable.
metadata.org_idYour organization’s unique identifier.
metadata.resource_urlA direct URL to fetch the full resource from the Public API.

Creating a Webhook

1

Open Webhook Settings

In the Sessionboard admin dashboard, navigate to Settings > Integrations > Webhooks.Webhook settings panel
2

Add an Endpoint

Click Add Endpoint and enter the URL where you want to receive webhook deliveries. This must be a publicly accessible HTTPS endpoint. Select which events you want to subscribe to for this endpoint.Adding a webhook endpoint
3

Save and Activate

Save the webhook configuration. Sessionboard will begin sending events to your endpoint immediately. You can also add custom headers for additional security (e.g., passing a token that your server validates to ensure the request is from Sessionboard).

Testing Webhooks

Use the Testing tab on any endpoint to send a sample payload without triggering a real action. You can also use Svix Play to capture and inspect deliveries in a temporary sandbox. Testing a webhook endpoint

Monitoring

Sessionboard provides delivery logs for each webhook endpoint in the admin dashboard. You can view recent deliveries, inspect payloads, and check response status codes. Failed deliveries are retried automatically with exponential backoff. Webhook delivery logs