Create deployment

vercel.createDeployment starts a build from Git or an existing deployment.

automations/create-vercel-deployment.automation.ts

import { automation } from "automate.ax"
import { vercel } from "automate.ax/vercel"

export default automation("Deploy Vercel project", () => {
  const deployment = vercel.createDeployment({
    gitSource: { ref: "main", repoId: 123456, type: "github" },
    name: "docs-site",
    project: "prj_123",
    target: "production",
  })
  // Use deployment.id in Vercel promotion or rollback actions.
})

The action requires name and either gitSource or deploymentId. Git sources support GitHub repository IDs, GitLab project IDs, and Bitbucket repository UUIDs with a ref and an optional exact commit SHA. deploymentId redeploys a build. withLatestCommit defaults to false. Other inputs are project, target, customEnvironment, metadata, forceNew, and skipAutoDetectionConfirmation. Returns Vercel’s full created-deployment response.

Built-in triggers

Built-in actions

Runtime utilities

Integrations