---
schema_version: "1"
id: 877a14be0b8c9b8d514ccd083ba87cb5402020d627429bfe0cd5a4ae686b4122
title: Prepare for a Guru Connection
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/data-cloud/data-cloud-int/guides/guru/c360-a-prepare-your-guru-connection.md
canonical_url: https://developer.salesforce.com/docs/data/data-cloud-int/guide/c360-a-prepare-your-guru-connection.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: ec737a7297224fa5b4a30aee5fa674a13b8d1ac476a94fba3993fb1e2f3355fc
products:
  - Data 360 Integration Guide
  - Data 360 Developer Documentation
---
# Prepare for a Guru Connection

Before you ingest your Guru cards to Data 360, you need to provide
some details. Consult with your organization's Guru Admin or gather
the following information before you get started.

There are two ways to authenticate:

- User Token, which requires a User Email
- Collection Token, which requires a Collection ID

Consult with your Guru admin about which authentication process
to use and collect the relevant information.

## Authentication Requirements for User Tokens

If you're using the user token method of authentication complete all the steps in this section. If not, skip to the Collection Tokens section.

### Generate a User Token

The following instructions are also available at [Guru's help site](https://help.getguru.com/s/article/how-to-obtain-your-api-credentials).

To generate your user token:

1. Navigate to the **Apps & Integrations** page under the **Team Settings** menu.
2. Click on the **API Access** tab to manage your tokens.
3. Generate an API token for yourself by selecting **Generate User Token** and entering your name. Click **Generate token** and the token appears.
4. Click **Copy** to copy the token. Save it in a safe place because you will **not** see it again.

**note:** Once the token has been generated, you **can't** access it **again**. Save it in a safe place. If you need to regenerate the token, you must reconfigure all connectors associated with this token with the new token information.

### Obtain a User Email

For this step, you need the email address associated with the Guru account and Guru collection you want to ingest. Get the email address from the Guru administrator if you don’t know it.

## Authentication Requirements for Collection Tokens

If you're using the collection token method of authentication complete all the steps in this section. If not, skip to the User Tokens section.

### Find your Guru Collection ID

1. Log in to Guru at [https://app.getguru.com/](https://app.getguru.com/).
2. If you don’t have one, create a collection.
3. From the **Collections** menu, find the collection you are interested in uploading. Alternatively, ask your Guru manager for the URL to the Guru collection you want to use.
4. Even if you want to focus on a specific folder in the Guru collection, you still need the ID and collection name. The structure of a Guru URL is similar to
   `https://app.getguru.com/collections/ID/CollectionName`. Note at the end of the URL is `ID/CollectionName`.
   Make sure to **copy only** this information and **not** the entire URL.

### Create a Collection Token

To use collection token authentication, you need to generate a collection token as described in [Guru's documentation](https://help.getguru.com/docs/gurus-api#obtaining-a-collection-token).

1. In Guru, go to the [API Access](https://app.getguru.com/settings/integrations/api-access) tab.
2. Select **Generate a New Collection Token**.
3. Select the desired Collection from the dropdown list.
4. Select **Generate Token**. Your token appears in the field.

**note:** Once the token has been generated, you **can't** access it **again**. Save it in a safe place. If you need to regenerate the token, you must reconfigure all connectors associated with this token with the new token information.

## Add Tags to Guru Content

If your Guru cards are tagged, you can use the tags as filters,
selecting the cards you want to ingest.
Learn more about how to apply tags to your Guru [cards](https://help.getguru.com/s/article/adding-a-tag-to-a-card).
When your collection content is uploaded, and you specify a list of tags any card
tagged with any of the matching tags is included.

## Find Folder Names

When creating your Guru structure, Guru collections often have folders to
aid in the organizational hierarchy of your knowledge base.
If you're using folders, add the folder names for the folders you want to
include. See [Managing folders in Guru](https://help.getguru.com/docs/creating-and-managing-folders-in-guru) for more information about creating folders.
Create a list of folder names in the following format:
`CollectionName/foldername`.

Proceed to [Set Up a Guru Connection](https://developer.salesforce.com/docs/data/data-cloud-int/guide/c360-a-set-up-guru-connection.md).

## Next Step

- [Set Up a Guru Connection](https://developer.salesforce.com/docs/data/data-cloud-int/guide/c360-a-set-up-guru-connection.md)
