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

# Personal Access Token

> Connect Parable to Tableau using a personal access token

export const platform_1 = "Tableau"

export const limit_0 = "varies; monitor response headers"

export const platform_0 = "Tableau"

export const role_0 = undefined

export const tokenName_0 = "token secret"

<Tabs>
  <Tab title="Setup">
    <Card title="What You'll Need" icon="key">
      | Credential       | What it is                                                                |
      | ---------------- | ------------------------------------------------------------------------- |
      | **Token Name**   | PAT identifier                                                            |
      | **Token Secret** | PAT secret value                                                          |
      | **Site Name**    | Tableau site content URL slug (from your site URL)                        |
      | **Base URL**     | Tableau Server/Cloud URL (e.g., `https://yourcompany.online.tableau.com`) |
    </Card>

    ## Overview

    Connect Parable to Tableau Server or Tableau Cloud for BI analytics and usage data.

    <CardGroup cols={2}>
      <Card title="Content" icon="chart-bar">
        Workbooks, dashboards, data sources
      </Card>

      <Card title="Usage & Users" icon="users">
        View activity, user profiles
      </Card>
    </CardGroup>

    ## Prerequisites

    <Info>
      **Setup access in {platform_0}.** These steps require **{role_0}**, or a colleague with equivalent permissions who can create credentials for you.

      If that is not you, ask your {platform_0} administrator.
    </Info>

    * **Site Administrator** role (for full access)
    * Personal Access Tokens enabled on your site

    ## Setup Guide

    <Steps>
      <Step title="Access Account Settings">
        1. Log in to Tableau Server/Cloud
        2. Click your avatar → **My Account Settings**
        3. Navigate to **Personal Access Tokens** section
      </Step>

      <Step title="Create Personal Access Token">
        1. Enter a token name: `Parable Integration`
        2. Click **Create new token**
        3. Copy both:
           * **Token name**
           * **Token secret**

        <Warning>
          **Copy your {tokenName_0} now!**

          This is the only time it will be displayed. Store it in a secure password manager before closing this page.
        </Warning>
      </Step>

      <Step title="Note Your Server Details">
        | Detail    | Example                                                                              |
        | --------- | ------------------------------------------------------------------------------------ |
        | Base URL  | `https://yourcompany.online.tableau.com` or `https://tableau.yourcompany.com`        |
        | Site Name | `site-name` (the content URL slug from your site URL, or empty for the default site) |
      </Step>

      <Step title="Enter values in the form">
        1. Enter **Server URL**, **Site name**, **Token name**, **Token secret**, and any other fields shown in the form.
        2. Click **Save & test connection**.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Reference">
    ## Verify Your Setup

    <CodeGroup>
      ```bash Sign In (Get Auth Token) theme={null}
      curl -X POST "https://YOUR_SERVER/api/3.19/auth/signin" \
        -H "Content-Type: application/json" \
        -d '{
          "credentials": {
            "personalAccessTokenName": "YOUR_TOKEN_NAME",
            "personalAccessTokenSecret": "YOUR_TOKEN_SECRET",
            "site": {
              "contentUrl": "YOUR_SITE_NAME"
            }
          }
        }'
      ```

      ```bash Test API (with auth token from sign-in) theme={null}
      curl -H "X-Tableau-Auth: YOUR_AUTH_TOKEN" \
        "https://YOUR_SERVER/api/3.19/sites/YOUR_SITE_NAME/users"
      ```
    </CodeGroup>

    <Check>
      **Success!** If you received a `200 OK` response with valid data, your credentials are configured correctly. You can now proceed to configure this connector in Parable.
    </Check>

    <Tip>
      **Rate Limits:** {platform_1} enforces rate limits of **{limit_0}**.

      Parable handles rate limiting automatically with exponential backoff, but initial syncs of large datasets may take longer due to these limits.
    </Tip>

    ## Troubleshooting

    | Error                | Meaning                  | Solution                     |
    | -------------------- | ------------------------ | ---------------------------- |
    | `401 Unauthorized`   | Invalid credentials      | Verify token name and secret |
    | `403 Forbidden`      | Insufficient permissions | Check user site role         |
    | `404 Site not found` | Wrong site name          | Verify site content URL      |

    <Accordion title="Common Issues">
      ### PATs disabled

      Personal Access Tokens must be enabled by a server admin. Contact your Tableau administrator.

      ### Wrong API version

      Check your Tableau Server version and use a compatible API version in the URL path.
    </Accordion>

    ## Additional Resources

    <CardGroup cols={2}>
      <Card title="Tableau REST API" icon="book" href="https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api.htm">
        Official API documentation
      </Card>
    </CardGroup>
  </Tab>
</Tabs>