> ## Documentation Index
> Fetch the complete documentation index at: https://honeydew.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# ThoughtSpot API Integration

To publish domains from Honeydew to ThoughtSpot, Honeydew connects to the ThoughtSpot REST API.
Honeydew authenticates with a **Username** and a **Secret Key**, using
[trusted authentication](https://developers.thoughtspot.com/docs/trusted-auth) to obtain a
session token.

This builds on the Honeydew data warehouse connection in ThoughtSpot.

## API Access Setup

<Steps>
  <Step title="Obtain a secret key in ThoughtSpot">
    1. Sign in to ThoughtSpot as an administrator.

    2. Enable trusted authentication and copy the generated secret key.
       See [ThoughtSpot's trusted authentication documentation](https://developers.thoughtspot.com/docs/trusted-auth)
       for the steps, which differ between ThoughtSpot versions.

    3. Choose the ThoughtSpot user that Honeydew acts as, and note its username.

           <Note>
             The user must be allowed to create and update tables, and must have access to the
             [Honeydew data warehouse connection](/docs/integration/bi-tools/thoughtspot#setting-up-a-new-data-warehouse-connection)
             in ThoughtSpot.
           </Note>

    4. Note your ThoughtSpot domain — the URL of your instance
       (for example `https://my-team.thoughtspot.cloud`).
  </Step>

  <Step title="Configure Honeydew with the credentials">
    1. Sign in to Honeydew with a user that has administrator privileges.
    2. Open the user settings menu.
    3. Navigate to **ThoughtSpot** → **Settings**.
    4. Enter the following information:

       * **Domain** — your ThoughtSpot domain (for example `https://my-team.thoughtspot.cloud`)
       * **Username** — the ThoughtSpot user that Honeydew acts as
       * **Secret Key** — the secret key generated in the previous step
  </Step>
</Steps>

Once API access is set up, you can publish a Honeydew domain to ThoughtSpot as a table.
See [Metadata Sync](/docs/integration/bi-tools/thoughtspot#metadata-sync) for the properties Honeydew
syncs, and [ThoughtSpot-specific Metadata](/docs/integration/bi-tools/thoughtspot#thoughtspot-specific-metadata)
for field formatting.