# Topic types

Featurebase webhooks support the following event topics. Subscribe to the topics you need when registering your webhook.

> **Note:** Webhooks for the Support module are not available yet. [Subscribe to this post](https://feedback.featurebase.app/p/support-module-webhooks) to get notified when they are released.


## Available topics

| Topic | Description |
|  --- | --- |
| `post.created` | A new post was created |
| `post.updated` | An existing post was updated |
| `post.deleted` | A post was successfully deleted |
| `post.voted` | A post received a vote |
| `changelog.published` | A new changelog entry was published |
| `comment.created` | A new comment was created |
| `comment.updated` | An existing comment was updated |
| `comment.deleted` | A comment was successfully deleted |


## Post events

### post.created

Triggered when a user or admin creates a new post (feedback, feature request, bug report, etc.).

**Payload includes:**

- `object: 'post'` - Type identifier
- Full post details (`title`, `content`, `status`, `boardId`)
- `author` object with user details
- Post metadata (`slug`, `createdAt`, `upvotes`)


### post.updated

Triggered when any field on a post is modified, including:

- Title or content changes
- Status changes (e.g., "In Review" → "Completed")
- Board changes
- Tag modifications


The `changes` array in the payload shows exactly what was modified. Field names use Nova conventions (e.g., `boardId`, `status`).

### post.deleted

Triggered when a post is permanently deleted from the system.

**Payload includes:**

- Full post details at the time of deletion
- `author` information


### post.voted

Triggered when a user upvotes or removes their upvote from a post.

**Payload includes:**

- `object: 'post_vote'` - Type identifier
- `action`: Either `"add"` or `"remove"`
- `postId`: The post ID that was voted on
- `voter`: The user who voted (either `{ object: 'admin', ... }` or `{ object: 'contact', ... }`)


## Changelog events

### changelog.published

Triggered when a changelog entry is published (made live).

**Payload includes:**

- `object: 'changelog'` - Type identifier
- Full changelog details (`title`, `content`, `featuredImage`)
- Locale information
- `firstPublishInLocale`: Whether this is the first publish in this locale
- `categories` array with notification settings


## Comment events

### comment.created

Triggered when a new comment is posted on any post.

**Payload includes:**

- `object: 'comment'` - Type identifier
- Comment content and metadata
- `author` object with user information
- `postId`: Parent post reference
- `parentCommentId`: For replies, the parent comment ID (flat structure)
- `isPrivate`: Privacy setting


### comment.updated

Triggered when a comment's content is modified.

**Payload includes:**

- Updated comment content
- The `changes` array showing what was modified


### comment.deleted

Triggered when a comment is permanently deleted.

**Payload includes:**

- Full comment details at the time of deletion


## Nova field naming conventions

Nova webhooks use the standardized API field naming:

| Resource | Key Fields |
|  --- | --- |
| Post | `boardId`, `status`, `author`, `tags`, `isPinned`, `createdAt`, `updatedAt` |
| Comment | `postId`, `parentCommentId`, `author`, `isPinned` |
| Vote | `postId`, `voter` (with `object: 'admin'` or `object: 'contact'`) |
| Changelog | `categories` (not `changelogCategories`) |


## Next steps

- **Handler examples** - Code examples for processing webhooks