Knowledge-based question events

Knowledge-based question events notify you when question-related changes occur. When a knowledge-based question event is triggered, IDaaS sends an HTTP POST request to your configured webhook URL with a JSON payload containing the event details.

Payload structure

Every knowledge-based question event payload has this structure:

{
  "id": "019cf7c4-7a88-7ff5-9a8e-da26058325ee",
  "type": "kba.question.created",
  "accountId": "fba02d5c-2f79-4cfd-91f5-6bd454e97ab3",
  "eventTime": "2026-03-16T17:49:34Z",
  "data": {
    // Event-specific data here
  }
}

The data object contains event-specific fields. See the event examples later on this page for the full data object for each event type.

Top-level fields

Field	Type	Description
id	string	Unique identifier for this webhook delivery
type	string	The event that occurred (e.g., kba.question.created)
accountId	string	Your account identifier
eventTime	string	When the event occurred (ISO 8601 format)
data	object	Details about what happened (varies by event type)

Event types

kba.question.created

Triggered when a knowledge-based question is created.

Example payload:

{
  "id": "019cf7c4-7a88-7ff5-9a8e-da26058325ee",
  "type": "kba.question.created",
  "accountId": "fba02d5c-2f79-4cfd-91f5-6bd454e97ab3",
  "eventTime": "2026-03-16T17:49:34Z",
  "data": {
    "subject": "7a578db7-e8c8-421c-b5aa-2975f1418932",
    "subjectName": "john",
    "subjectType": "USER",
    "resourceName": "User Portal",
    "sourceIp": "104.30.161.19",
    "entityType": "USERQUESTIONS",
    "entityId": "c26136e6-d68d-4dd2-a22c-1980c7359a67",
    "entityName": "What was the name of your high school?"
  }
}

The data object includes the following fields:

Field	Description
subject	ID of the user for whom the question was created
subjectName	Username of the user for whom the question was created
subjectType	Always USER
resourceName	Where the question was created (e.g., "User Portal")
sourceIp	IP address from which the question was created
entityType	Always USERQUESTIONS for knowledge-based question events
entityId	ID of the knowledge-based question
entityName	The knowledge-based question text