Webhooks Overview

Guru's webhooks deliver real-time, server-to-server notifications when events happen in your Guru instance. You subscribe to the events you care about and provide a URL, and Guru pushes events to that URL as they're generated.

To receive events, you need a functioning web server. If you don't have one, you can build your own webhooks using an iPaaS provider or use our Zapier or Workato apps directly.

📘

Webhook limit

Each user can create up to 25 webhook subscriptions. If you have questions about webhook limits, contact [email protected].

Guru events

📘

Legacy board naming

Some folder-related event names still reference "boards." These event names and their underlying field values were not updated during the transition from boards to folders because existing external integrations rely on the exact values. The naming remains for backward compatibility, but the events apply to folders.

Below is the list of Guru events you can subscribe to:

• alert-read a user clicks the "I read it" button in an Announcement

• api-token-created a user was issued a User or Collection API token

• api-token-deleted a user deleted a User or Collection API token

• board-created a user created a new folder within a collection

• board-updated a user edited an existing folder within a collection

• board-to-pdf a user downloaded a folder as a PDF

• board-deleted a user deleted an existing folder within a collection

• board-viewed a user viewed an existing folder within a collection

• card-added-to-board a user added a card to a folder

• card-comment-created a user commented on a card

• card-comment-deleted a user deleted a comment on a card

• card-comment-reopened a user reopened a resolved comment on a card

• card-comment-resolved a user resolved a card comment

• card-comment-updated a user edited a card comment

• card-copied a user copied the content within a card or clicked the "Card Copied content" button while viewing a card

• card-copied-tracking

• card-created a new card has been published

• card-deleted a card has been archived

• card-favorited a user clicked the heart icon to add the card to their favorites list

• card-file-link-viewed a user viewed a link to a file that is uploaded to a card and displayed in the card's file viewer

• card-link-copied a user clicked the "Card Copy link" button while viewing a card

• card-link-viewed a user viewed a card from the "Card Copy link" button URL

• card-restored a user restored a card from the archives

• card-sync-link-copied a user copied the link of a synced card

• card-unfavorited a user removed a card from their favorites list

• card-shared-to-team a user made a private card team shared or created a new card that is team shared

• card-to-pdf a user downloaded a card as a PDF

• card-unshared a collaborator was removed from a card

• card-updated a user made edits to a card

• card-verified a user verified a card

• card-viewed a user clicked and viewed a card

• collection-created a user created a collection

• collection-deleted a user deleted a collection

• collection-exported a user exported a collection

• draft-created a user created a card draft

• draft-deleted a user deleted a card draft

• login a user logged into Guru's web app

• question-answered a user answered a question in the "Ask the Experts" feature

• question-created a user created a question in the "Ask the Experts" feature

• question-deleted a user deleted a question in the "Ask the Experts" feature

• tag-category-created a user created a tag category

• tag-category-deleted a user deleted a tag category

• tag-category-merged a user merged a tag category with another tag category

• tag-category-updated a user updated a tag category

• tag-created a user created a tag

• tag-deleted a user deleted a tag

• tag-merged a user merged a tag with another tag

• tag-updated a user updated a tag

• team-member-added a new user was added to your team

• team-member-removed a user was removed from your team

• usergroup-created a group was created

• usergroup-deleted a group was deleted

• usergroup-member-added a user was added to a group

• usergroup-member-deleted a user was removed from a group

Webhook guides

• Creating a Webhook
• Receiving a Webhook Event
• Updating a Webhook
• Testing & Monitoring a Webhook
• Deleting a Webhook

Roles and permissions

The events you have access to are based on your username's Guru role and permissions. The chart below shows which events each role can subscribe to. Yes indicates the role can subscribe to the activity type; No indicates it cannot, and subscribing returns a 400 error.

Have questions? Email [email protected].