Getting Started with Guru's Webhook Services

Guru has created webhooks services for facilitating realtime server to server notifications between Guru and separate services. Guru's Webhooks work by allowing you to subscribe to events which are generated by Guru. You can include the specific url in your subscription to which the events will be delivered as they are generated (i.e. webhooks are a form of "push based" interaction, which makes them reasonably realtime).

In order to receive events, you must have a functioning webserver. If you do not have access to a funtioning webserver, you can build your own webhooks using an iPaaS provider or leverge our Zapier or Workato app directly.

📘

Webhook Limit

The current webhooks subscription limit is allowing individual users to create up to 25 different webhook subscriptions. If you have any questions around our webhook limits, please reach out to [email protected].

List of Guru Events

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

• alert-read when a user clicks on 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 Board within a Collection

• board-updated a user edited an existing Board within a Collection

• board-to-pdf a user downloads a board as a PDF

• board-deleted a user deleted an existing Board within a Collection

• board-viewed a user viewed an existing Board within a Collection

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

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

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

• card-comment-reopened a user reopens 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 either copied the content within the card or clicked on the "Card Copied content" button while viewing a card

• card-copied-tracking

• card-created a new card as been published

• card-deleted a card has been archived

• card-favorited a user clicked the heart icon to add the card to their card 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 on 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 copies the link of a synced card

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

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

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

• card-unfavorited a user removed a card from their "My Favorite Card" list

• card-unshared a collaborator is removed from a card

• card-updated a user made edits to a card

• card-verified a user has verified a card

• card-viewed a user clicked & viewed a card

• collection-created a user created a collection

• collection-deleted a user deleted a collection

• collection-exported a user exports a collection

• draft-created a user created a card draft

• draft-deleted a user deleted a card draft

• login - a user logs into Guru's webapp

• 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-deleteda 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 when a new user is added to your team

• team-member-removed when a user is removed from your team

• usergroup-created - a Group is created

• usergroup-deleted - a Group is deleted

• usergroup-member-added - a user is added to a Group

• usergroup-member-deleted - a user is removed from a Group

Webhook Methods

• Creating a Webhook
• Recieving a Webhook
• Updating a Webhook
• Testing & Monitoring Webhooks
• Deleting a Webhook

Roles & Permissions

The events you have access to are based on your username's Guru Role & Permissions. Please see the chart below to understand what events you can subscribe to directly (Yes indicates the role has access to subscribe to the specified Activity type while No indicates you cannot subscribe the the specified Activity type and will get a 400 error).

Have any questions? Please email [email protected] for help.