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

# Get Credentials

> How to obtain and configure your Vercel Access Token and Webhook Secret.

## Vercel Access Token

To authenticate with the Vercel API, you need a Personal Access Token or a Team Access Token.

<Steps>
  <Step title="Go to Vercel Settings">
    Log in to your Vercel dashboard and navigate to **Settings** > **Tokens**.
  </Step>

  <Step title="Create a new token">
    Click the **Create Token** button. Give it a descriptive name (e.g., "Corsair Integration").
  </Step>

  <Step title="Select Scope">
    Choose the appropriate scope for your token. You can select **Full Account** for access to all personal projects, or select a **Specific Team** if you want to limit access to a team's resources.
  </Step>

  <Step title="Copy the token">
    Copy the generated token immediately, as you won't be able to see it again.
  </Step>
</Steps>

### Storing the token

Once you have your token, store it using the Corsair CLI:

```bash theme={null}
pnpm corsair setup --plugin=vercel api_key=your_vercel_token
```

## Securing Webhooks (Optional)

If you configure Vercel webhooks to point to your Corsair endpoint, it is highly recommended to set a Webhook Secret to verify incoming payloads.

1. When you create a webhook in Vercel, it will provide a **Secret**.
2. Pass this secret directly when initializing the Vercel plugin:

```ts corsair.ts theme={null}
import { vercel } from '@corsair-dev/vercel';

export const corsair = createCorsair({
    plugins: [
        vercel({
            webhookSecret: process.env.VERCEL_WEBHOOK_SECRET
        })
    ],
});
```
