Skip to content
Last updated

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 to get notified when they are released.

Available topics

TopicDescription
post.createdA new post was created
post.updatedAn existing post was updated
post.deletedA post was successfully deleted
post.votedA post received a vote
changelog.publishedA new changelog entry was published
comment.createdA new comment was created
comment.updatedAn existing comment was updated
comment.deletedA 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:

ResourceKey Fields
PostboardId, status, author, tags, isPinned, createdAt, updatedAt
CommentpostId, parentCommentId, author, isPinned
VotepostId, voter (with object: 'admin' or object: 'contact')
Changelogcategories (not changelogCategories)

Next steps

  • Handler examples - Code examples for processing webhooks