Sign in

v1

latestOpenAPI 3.0.32026-07-242644125.9 KB
Webhooks

Create Webhook

Registers a new webhook URL to receive notifications for verification events. Users can optionally specify which events to subscribe to using the 'events' array. Supports verification.completed (when verification finishes) and verification.historical (when historical employment data becomes available) events. If events are not specified, the webhook subscribes to all available events by default.

post/webhooks

Request body

descriptionstring

Description of the webhook.

endpoint_urlstring uri required

The URL to send the webhook notifications to.

eventsstring[]

Array of event types to subscribe to. If not provided, defaults to all available events.

Example request

{
  "description": "Production verification notifications",
  "endpoint_url": "https://yourapi.com/webhook/handler",
  "events": [
    "verification.completed",
    "verification.historical"
  ]
}

Response

Webhook created successfully.

idstring uuid

Unique identifier for the webhook.

company_idstring uuid

Company identifier owning the webhook.

descriptionstring

Description of the webhook.

endpoint_urlstring uri

URL to send the webhook notifications to.

secret_keystring

A secret key used to verify the signature in the X-Signature header of the webhook, ensuring that the webhook request originates from the Income Bureau.

is_activeboolean

Whether the webhook is active.

eventsstring[]

Array of event types this webhook is subscribed to.

created_atstring date-time

Timestamp when the webhook was created.

updated_atstring date-time

Timestamp when the webhook was last updated.

Example response

{
  "events": [
    "verification.completed",
    "verification.historical"
  ]
}