API & Integrations

Discuss the Guru API, Zapier and Workato workflows, and integrations with Guru

  • 83 Posts
  • 287 Replies

83 Posts

Callie Rojewski
Callie RojewskiGenius
posted in API & Integrations

Automating Guru tasks with Zapier: how to get started?

Hey everyone! In the spirit of next week’s Guru Deep Dive, I want to talk through tips and tricks when it comes to automating Guru tasks. Yesterday, a group of us were brainstorming ways to use Guru’s Zapier and Workato integrations, and it inspired me to think through ways I could automate Guru tasks I manage in my day-to-day role. There are soo many possibilities to think of, so to get started, I listed out my top challenges.  Challenges → What am I doing manually, that there could be a workaround for? Is there a way to get notifications to manage tasks in a place I’m already going for project management or looking on a day-to-day basis?  I then explored workflows by mapping:The trigger (the first activity) The action (the correlated activity) The end resultFor example, I set up a workflow for card verification. If I’m being fully transparent I’m probably not the best at keeping my cards verified as soon as they expire  I AM good at checking slack though, so I set up a Zapier to send

1
Sarah W
1 year ago
A
Anonymous
posted in API & Integrations

If you could wave a magic wand, what Guru-related process would you automate?

We’re excited to host a Guru Community AMA (ask me anything) on Aug. 18th with @Mary Houston (Sr. Manager, Developer Advocate) and @Jon Saft (Product Manager, Bots & Integrations), where you can get any and all of your questions answered about the Guru API, webhooks, and Workato/Zapier automations.Here are some questions to get your wheels turning (share your thoughts below!)…If you could wave a magic wand, what Guru-related workflow process would you automate? What manual process do you manage now that you’d love to automate? What about the Guru API, iPaaS (Zapier/Workato) integrations, or webhooks feels confusing or out of reach?

4
A
1 year ago
Mary Houston
Mary HoustonScholar
posted in API & Integrations

Early access beta program for Zapier and Workato Guru integrations

:wave: Hi Everyone, We have been listening to this community and the need for workflow integrations (From @zev's request to @dillon's integration comment). Based on this feedback, we would like to invite any of our community members to participate in our *early-access Beta Program of Guru's Zapier and Workato apps*. This will be a 4 week program (starting Feb 15 and wrapping up March 12) that will give you access to Guru's Beta Zapier or Workato connectors so you can build triggers around certain Guru activity or manage action items to create new cards or add users to Guru in an automated workflow. Prerequisites for participating in this 4 week Beta Program: 1. Must have access to a Zapier or Workato account (Zapier also offers a Free version if you are eager to participate) 2. Must have access to a Guru API User Token that has Admin permissions 3. Willing to provide frequent feedback to ensure we are improving our connectors If you have a Workato or Zapier account and are interested i

12
Callie Rojewski
1 year ago
Devon O'Dwyer
Guru Employee
Devon O'DwyerGuru Employee
published in API & Integrations

How to create an API & Integrations post

Welcome! The API & Integrations category is the best place for you to ask questions about the Guru API, webhooks, Zapier and Workato workflows, and integrations with Guru. Here are some tips on posting in the API & Integrations category: Search before you post We recommend doing a quick search to see if your question has been answered before you post. If there’s an open relevant discussion, feel free to add a comment to continue the conversation! What kinds of posts should I make?Questions about how you can use our Guru API, for example:  How can I use the API to move Cards from one Collection to another?  Has anyone piped API data to Tableau?  Is it possible to get a list of all users who have modified a Card? Questions about what kinds of automated workflows you can create with Zapier and WorkatoMark a question as a best answerIf you ask a question and receive an informative answer, feel free to mark it as a best answer to help others in the community moving forward!

1220
Devon O'Dwyer
Guru Employee
1 year ago
Joshua Ordehi
Joshua OrdehiKnewbie
posted in API & Integrations

Issue querying Card IDs

Hello again! I've been happily querying card IDs for a few days, but now ran into this issue: > Exception: Request failed for https://api.getguru.com returned code 400. Truncated server response: { "description" : "Invalid paging token" } (use muteHttpExceptions option to examine full response) (line 36). When I follow the pagination token URL on the browser it works, logging it also gives me a working token. The call I'm making is using only the Card ID, it breaks when it has to fetch the next page, I'm using the same code from the Google Sheet you shared but only modified it so cardId is added instead of dates.

4
Joshua Ordehi
1 year ago
Joshua Ordehi
Joshua OrdehiKnewbie
asked in API & Integrations

Getting a 500 error when querying the KCS endpoint

