Skip to main content

Vercel Integration

Connect Vercel to bring your Vercel billing charges into Cloud ex Machina, next to your cloud infrastructure costs.

DataVercel APITeam role of the token owner
Daily billing charges per project (FOCUS format)/v1/billing/chargesBilling (Pro) or Enterprise Viewer (Enterprise)
Contract commitments (Enterprise only)/v1/billing/contract-commitmentsSame as above
Projects, deployments and domainsProjects, Deployments, DomainsSame 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​

  1. Sign in to Vercel as the user from the prerequisites.
  2. Open vercel.com/account/tokens.
  3. Name the token Cloud ex Machina.
  4. In Scope, select your team. Do not select Full Account.
  5. In Expiration, select an expiration of 1 year or less.
  6. Click Create.
  7. Copy the token. The token starts with vcp_. Vercel shows the token only once.

Step 2: Add the connection in Cloud ex Machina​

  1. In the sidebar, click Integrations.
  2. Find Vercel and click Sign in. If the integration already has a connection, the button is Add connection.
  3. Fill in Token with the token from Step 1.
  4. Submit the form. Cloud ex Machina checks the token with Vercel and saves the connection.

Remove a connection​

  1. Click the connection row under the Vercel card.
  2. Click Disconnect.
  3. Delete the token in Vercel.

Next Steps​