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-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
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).
Activity Types | Admin | Collection Owner | Author | Read Only |
---|---|---|---|---|
alert-read | Yes | Yes | Yes | No |
api-token-created | Yes | No | No | No |
api-token-deleted | Yes | No | No | No |
board-created | Yes | Yes | Yes | No |
board-deleted | Yes | Yes | Yes | No |
board-to-pdf | Yes | Yes | Yes | No |
board-updated | Yes | Yes | Yes | No |
board-viewed | Yes | Yes | Yes | No |
card-to-pdf | Yes | Yes | Yes | No |
collection-exported | Yes | Yes | Yes | No |
draft-created | Yes | Yes | Yes | No |
draft-deleted | Yes | Yes | Yes | No |
card-added-to-board | Yes | Yes | Yes | Yes |
card-comment-created | Yes | Yes | Yes | Yes |
card-comment-deleted | Yes | Yes | Yes | Yes |
card-comment-reopened | Yes | Yes | Yes | Yes |
card-comment-resolved | Yes | Yes | Yes | Yes |
card-comment-updated | Yes | Yes | Yes | Yes |
card-copied | Yes | Yes | Yes | No |
card-copied-tracking | Yes | Yes | Yes | No |
card-created | Yes | Yes | Yes | Yes |
card-deleted | Yes | Yes | Yes | Yes |
card-favorited | Yes | Yes | Yes | No |
card-file-link-copied | Yes | Yes | Yes | No |
card-file-link-viewed | Yes | Yes | Yes | No |
card-link-copied | Yes | Yes | Yes | No |
card-link-viewed | Yes | Yes | Yes | No |
card-restored | Yes | Yes | Yes | Yes |
card-shared-to-team | Yes | No | No | No |
card-sync-link-copied | Yes | Yes | Yes | No |
card-unfavorited | Yes | Yes | Yes | No |
card-unshared | Yes | Yes | Yes | No |
card-updated | Yes | Yes | Yes | Yes |
card-verification-interval | Yes | Yes | Yes | Yes |
card-verified | Yes | Yes | Yes | Yes |
card-viewed | Yes | Yes | Yes | No |
collection-created | Yes | Yes | Yes | No |
collection-deleted | Yes | Yes | Yes | No |
login | Yes | No | No | No |
question-answered | Yes | Yes | Yes | Yes |
question-created | Yes | Yes | Yes | Yes |
question-deleted | Yes | Yes | Yes | Yes |
tag-category-created | Yes | Yes | Yes | No |
tag-category-deleted | Yes | Yes | Yes | No |
tag-category-merged | Yes | Yes | Yes | No |
tag-category-updated | Yes | Yes | Yes | No |
tag-created | Yes | Yes | Yes | No |
tag-deleted | Yes | Yes | Yes | No |
tag-merged | Yes | Yes | Yes | No |
tag-updated | Yes | Yes | Yes | No |
team-member-added | Yes | No | No | No |
team-member-removed | Yes | No | No | No |
usergroup-created | Yes | No | No | No |
usergroup-deleted | Yes | No | No | No |
usergroup-member-added | Yes | No | No | No |
usergroup-member-deleted | Yes | No | No | No |
Have any questions? Please email [email protected] for help.
Updated 11 months ago