Vercel Integration
Connect Vercel to bring your Vercel billing charges into Cloud ex Machina, next to your cloud infrastructure costs.
| Data | Vercel API | Team role of the token owner |
|---|---|---|
| Daily billing charges per project (FOCUS format) | /v1/billing/charges | Billing (Pro) or Enterprise Viewer (Enterprise) |
| Contract commitments (Enterprise only) | /v1/billing/contract-commitments | Same as above |
| Projects, deployments and domains | Projects, Deployments, Domains | Same as above |
Prerequisites
- Cloud ex Machina Admin access.
- A Vercel user with one of these roles on the team:
- Enterprise plan: Enterprise Viewer. This role reads billing data and cannot change anything.
- Pro plan: Billing. A Pro team has one Billing seat.
Vercel tokens can write
Vercel offers no read-only token. A token from a Billing user can also buy credits through the Vercel API. On an Enterprise plan, use an Enterprise Viewer user to prevent this.
Step 1: Create a team token
- Sign in to Vercel as the user from the prerequisites.
- Open vercel.com/account/tokens.
- Name the token
Cloud ex Machina. - In Scope, select your team. Do not select Full Account.
- In Expiration, select an expiration of 1 year or less.
- Click Create.
- Copy the token. The token starts with
vcp_. Vercel shows the token only once.
Step 2: Add the connection in Cloud ex Machina
- In the sidebar, click Integrations.
- Find Vercel and click Sign in. If the integration already has a connection, the button is Add connection.
- Fill in Token with the token from Step 1.
- Submit the form. Cloud ex Machina checks the token with Vercel and saves the connection.
Remove a connection
- Click the connection row under the Vercel card.
- Click Disconnect.
- Delete the token in Vercel.
Next Steps
- See all available integrations in the Integrations Overview.