> For AI agents: [llms.txt](https://docs.trustedauth.com/llms.txt) provides a Markdown index of this documentation.

# 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:

```json
{
  "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:**

```json
{
  "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                          |