Vercel Aliases icon

Vercel Aliases

Manage Vercel deployment aliases via the Vercel REST API

Actions4

Create Alias

AI-generated

Summary

Assigns an alias (domain name) to a Vercel deployment by POSTing to the Vercel API's /v2/deployments/{id}/aliases endpoint, once per input item.

Inputs

  • Deployment ID (required) — ID of the deployment to alias. URL-encoded into the request path.
  • Alias Name (required) — The alias hostname to assign (e.g. my-app.vercel.app). Sent as the JSON body field alias.

Output shape

One output item per input item, whose json is the raw Vercel API response for the created alias (typically the alias details).

Requires the vercelApi credential (access token, optional team ID and base URL). The source also reads a teamIdOverride parameter (not listed among this operation's properties) and, if set, uses it instead of the credential's team ID as the teamId query parameter. With Continue On Fail enabled, failed items return json {error: message} instead of stopping the workflow. Each output item is paired to its input item.

Examples

Example 1: Point a custom domain at a deployment after a successful build

Deployment ID = {{$json.deploymentId}} from a previous node; Alias Name = staging.example.com

Example 2: Assign a vercel.app alias to a specific deployment

Deployment ID = dpl_abc123; Alias Name = my-app.vercel.app

Links

Discussion