Vercel Connection

Setup Vercel Connection in Hanzo KMS

Navigate to the Vercel Account Settings page by clicking on your profile icon in the top-right corner.

Select the API Tokens tab from the left sidebar navigation menu.

Click the Create button and provide a name for your token (e.g., "Hanzo KMS Integration"). Choose appropriate scope permissions based on your requirements.

If you configure an expiry date for your API token, you will need to manually rotate to a new token prior to expiration to avoid integration downtime. Consider setting a calendar reminder for this task.

After creation, a modal with the API token will be displayed. Copy this token immediately and store it securely, as you won't be able to view it again after closing this dialog.

You should now see your newly created token in the list of API tokens on the Vercel dashboard.

1. Navigate to App Connections

   In your Hanzo KMS dashboard, navigate to the Integrations tab in the desired project, then select App Connections.

2. Add Connection

   Click the + Add Connection button and select the Vercel Connection option from the available integrations.

3. Fill the Vercel Connection Modal

   Complete the Vercel Connection form by entering:

   • A descriptive name for the connection
   • The API Token you generated in steps 3-4
   • An optional description for future reference

4. Connection Created

   After clicking Create, your Vercel Connection is established and ready to use with your Hanzo KMS project.

To create a Vercel Connection, make an API request to the Create Vercel Connection API endpoint.

Sample request

curl    --request POST \
        --url https://app.kms.hanzo.ai/api/v1/app-connections/vercel \
        --header 'Content-Type: application/json' \
        --data '{
            "name": "my-vercel-connection",
            "projectId": "7ffbb072-2575-495a-b5b0-127f88caef78",
            "method": "api-token",
            "credentials": {
                "apiToken": "...",
            }
        }'

Sample response

{
    "appConnection": {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "name": "my-vercel-connection",
        "projectId": "7ffbb072-2575-495a-b5b0-127f88caef78",
        "version": 123,
        "orgId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "createdAt": "2025-04-01T05:31:56Z",
        "updatedAt": "2025-04-01T05:31:56Z",
        "app": "vercel",
        "method": "api-token",
        "credentials": {}
    }
}