> ## 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.

# API Token

> Connect Parable to Monday.com using an API token

export const platform_1 = "Monday.com"

export const limit_0 = "complexity-based; limit varies by plan (e.g. 10,000,000 complexity points/minute)"

export const platform_0 = "Monday.com"

export const role_0 = undefined

export const tokenName_0 = "API token"

<Tabs>
  <Tab title="Setup">
    <Card title="What You'll Need" icon="key">
      | Credential    | What it is                         |
      | ------------- | ---------------------------------- |
      | **API Token** | Personal API token from Monday.com |
    </Card>

    ## Overview

    Connect Parable to Monday.com for boards, items, and teams using the GraphQL API.

    <CardGroup cols={2}>
      <Card title="Boards & Items" icon="table">
        Boards, groups, items, columns
      </Card>

      <Card title="Users & Teams" icon="users">
        Workspace members, teams
      </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>

    * Any account member can generate a personal token
    * Token inherits your user permissions (admin token recommended for full access)

    ## Setup Guide

    <Steps>
      <Step title="Access Developer Section">
        1. Log in to Monday.com
        2. Click your avatar → **Developer**
        3. Select **My access tokens**
      </Step>

      <Step title="Generate Token">
        1. Click **Show** to reveal your token
        2. Or click **Regenerate** to create a new one

        <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 Token Permissions">
        The token inherits permissions of your user account:

        * **Admins** can access all boards and data
        * **Members** only access boards they're subscribed to

        <Tip>
          For comprehensive access, use an admin account.
        </Tip>
      </Step>

      <Step title="Enter values in the form">
        1. **API Token**: Paste your Monday.com personal API token.
        2. Enter any other required fields shown in the form.
        3. Click **Save & test connection**.
      </Step>
    </Steps>
  </Tab>

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

    <CodeGroup>
      ```bash Test with GraphQL theme={null}
      curl -X POST "https://api.monday.com/v2" \
        -H "Authorization: YOUR_TOKEN" \
        -H "Content-Type: application/json" \
        -d '{"query": "{ me { id name email } }"}'
      ```

      ```bash List Boards theme={null}
      curl -X POST "https://api.monday.com/v2" \
        -H "Authorization: YOUR_TOKEN" \
        -H "Content-Type: application/json" \
        -d '{"query": "{ boards(limit: 5) { id name } }"}'
      ```
    </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>

    ## GraphQL Examples

    <Accordion title="Query Boards with Items">
      ```graphql theme={null}
      query {
        boards(limit: 10) {
          id
          name
          state
          items_page {
            items {
              id
              name
              column_values {
                id
                value
              }
            }
          }
        }
      }
      ```
    </Accordion>

    <Accordion title="Query Users">
      ```graphql theme={null}
      query {
        users {
          id
          name
          email
          is_admin
          created_at
        }
      }
      ```
    </Accordion>

    ## Troubleshooting

    | Error                 | Meaning               | Solution                |
    | --------------------- | --------------------- | ----------------------- |
    | `Not Authenticated`   | Invalid token         | Verify token is correct |
    | `Unauthorized`        | No access to resource | Check user permissions  |
    | `ComplexityException` | Query too complex     | Reduce query complexity |

    <Accordion title="Common Issues">
      ### Query complexity exceeded

      Monday.com limits query complexity. Break large queries into smaller batches.

      ### Can't see some boards

      Token access is limited to boards the user can access. Use an admin account for full access.
    </Accordion>

    ## Additional Resources

    <CardGroup cols={2}>
      <Card title="Monday.com API" icon="book" href="https://developer.monday.com/api-reference/">
        Official API documentation
      </Card>

      <Card title="GraphQL Playground" icon="code" href="https://monday.com/developers/v2/try-it-yourself">
        Test queries interactively
      </Card>
    </CardGroup>
  </Tab>
</Tabs>