Hello! I'm trying to query Guru's KCS endpoint to get all Zendesk tickets linked to a specific card. When I use the `cardId` query, I don't get anything back, and usually a 500 error. However, if I remove`cardId` it works, only I get ALL cards which is not what I want. I've tried `cardId` using the slug (works when doing a call to search by ID but not KCS), and also using the card id property we get in the objects when calling KCS (this also gives me ALL cards). Here's an example test in curl curl -u UNAME:TOKEN https://api.getguru.com/api/v1/kcs?cardId=CARDID This works though curl -u UNAME:TOKEN https://api.getguru.com/api/v1/cards/CARDID/extended Am I doing something wrong? We're trialing Guru for issues and feedback, but we need a way to get all ZD tickets linked to a card for it to be of any use. The Spreadsheet Guru provides is cool, but while trying to introduce the `cardId` query, it's just giving me 500 errors even if the call is properly formatted. Has anyone built something

12
Siobhan
1 year ago
Hassan Muhammad
Hassan MuhammadScholar
asked in API & Integrations

Is there a way to automatically notify the card creator when a comment is posted..

Is there a way to automatically notify the card creator when a comment is posted without having to individually tag them? This would be similar to the functionality in Google Docs.

13
Hassan Muhammad
1 year ago
Siobhan
Siobhan
posted in API & Integrations

Has anyone piped any API data directly to Tableau?

Hi folks! Has anyone piped any API data directly to Tableau? I'm a bit out of my depth here and hoping to get some more info to share with some team members who have a bit more knowledge around this than I do.

2
Siobhan
1 year ago
E
Eric Knudsen
asked in API & Integrations

How can I auth in python using a Collection ID and Collection token?

Hi all! Having trouble understanding how to auth in python using a Collection ID and Collection token. I don't see any example code in documentation. Anyone able to help?

2
E
2 years ago
Siobhan
Siobhan
posted in API & Integrations

Is there a way to use the API to track the Zendesk Copy Link?

hi there! is there a way via API to tell how many times the "Z" button has been clicked (this is on cards from synced Zendesk collections.) ?

10
Siobhan
2 years ago
Nathan Anderson
Nathan AndersonKnewbie
posted in API & Integrations

How can I use the API to move Cards from one Collection to another?

Hi everyone! :wave: My team and I are doing a big organizational overhaul of our Guru instance that is going to involve changing up our collections, redoing our naming conventions, and setting up a new tagging system to make everything more scalable. I'm working on setting everything up so we can do this via the API when we're ready and am ALMOST there, but am running into some difficulties moving a card from one collection to another (with the API). Here's the JSON I'm sending to the Cards endpoint: ```//create JSON let json = { "tags":tags, "collection":{"id":collectionId}, "content": content, "shareStatus":"TEAM", "preferredPhrase":cardName };``` `collectionId` is a string, and exists in Guru. I'm getting a 200 response back from my PUT request, but the collection assigned to the card remains unchanged (all of the other elements update as expected). Is this because the card is already assigned to a Collection and a Board? Thanks for any pointers!

4
Nathan Anderson
2 years ago
murray
murray
posted in API & Integrations

Does anyone know if it's possible to create cards with an ExternalId?

Does anyone know if it's possible to create cards *via API* with an ExternalId? And then of course, update the same card in the future using that ExternalId? I'm trying to sync knowledge from another system but the file-based approach seems inefficient and will be much more difficult to implement...

5
murray
2 years ago
Marcos Perez
Marcos Perez
posted in API & Integrations

Why can we see how many times a Card viewed and read in Guru but only views in the API?

Hi everyone! I have a quick question: In Guru we can see for a card how many times it was viewed and read, but the API shows only views, without this differentiation. Which is the difference?

6
Dillon Head
2 years ago
Dillon Head
Dillon HeadScholar
posted in API & Integrations

Why does `verificationReasons` return an empty response for unverified Cards?

