Skip to main content

Connecting to Guru

When connecting their Guru account through Paragon Connect, your users pick one of two authentication methods:
  • Guru User Token - Uses the user’s Guru username and API Token to authenticate.
  • Guru Collection Token - Uses a Guru Collection ID and Collection Token to authenticate.
Paragon prompts for the credentials that match the option they choose.
This is an API-only integration - workflow actions for this integration are still in development. You can still connect user accounts, build workflows, and access the API for this integration.
Once your users have connected their Guru account, you can use the Paragon SDK to access the Guru API on behalf of connected users. See the Guru Developer Network for their full API reference. Any Guru API endpoints can be accessed with the Paragon SDK as shown in this example.
// You can find your project ID in the Overview tab of any Integration

// Authenticate the user
paragon.authenticate(<ProjectId>, <UserToken>);
            
// List teams
await paragon.request("guru", "teams", {
  method: "GET"
});

// Get a card with extended metadata
await paragon.request("guru", "cards/<id>/extended", {
  method: "GET"
});

// Search cards
await paragon.request("guru", "search/query?searchTerms=<terms>&maxResults=10", {
  method: "GET"
});
  

Building Guru workflows

Once your Guru account is connected, you use the Guru Request step to access any of Guru’s API endpoints without the authentication piece. When creating or updating records in Guru, you can reference data from previous steps by typing {{ to invoke the variable menu.