Integrations / Infrastructure

Vercel

Look up deployments and their build logs, cancel, promote or roll back deployments, and trigger workflows from Vercel deployment and project events.

8 tools 15 trigger events

Tools

vercel.list_deployments

List the team's deployments, newest first, optionally for one project, branch or environment.

projecttargetstatebranchshalimit

vercel.get_deployment

Get a deployment by ID or hostname, with its state, aliases and Git metadata.

deployment*

vercel.get_deployment_events

Get the build log events of a deployment, oldest first.

deployment*directionlimit

vercel.cancel_deployment writes

Cancel a deployment that is still building.

deployment_id*

vercel.promote_deployment writes

Promote a deployment to production for its project.

project*deployment_id*

vercel.rollback_deployment writes

Point production traffic back to a previous production deployment.

project*deployment_id*description

vercel.api_get

Send a GET request to any Vercel API path under https://api.vercel.com and return the response. For endpoints the named tools don't cover.

path*params

vercel.api_request writes

Send a POST, PUT, PATCH or DELETE request to any Vercel API path under https://api.vercel.com.

method*path*paramsbody

Tick Allow raw writes on the connection to add api_request, which can send POST, PUT, PATCH and DELETE requests to any Vercel API path.

Connect

  1. In Vercel, open Account Settings → Tokens, create a token scoped to your team, and copy it. It isn't shown again.
  2. Paste it as the connection's access token, and set the team ID from the team's Settings → General (team_…).
  3. To trigger workflows on a Pro or Enterprise team, open the team's Settings → Webhooks, pick the events and projects, enter the request URL shown on the connection page, choose Create Webhook, and paste the secret it shows on the connection.

Credentials

Access token Webhook secret

Vercel API docs

Triggers

In Vercel, open the team's Settings → Webhooks, pick the events and projects, enter this URL, choose Create Webhook, and paste the secret it shows on this connection.

Events

deployment.createddeployment.succeededdeployment.errordeployment.canceleddeployment.promoteddeployment.rollbackproject.createdproject.removedproject.renamedproject.env-variable.createdproject.env-variable.updatedproject.env-variable.deletedflag.createdflag.updatedflag.deleted
trigger
kind: vercel connection: vercel events: [deployment.created] projects: [...] targets: [...]

Your next automation is one sentence away.

14-day free trial with $5 of built-in AI included. Cancel anytime.