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

# Tokens

> How to create a Token in the Dashboard

To use Poix API endpoints to get data, you'll need a Token, such keys works in a scope of one project. You can create the Token in the Tokens page in [Dashboard](https://app.poix.io/tokens) or using API [endpoint](/internal-api/tokens/create-token).

## How to create a token

<Steps>
  <Step title="Open Dashboard">
    Go to the [Tokens](https://app.poix.io/tokens) page in the Dashboard.
  </Step>

  <Step title="Click on 'Add token' button">
    Click on the 'Add token' button to create a new token.
  </Step>

  <Step title="Specify name for your new token">
    <Frame>
      <img className="block dark:hidden" src="https://mintcdn.com/poix-a0bff09f/JfolOoh6sFUQi7Po/images/create-token-modal-light.webp?fit=max&auto=format&n=JfolOoh6sFUQi7Po&q=85&s=68c15af70ea714527fed29204f524108" alt="Create token with rate limits" width="3456" height="1984" data-path="images/create-token-modal-light.webp" />

      <img className="hidden dark:block" src="https://mintcdn.com/poix-a0bff09f/JfolOoh6sFUQi7Po/images/create-token-modal-dark.webp?fit=max&auto=format&n=JfolOoh6sFUQi7Po&q=85&s=01683c5aa0cb901b3ec38ee8362dafaf" alt="Create token with rate limits" width="3456" height="1983" data-path="images/create-token-modal-dark.webp" />
    </Frame>

    Specify the name for your new token. It will help you to identify the token later.
  </Step>

  <Step title="Copy newly generated secret key">
    <Frame>
      <img className="block dark:hidden" src="https://mintcdn.com/poix-a0bff09f/JfolOoh6sFUQi7Po/images/create-token-secret-modal-light.webp?fit=max&auto=format&n=JfolOoh6sFUQi7Po&q=85&s=242e9c8de22f16e1b10a3e6b449ef2b4" alt="Hero Light" width="3456" height="1983" data-path="images/create-token-secret-modal-light.webp" />

      <img className="hidden dark:block" src="https://mintcdn.com/poix-a0bff09f/JfolOoh6sFUQi7Po/images/create-token-secret-modal-dark.webp?fit=max&auto=format&n=JfolOoh6sFUQi7Po&q=85&s=34962d84fc01a4a13faa64cdbc1bea32" alt="Hero Dark" width="3456" height="1983" data-path="images/create-token-secret-modal-dark.webp" />
    </Frame>

    Once token is created, you will see the secret key. You can copy it and use in your requests.
  </Step>
</Steps>

That's it! Keep it safe and don't share it with anyone. If you think your key has been compromised, you can always regenerate it.

## Example

If you created token with secret key `poix-Q2jffUdt6dlG0Jb2UnB`, use it in your requests like this:

```bash theme={null}
curl --request GET \
  --url https://api.poix.io/search?q=cats \
  --header 'Authorization: Bearer poix-Q2jffUdt6dlG0Jb2UnB'
```