Can anyone tell me why `verificationReasons` from the cards endpoints (both https://api.getguru.com/api/v1/cards/some-card-id and https://api.getguru.com/api/v1/cards/slug) sometimes returns as an empty array for unverified cards? I have a script that checks for cards that are unverified due to being stale, usually referred to as "EXPIRED" in verificationReasons. Checking for expired works fine for most cards, but there are some instances where an expired card doesn't have this designation. I assume the information is coming from somewhere since the web app is able to render these cards as expired despite the empty array, but I'm not sure how. Can anyone point me in the right direction? Thanks for any help!

5
Mary Houston
2 years ago
Marcos Perez
Marcos Perez
posted in API & Integrations

How can I get all members in a group via the API?

Hello everyone! I know we can get the groups a member is in, but can't find the way to get all the members in a group via API, which is far more efficient. Is there anything I'm not finding in the API documentation?

4
Mary Houston
2 years ago
A
Anonymous
posted in API & Integrations

Has anyone used the API to do month over month card creation analysis?

Has anyone used the API to do MoM card creation analysis by chance? cc @leslie

0
A
2 years ago
Duc Bui Minh
Duc Bui Minh
posted in API & Integrations

How can I use the API to reference a Card in another Collection?

Hi team, I am using the sync API. Is there any solutions to reference to a card in another collection? https://developer.getguru.com/docs/guru-sync-manual-api#referencing-other-cards-boards-board-groups-and-resources

3
Mary Houston
2 years ago
Duc Bui Minh
Duc Bui Minh
posted in API & Integrations

How can I import Boards in order using the API?

Hi team, I am working with guru-sync-manual-api. Currently, I need to import boards in order. Is there any way to support for this problem?

5
Duc Bui Minh
2 years ago
Kristin Fretz
Kristin FretzSmart Cookie
posted in API & Integrations

How can I leverage Guru's API to help streamline our new hire onboarding experience?

Hey all! My IT team is considering joining my rollout of Guru to streamline our new hire onboarding experience. We have Okta, JIRA, Confluence and random Slide decks, so my idea is to use Guru, JIRA, Okta and possibly a synced Confluence collection (until I can convince them to move off Confluence entirely so the full company uses Guru). They love Slack's use case that mentions Guru so if any customers or current Guru employees have best practices or can chat live with us, we'd love to know the extent of Guru's API. Thanks! :blush:

6
Kristin Fretz
2 years ago
Dillon Head
Dillon HeadScholar
posted in API & Integrations

Is there a way for users to suspend verification requests whenever they update Cards?

Hey folks, I've seen this question asked here a couple of times and I also asked early on in our Guru implementation. Is there a way for users to suspend verification requests whenever they update cards? To my knowledge, there's currently no way to do this. I often need to make small changes to cards and I don't want to bother the verifier with what might be a simple formatting update or sentence rewrite. To get around this, you can use the API to impersonate those users and verify articles on their behalf. Assuming you're an admin (and your org is cool with you editing the content of others), you just generate a token for the verifier of the card and then post the card content using the token. This is only worth setting up if you make a lot of small changes to other users' cards, but just figured I'd mention here in case others had similar questions.

5
Mary Houston
2 years ago
Kristin Fretz
Kristin FretzSmart Cookie
posted in API & Integrations

Is it possible to auto-create a templated Card when something changes on a Salesforce record?

Hello Guru! Is it possible to auto-create a Guru card (using a Guru template) when something changes on a Salesforce record? I'm curious if there is a way to automate a "new merchant onboarding" Guru card after an Opportunity field in Salesforce is updated to closed won. Appreciate any insights!

13
Donovan Watts
2 years ago
Jonathan Aykroyd
Jonathan Aykroyd
posted in API & Integrations

Can I use the API to post new Guru Cards or new Knowledge Alerts in Discord?

Hi everyone :slightlysmilingface:, I hope y'all are having a great week so far. Our team is considering migrating part of their support operations to Discord (from Slack). I've been able to implement a Discord bot integration to handle searching guru cards, but I cannot find any functionality in the API that lets me listen to when *new cards* get created, or when *knowledge alerts* get sent out. Is there no way to do this using the current API? Our goal is to retain the most important functionality for us from the slack integration (namely searching and linking cards, setting up a new card feed and getting verify/knowledge alerts) when moving over to Discord. Is there any work around that I could use? Thanks in advance!

2
Jonathan Aykroyd
2 years ago
Mary Houston
Mary HoustonScholar
posted in API & Integrations

How Jon Peck from Github built a migration tool from Github into Guru using the API

Happy :fallenleaf: Autumnal Equinox :fallenleaf: - Time to give gratitude and start fresh! In the spirit of fresh starts, why not start that custom sync project you have been wanting to do :eyes:? Jon Peck from GitHub recently shared with us how he built a *reusable migration tool from their Sales Enablement team's GitHub repository into Guru*. His initial MVP took *~2 days* and he also posted his Github to Guru action for the Guru Community to use! Since building this sync, Guru has given his team a single place where they can store and maintain all reference material relevant to their sales process. Learn more about Jon's project here. Do you have any external content sources that you want to sync into Guru but are not currently available via the Knowledge Sync feature? Are there any roadblocks in using Guru's API to build that sync for you and your team? Feel free to share in the thread!

1
A
2 years ago
R
Ruairi MurphyKnewbie
posted in API & Integrations

Using the API to pull all Cards from Guru but getting a time out error

Hey folks, we're trying to leverage the API to pull all cards in our knowledge base as we're building a find&replace MVP. We're using the search endpoint with a blank query to list all cards but it appears to be timing out. It stops printing at 8952 cards and that figure doesn't appear to bear any significance. Would you be able to shed any light on why that might be the case? I'll thread the code for reference.

5
R
2 years ago
kelly
kellyScholar
posted in API & Integrations

Is anyone using the API to sync JIRA into Guru?

Hey all! is anyone api-ing JIRA into their guru instance? We are looking to have a single source of truth in regards to product information!

5
A
2 years ago

Badge winners

See all badges
Terms & ConditionsCookie settings