Use Vercel to manage deployments, projects, domains, DNS records, environment variables, aliases, and Edge Config from a workflow. Deployment, project, and domain events can trigger workflows.
Integrate with Vercel to manage deployments, projects, domains, DNS records, environment variables, aliases, edge configs, teams, and more.
List deployments for a Vercel project or team
Inputs and outputsParameter Type Required Description apiKeystring Yes Vercel Access Token projectIdstring No Filter deployments by project ID or name targetstring No Filter by environment: production or staging statestring No Filter by state: BUILDING, ERROR, INITIALIZING, QUEUED, READY, CANCELED, BLOCKED appstring No Filter by deployment name sincenumber No Get deployments created after this JavaScript timestamp untilnumber No Get deployments created before this JavaScript timestamp limitnumber No Maximum number of deployments to return per request teamIdstring No Team ID to scope the request slugstring No Team slug to scope the request (alternative to teamId)
Parameter Type Description deploymentsarray List of deployments ↳ uid string Unique deployment identifier ↳ name string Deployment name ↳ url string Deployment URL ↳ state string Deployment state: BUILDING, ERROR, INITIALIZING, QUEUED, READY, CANCELED, DELETED, BLOCKED ↳ target string Target environment ↳ created number Creation timestamp ↳ projectId string Associated project ID ↳ source string Deployment source: api-trigger-git-deploy, cli, clone/repo, git, import, import/repo, redeploy, v0-web ↳ inspectorUrl string Vercel inspector URL ↳ checksState string Checks state: completed, registered, running ↳ checksConclusion string Checks conclusion: succeeded, failed, skipped, canceled ↳ errorMessage string Deployment error message ↳ creator object Creator information ↳ uid string Creator user ID ↳ email string Creator email ↳ username string Creator username ↳ meta object Git provider metadata (key-value strings) countnumber Number of deployments returned hasMoreboolean Whether more deployments are available
Get details of a specific Vercel deployment
Inputs and outputsParameter Type Required Description apiKeystring Yes Vercel Access Token deploymentIdstring Yes The unique deployment identifier or hostname withGitRepoInfostring No Whether to add in gitRepo information (true/false) teamIdstring No Team ID to scope the request slugstring No Team slug to scope the request (alternative to teamId)
Parameter Type Description idstring Deployment ID namestring Deployment name urlstring Unique deployment URL readyStatestring Deployment ready state: QUEUED, BUILDING, ERROR, INITIALIZING, READY, CANCELED statusstring Deployment status targetstring Target environment createdAtnumber Creation timestamp in milliseconds buildingAtnumber Build start timestamp readynumber Ready timestamp sourcestring Deployment source: cli, git, redeploy, import, v0-web, etc. aliasarray Assigned aliases regionsarray Deployment regions inspectorUrlstring Vercel inspector URL projectIdstring Associated project ID creatorobject Creator information ↳ uid string Creator user ID ↳ username string Creator username projectobject Associated project ↳ id string Project ID ↳ name string Project name ↳ framework string Project framework metaobject Deployment metadata (key-value strings) ↳ githubCommitSha string GitHub commit SHA ↳ githubCommitMessage string GitHub commit message ↳ githubCommitRef string GitHub branch/ref ↳ githubRepo string GitHub repository ↳ githubOrg string GitHub organization ↳ githubCommitAuthorName string Commit author name gitSourceobject Git source information ↳ type string Git provider type (e.g., github, gitlab, bitbucket) ↳ ref string Git ref (branch or tag) ↳ sha string Git commit SHA ↳ repoId string Repository ID errorCodestring Deployment error code errorMessagestring Deployment error message aliasAssignedboolean Whether the alias has been assigned
Create a new deployment or redeploy an existing one
Inputs and outputsParameter Type Required Description apiKeystring Yes Vercel Access Token namestring Yes Project name for the deployment projectstring No Project ID (overrides name for project lookup) deploymentIdstring No Existing deployment ID to redeploy targetstring No Target environment: production, staging, or a custom environment identifier gitSourcestring No JSON string defining the Git Repository source to deploy (e.g. {"type":"github","repo":"owner/repo","ref":"main"}) forceNewstring No Forces a new deployment even if there is a previous similar deployment (0 or 1) teamIdstring No Team ID to scope the request slugstring No Team slug to scope the request (alternative to teamId)
Parameter Type Description idstring Deployment ID namestring Deployment name urlstring Unique deployment URL readyStatestring Deployment ready state: QUEUED, BUILDING, ERROR, INITIALIZING, READY, CANCELED projectIdstring Associated project ID createdAtnumber Creation timestamp in milliseconds aliasarray Assigned aliases targetstring Target environment inspectorUrlstring Vercel inspector URL errorCodestring Deployment error code errorMessagestring Deployment error message aliasAssignedboolean Whether the alias has been assigned
Cancel a running Vercel deployment
Inputs and outputsParameter Type Required Description apiKeystring Yes Vercel Access Token deploymentIdstring Yes The deployment ID to cancel teamIdstring No Team ID to scope the request slugstring No Team slug to scope the request (alternative to teamId)
Parameter Type Description idstring Deployment ID namestring Deployment name statestring Deployment state after cancellation urlstring Deployment URL statusstring Deployment status projectIdstring Associated project ID inspectorUrlstring Vercel inspector URL
Delete a Vercel deployment
Inputs and outputsParameter Type Required Description apiKeystring Yes Vercel Access Token deploymentIdstring Yes The deployment ID or URL to delete teamIdstring No Team ID to scope the request slugstring No Team slug to scope the request (alternative to teamId)
Parameter Type Description uidstring The removed deployment ID statestring Deployment state after deletion (DELETED)
Get build and runtime events for a Vercel deployment
Inputs and outputsParameter Type Required Description apiKeystring Yes Vercel Access Token deploymentIdstring Yes The unique deployment identifier or hostname directionstring No Order of events by timestamp: backward or forward (default: forward) follownumber No When set to 1, returns live events as they happen limitnumber No Maximum number of events to return (-1 for all) sincenumber No Timestamp to start pulling build logs from untilnumber No Timestamp to stop pulling build logs at teamIdstring No Team ID to scope the request slugstring No Team slug to scope the request (alternative to teamId)
Parameter Type Description eventsarray List of deployment events ↳ type string Event type: delimiter, command, stdout, stderr, exit, deployment-state, middleware, middleware-invocation, edge-function-invocation, metric, report, fatal ↳ created number Event creation timestamp ↳ date number Event date timestamp ↳ text string Event text content ↳ serial string Event serial identifier ↳ deploymentId string Associated deployment ID ↳ id string Event unique identifier ↳ level string Event level: error or warning ↳ info object Build step info (type, name, entrypoint, path, step, readyState) countnumber Number of events returned
List files in a Vercel deployment
Inputs and outputsParameter Type Required Description apiKeystring Yes Vercel Access Token deploymentIdstring Yes The deployment ID to list files for teamIdstring No Team ID to scope the request slugstring No Team slug to scope the request (alternative to teamId)
Parameter Type Description filesarray List of deployment files ↳ name string The name of the file tree entry ↳ type string File type: directory, file, symlink, lambda, middleware, or invalid ↳ uid string Unique file identifier (only valid for file type) ↳ mode number File mode indicating file type and permissions ↳ contentType string Content-type of the file (only valid for file type) ↳ children array Child files of the directory (only valid for directory type) ↳ name string File name ↳ type string Entry type ↳ uid string File identifier countnumber Number of files returned
Promote a deployment by pointing the production deployment to the given deployment
Inputs and outputsParameter Type Required Description apiKeystring Yes Vercel Access Token projectIdstring Yes Project ID or name deploymentIdstring Yes The ID of the deployment to promote to production teamIdstring No Team ID to scope the request slugstring No Team slug to scope the request (alternative to teamId)
Parameter Type Description promotedboolean Whether the deployment was promoted to production
List all projects in a Vercel team or account
Inputs and outputsParameter Type Required Description apiKeystring Yes Vercel Access Token searchstring No Search projects by name limitnumber No Maximum number of projects to return fromstring No Continuation token for pagination, taken from the previous response's pagination.next value. Query only projects updated after this timestamp or continuation token. teamIdstring No Team ID to scope the request slugstring No Team slug to scope the request (alternative to teamId)
Parameter Type Description projectsarray List of projects ↳ id string Project ID ↳ name string Project name ↳ framework string Framework ↳ rootDirectory string Root directory of the project ↳ nodeVersion string Node.js version ↳ createdAt number Creation timestamp ↳ updatedAt number Last updated timestamp countnumber Number of projects returned hasMoreboolean Whether more projects are available nextFromstring Continuation token to pass as from to fetch the next page
Get details of a specific Vercel project
Inputs and outputsParameter Type Required Description apiKeystring Yes Vercel Access Token projectIdstring Yes Project ID or name teamIdstring No Team ID to scope the request slugstring No Team slug to scope the request (alternative to teamId)
Parameter Type Description idstring Project ID namestring Project name frameworkstring Project framework rootDirectorystring Root directory of the project nodeVersionstring Node.js version createdAtnumber Creation timestamp updatedAtnumber Last updated timestamp linkobject Git repository connection ↳ type string Repository type (github, gitlab, bitbucket) ↳ repo string Repository name ↳ org string Organization or owner
Create a new Vercel project
Inputs and outputsParameter Type Required Description apiKeystring Yes Vercel Access Token namestring Yes Project name frameworkstring No Project framework (e.g. nextjs, remix, vite) gitRepositoryjson No Git repository connection object with type and repo buildCommandstring No Custom build command outputDirectorystring No Custom output directory installCommandstring No Custom install command rootDirectorystring No Subdirectory of the repository the project lives in (for monorepos) nodeVersionstring No Node.js version to use (e.g. 22.x, 20.x, 18.x) devCommandstring No Custom dev server command teamIdstring No Team ID to scope the request slugstring No Team slug to scope the request (alternative to teamId)
Parameter Type Description idstring Project ID namestring Project name frameworkstring Project framework createdAtnumber Creation timestamp updatedAtnumber Last updated timestamp
Update an existing Vercel project
Inputs and outputsParameter Type Required Description apiKeystring Yes Vercel Access Token projectIdstring Yes Project ID or name namestring No New project name frameworkstring No Project framework (e.g. nextjs, remix, vite) buildCommandstring No Custom build command outputDirectorystring No Custom output directory installCommandstring No Custom install command rootDirectorystring No Subdirectory of the repository the project lives in (for monorepos) nodeVersionstring No Node.js version to use (e.g. 22.x, 20.x, 18.x) devCommandstring No Custom dev server command teamIdstring No Team ID to scope the request slugstring No Team slug to scope the request (alternative to teamId)
Parameter Type Description idstring Project ID namestring Project name frameworkstring Project framework updatedAtnumber Last updated timestamp
Delete a Vercel project
Inputs and outputsParameter Type Required Description apiKeystring Yes Vercel Access Token projectIdstring Yes Project ID or name teamIdstring No Team ID to scope the request slugstring No Team slug to scope the request (alternative to teamId)
Parameter Type Description deletedboolean Whether the project was successfully deleted
Pause a Vercel project
Inputs and outputsParameter Type Required Description apiKeystring Yes Vercel Access Token projectIdstring Yes Project ID or name teamIdstring No Team ID to scope the request slugstring No Team slug to scope the request (alternative to teamId)
Parameter Type Description idstring Project ID namestring Project name pausedboolean Whether the project is paused
Unpause a Vercel project
Inputs and outputsParameter Type Required Description apiKeystring Yes Vercel Access Token projectIdstring Yes Project ID or name teamIdstring No Team ID to scope the request slugstring No Team slug to scope the request (alternative to teamId)
Parameter Type Description idstring Project ID namestring Project name pausedboolean Whether the project is paused
List all domains for a Vercel project
Inputs and outputsParameter Type Required Description apiKeystring Yes Vercel Access Token projectIdstring Yes Project ID or name teamIdstring No Team ID to scope the request slugstring No Team slug to scope the request (alternative to teamId) limitnumber No Maximum number of domains to return
Parameter Type Description domainsarray List of project domains ↳ name string Domain name ↳ apexName string Apex domain name ↳ projectId string Project ID the domain belongs to ↳ redirect string Redirect target ↳ redirectStatusCode number Redirect status code ↳ verified boolean Whether the domain is verified ↳ gitBranch string Git branch for the domain ↳ verification array Domain verification challenges (type, domain, value, reason) ↳ type string Challenge type ↳ domain string Domain to add the record to ↳ value string Expected record value ↳ reason string Why verification is needed ↳ createdAt number Creation timestamp ↳ updatedAt number Last updated timestamp countnumber Number of domains returned hasMoreboolean Whether more domains are available
Add a domain to a Vercel project
Inputs and outputsParameter Type Required Description apiKeystring Yes Vercel Access Token projectIdstring Yes Project ID or name domainstring Yes Domain name to add redirectstring No Target domain for redirect redirectStatusCodenumber No HTTP status code for redirect (301, 302, 307, 308) gitBranchstring No Git branch to link the domain to teamIdstring No Team ID to scope the request slugstring No Team slug to scope the request (alternative to teamId)
Parameter Type Description namestring Domain name apexNamestring Apex domain name projectIdstring Project ID the domain belongs to verifiedboolean Whether the domain is verified gitBranchstring Git branch for the domain redirectstring Redirect target domain redirectStatusCodenumber HTTP status code for redirect (301, 302, 307, 308) verificationarray Domain verification challenges (type, domain, value, reason) ↳ type string Challenge type ↳ domain string Domain to add the record to ↳ value string Expected record value ↳ reason string Why verification is needed createdAtnumber Creation timestamp updatedAtnumber Last updated timestamp
Remove a domain from a Vercel project
Inputs and outputsParameter Type Required Description apiKeystring Yes Vercel Access Token projectIdstring Yes Project ID or name domainstring Yes Domain name to remove teamIdstring No Team ID to scope the request slugstring No Team slug to scope the request (alternative to teamId)
Parameter Type Description deletedboolean Whether the domain was successfully removed
Update a project domain's configuration on Vercel
Inputs and outputsParameter Type Required Description apiKeystring Yes Vercel Access Token projectIdstring Yes Project ID or name domainstring Yes Domain name to update redirectstring No Target destination domain for redirect redirectStatusCodenumber No HTTP status code for redirect (301, 302, 307, 308) gitBranchstring No Git branch to link the domain to teamIdstring No Team ID to scope the request slugstring No Team slug to scope the request (alternative to teamId)
Parameter Type Description namestring Domain name apexNamestring Apex domain name projectIdstring Project ID the domain belongs to verifiedboolean Whether the domain is verified redirectstring Redirect target domain redirectStatusCodenumber HTTP status code for redirect (301, 302, 307, 308) gitBranchstring Git branch for the domain verificationarray Domain verification challenges (type, domain, value, reason) ↳ type string Challenge type ↳ domain string Domain to add the record to ↳ value string Expected record value ↳ reason string Why verification is needed createdAtnumber Creation timestamp updatedAtnumber Last updated timestamp
Verify a Vercel project domain by checking its verification challenge
Inputs and outputsParameter Type Required Description apiKeystring Yes Vercel Access Token projectIdstring Yes Project ID or name domainstring Yes Domain name to verify teamIdstring No Team ID to scope the request slugstring No Team slug to scope the request (alternative to teamId)
Parameter Type Description namestring Domain name apexNamestring Apex domain name projectIdstring Project ID verifiedboolean Whether the domain is verified redirectstring Redirect target domain redirectStatusCodenumber Redirect status code (301, 302, 307, 308) gitBranchstring Git branch linked to the domain createdAtnumber Creation timestamp updatedAtnumber Last update timestamp
Retrieve environment variables for a Vercel project
Inputs and outputsParameter Type Required Description apiKeystring Yes Vercel Access Token projectIdstring Yes Project ID or name decryptboolean No If true, decrypted variable values are returned instead of ciphertext gitBranchstring No Filter results to the environment variables for this git branch (must have target=preview) teamIdstring No Team ID to scope the request slugstring No Team slug to scope the request (alternative to teamId)
Parameter Type Description envsarray List of environment variables ↳ id string Environment variable ID ↳ key string Variable name ↳ value string Variable value ↳ type string Variable type (secret, system, encrypted, plain, sensitive) ↳ target array Target environments ↳ gitBranch string Git branch filter ↳ comment string Comment providing context for the variable ↳ createdAt number Creation timestamp ↳ updatedAt number Last update timestamp countnumber Number of environment variables returned
Create an environment variable for a Vercel project
Inputs and outputsParameter Type Required Description apiKeystring Yes Vercel Access Token projectIdstring Yes Project ID or name keystring Yes Environment variable name valuestring Yes Environment variable value targetstring Yes Comma-separated list of target environments (production, preview, development) typestring No Variable type: system, encrypted, plain, or sensitive (default: plain) gitBranchstring No Git branch to associate with the variable (requires target to include preview) commentstring No Comment to add context to the variable (max 500 characters) teamIdstring No Team ID to scope the request slugstring No Team slug to scope the request (alternative to teamId)
Parameter Type Description idstring Environment variable ID keystring Variable name valuestring Variable value typestring Variable type (secret, system, encrypted, plain, sensitive) targetarray Target environments gitBranchstring Git branch filter commentstring Comment providing context for the variable createdAtnumber Creation timestamp updatedAtnumber Last update timestamp
Update an environment variable for a Vercel project
Inputs and outputsParameter Type Required Description apiKeystring Yes Vercel Access Token projectIdstring Yes Project ID or name envIdstring Yes Environment variable ID to update keystring No New variable name valuestring No New variable value targetstring No Comma-separated list of target environments (production, preview, development) typestring No Variable type: system, encrypted, plain, or sensitive gitBranchstring No Git branch to associate with the variable (requires target to include preview) commentstring No Comment to add context to the variable (max 500 characters) teamIdstring No Team ID to scope the request slugstring No Team slug to scope the request (alternative to teamId)
Parameter Type Description idstring Environment variable ID keystring Variable name valuestring Variable value typestring Variable type (secret, system, encrypted, plain, sensitive) targetarray Target environments gitBranchstring Git branch filter commentstring Comment providing context for the variable createdAtnumber Creation timestamp updatedAtnumber Last update timestamp
Delete an environment variable from a Vercel project
Inputs and outputsParameter Type Required Description apiKeystring Yes Vercel Access Token projectIdstring Yes Project ID or name envIdstring Yes Environment variable ID to delete teamIdstring No Team ID to scope the request slugstring No Team slug to scope the request (alternative to teamId)
Parameter Type Description deletedboolean Whether the environment variable was successfully deleted
List all domains in a Vercel account or team
Inputs and outputsParameter Type Required Description apiKeystring Yes Vercel Access Token limitnumber No Maximum number of domains to return (default 20) teamIdstring No Team ID to scope the request slugstring No Team slug to scope the request (alternative to teamId)
Parameter Type Description domainsarray List of domains ↳ id string Domain ID ↳ name string Domain name ↳ verified boolean Whether domain is verified ↳ createdAt number Creation timestamp ↳ expiresAt number Expiration timestamp ↳ serviceType string Service type (zeit.world, external, na) ↳ nameservers array Current nameservers ↳ intendedNameservers array Intended nameservers ↳ renew boolean Whether auto-renewal is enabled ↳ boughtAt number Purchase timestamp ↳ transferredAt number Transfer completion timestamp ↳ creator object Domain creator (id, username, email) ↳ id string Creator ID ↳ username string Creator username ↳ email string Creator email ↳ customNameservers array Custom nameservers ↳ userId string Owner user ID ↳ teamId string Owner team ID ↳ transferStartedAt number Transfer start timestamp countnumber Number of domains returned hasMoreboolean Whether more domains are available
Get information about a specific domain in a Vercel account
Inputs and outputsParameter Type Required Description apiKeystring Yes Vercel Access Token domainstring Yes The domain name to retrieve teamIdstring No Team ID to scope the request slugstring No Team slug to scope the request (alternative to teamId)
Parameter Type Description idstring Domain ID namestring Domain name verifiedboolean Whether domain is verified createdAtnumber Creation timestamp expiresAtnumber Expiration timestamp serviceTypestring Service type (zeit.world, external, na) nameserversarray Current nameservers intendedNameserversarray Intended nameservers customNameserversarray Custom nameservers renewboolean Whether auto-renewal is enabled boughtAtnumber Purchase timestamp transferredAtnumber Transfer completion timestamp creatorobject Domain creator (id, username, email) ↳ id string Creator ID ↳ username string Creator username ↳ email string Creator email userIdstring Owner user ID teamIdstring Owner team ID transferStartedAtnumber Transfer start timestamp
Add a new domain to a Vercel account or team
Inputs and outputsParameter Type Required Description apiKeystring Yes Vercel Access Token namestring Yes The domain name to add teamIdstring No Team ID to scope the request slugstring No Team slug to scope the request (alternative to teamId)
Parameter Type Description idstring Domain ID namestring Domain name verifiedboolean Whether domain is verified createdAtnumber Creation timestamp serviceTypestring Service type (zeit.world, external, na) nameserversarray Current nameservers intendedNameserversarray Intended nameservers expiresAtnumber Expiration timestamp customNameserversarray Custom nameservers renewboolean Whether auto-renewal is enabled boughtAtnumber Purchase timestamp transferredAtnumber Transfer completion timestamp creatorobject Domain creator (id, username, email) ↳ id string Creator ID ↳ username string Creator username ↳ email string Creator email
Delete a domain from a Vercel account or team
Inputs and outputsParameter Type Required Description apiKeystring Yes Vercel Access Token domainstring Yes The domain name to delete teamIdstring No Team ID to scope the request slugstring No Team slug to scope the request (alternative to teamId)
Parameter Type Description uidstring The ID of the deleted domain deletedboolean Whether the domain was deleted
Get the configuration for a domain in a Vercel account
Inputs and outputsParameter Type Required Description apiKeystring Yes Vercel Access Token domainstring Yes The domain name to get configuration for teamIdstring No Team ID to scope the request slugstring No Team slug to scope the request (alternative to teamId)
Parameter Type Description configuredBystring How the domain is configured (CNAME, A, http, dns-01, or null) acceptedChallengesarray Accepted challenge types for certificate issuance (dns-01, http-01) misconfiguredboolean Whether the domain is misconfigured for TLS certificate generation recommendedIPv4array Recommended IPv4 addresses with rank values ↳ rank number Priority rank (1 is preferred) ↳ value array IPv4 addresses recommendedCNAMEarray Recommended CNAME records with rank values ↳ rank number Priority rank (1 is preferred) ↳ value string CNAME value
List all DNS records for a domain in a Vercel account
Inputs and outputsParameter Type Required Description apiKeystring Yes Vercel Access Token domainstring Yes The domain name to list records for limitnumber No Maximum number of records to return teamIdstring No Team ID to scope the request slugstring No Team slug to scope the request (alternative to teamId)
Parameter Type Description recordsarray List of DNS records ↳ id string Record ID ↳ slug string Record slug ↳ name string Record name ↳ type string Record type (A, AAAA, ALIAS, CAA, CNAME, HTTPS, MX, SRV, TXT, NS) ↳ value string Record value ↳ ttl number Time to live in seconds ↳ mxPriority number MX record priority ↳ priority number Record priority ↳ creator string Creator identifier ↳ createdAt number Creation timestamp ↳ updatedAt number Last update timestamp ↳ comment string Record comment countnumber Number of records returned hasMoreboolean Whether more records are available
Create a DNS record for a domain in a Vercel account
Inputs and outputsParameter Type Required Description apiKeystring Yes Vercel Access Token domainstring Yes The domain name to create the record for recordNamestring Yes The subdomain or record name recordTypestring Yes DNS record type (A, AAAA, ALIAS, CAA, CNAME, HTTPS, MX, SRV, TXT, NS) valuestring No The value of the DNS record (not used for SRV/HTTPS records) ttlnumber No Time to live in seconds mxPrioritynumber No Priority for MX records srvTargetstring No Target hostname for SRV records (required when recordType is SRV) srvWeightnumber No Weight for SRV records (required when recordType is SRV) srvPortnumber No Port for SRV records (required when recordType is SRV) srvPrioritynumber No Priority for SRV records (required when recordType is SRV) httpsTargetstring No Target hostname for HTTPS records (required when recordType is HTTPS) httpsPrioritynumber No Priority for HTTPS records (required when recordType is HTTPS) httpsParamsstring No Optional service parameters for HTTPS records (e.g. "alpn=h2,h3") commentstring No A comment to add context on what this DNS record is for (max 500 characters) teamIdstring No Team ID to scope the request slugstring No Team slug to scope the request (alternative to teamId)
Parameter Type Description uidstring The DNS record ID updatednumber Timestamp of the update
Update an existing DNS record for a domain in a Vercel account
Inputs and outputsParameter Type Required Description apiKeystring Yes Vercel Access Token recordIdstring Yes The ID of the DNS record to update namestring No The name of the DNS record valuestring No The value of the DNS record typestring No DNS record type (A, AAAA, ALIAS, CAA, CNAME, HTTPS, MX, SRV, TXT, NS) ttlnumber No Time to live in seconds (60 to 2147483647) mxPrioritynumber No Priority for MX records srvTargetstring No Target hostname for SRV records (required together when updating SRV data) srvWeightnumber No Weight for SRV records (required together when updating SRV data) srvPortnumber No Port for SRV records (required together when updating SRV data) srvPrioritynumber No Priority for SRV records (required together when updating SRV data) httpsTargetstring No Target hostname for HTTPS records (required together when updating HTTPS data) httpsPrioritynumber No Priority for HTTPS records (required together when updating HTTPS data) httpsParamsstring No Optional service parameters for HTTPS records (e.g. "alpn=h2,h3") commentstring No A comment to add context on what this DNS record is for (max 500 characters) teamIdstring No Team ID to scope the request slugstring No Team slug to scope the request (alternative to teamId)
Parameter Type Description idstring The DNS record ID namestring The name of the DNS record typestring The record class (record or record-sys) valuestring The value of the DNS record creatorstring The creator of the DNS record domainstring The domain the record belongs to ttlnumber Time to live in seconds commentstring Comment providing context for the record recordTypestring DNS record type (A, AAAA, ALIAS, CAA, CNAME, HTTPS, MX, NS, SRV, TXT) createdAtnumber Timestamp of record creation
Delete a DNS record for a domain in a Vercel account
Inputs and outputsParameter Type Required Description apiKeystring Yes Vercel Access Token domainstring Yes The domain name the record belongs to recordIdstring Yes The ID of the DNS record to delete teamIdstring No Team ID to scope the request slugstring No Team slug to scope the request (alternative to teamId)
Parameter Type Description deletedboolean Whether the record was deleted
List aliases for a Vercel project or team
Inputs and outputsParameter Type Required Description apiKeystring Yes Vercel Access Token projectIdstring No Filter aliases by project ID domainstring No Filter aliases by domain limitnumber No Maximum number of aliases to return teamIdstring No Team ID to scope the request slugstring No Team slug to scope the request (alternative to teamId)
Parameter Type Description aliasesarray List of aliases ↳ uid string Alias ID ↳ alias string Alias hostname ↳ deploymentId string Associated deployment ID ↳ projectId string Associated project ID ↳ createdAt number Creation timestamp in milliseconds ↳ updatedAt number Last update timestamp in milliseconds ↳ deployment object Associated deployment (id, url) ↳ id string Deployment ID ↳ url string Deployment URL ↳ redirect string Target domain for redirect aliases ↳ redirectStatusCode number HTTP status code for redirect (301, 302, 307, or 308) countnumber Number of aliases returned hasMoreboolean Whether more aliases are available
Get details about a specific alias by ID or hostname
Inputs and outputsParameter Type Required Description apiKeystring Yes Vercel Access Token aliasIdstring Yes Alias ID or hostname to look up teamIdstring No Team ID to scope the request slugstring No Team slug to scope the request (alternative to teamId)
Parameter Type Description uidstring Alias ID aliasstring Alias hostname deploymentIdstring Associated deployment ID projectIdstring Associated project ID createdAtnumber Creation timestamp in milliseconds updatedAtnumber Last update timestamp in milliseconds redirectstring Target domain for redirect aliases redirectStatusCodenumber HTTP status code for redirect (301, 302, 307, or 308) deploymentobject Associated deployment (id, url) ↳ id string Deployment ID ↳ url string Deployment URL
Assign an alias (domain/subdomain) to a deployment
Inputs and outputsParameter Type Required Description apiKeystring Yes Vercel Access Token deploymentIdstring Yes Deployment ID to assign the alias to aliasstring Yes The domain or subdomain to assign as an alias redirectstring No Hostname to 307-redirect the alias to instead of serving the deployment directly teamIdstring No Team ID to scope the request slugstring No Team slug to scope the request (alternative to teamId)
Parameter Type Description uidstring Alias ID aliasstring Alias hostname createdstring Creation timestamp as ISO 8601 date-time string oldDeploymentIdstring ID of the previously aliased deployment, if the alias was reassigned
Delete an alias by its ID
Inputs and outputsParameter Type Required Description apiKeystring Yes Vercel Access Token aliasIdstring Yes Alias ID to delete teamIdstring No Team ID to scope the request slugstring No Team slug to scope the request (alternative to teamId)
Parameter Type Description statusstring Deletion status (SUCCESS)
List all Edge Config stores for a team
Inputs and outputsParameter Type Required Description apiKeystring Yes Vercel Access Token teamIdstring No Team ID to scope the request
Parameter Type Description edgeConfigsarray List of Edge Config stores ↳ id string Edge Config ID ↳ slug string Edge Config slug ↳ ownerId string Owner ID ↳ digest string Content digest hash ↳ createdAt number Creation timestamp ↳ updatedAt number Last update timestamp ↳ itemCount number Number of items ↳ sizeInBytes number Size in bytes countnumber Number of Edge Configs returned
Get details about a specific Edge Config store
Inputs and outputsParameter Type Required Description apiKeystring Yes Vercel Access Token edgeConfigIdstring Yes Edge Config ID to look up teamIdstring No Team ID to scope the request
Parameter Type Description idstring Edge Config ID slugstring Edge Config slug ownerIdstring Owner ID digeststring Content digest hash createdAtnumber Creation timestamp updatedAtnumber Last update timestamp itemCountnumber Number of items sizeInBytesnumber Size in bytes
Create a new Edge Config store
Inputs and outputsParameter Type Required Description apiKeystring Yes Vercel Access Token slugstring Yes The name/slug for the new Edge Config teamIdstring No Team ID to scope the request
Parameter Type Description idstring Edge Config ID slugstring Edge Config slug ownerIdstring Owner ID digeststring Content digest hash createdAtnumber Creation timestamp updatedAtnumber Last update timestamp itemCountnumber Number of items sizeInBytesnumber Size in bytes
Get all items in an Edge Config store
Inputs and outputsParameter Type Required Description apiKeystring Yes Vercel Access Token edgeConfigIdstring Yes Edge Config ID to get items from teamIdstring No Team ID to scope the request
Parameter Type Description itemsarray List of Edge Config items ↳ key string Item key ↳ value json Item value ↳ description string Item description ↳ edgeConfigId string Parent Edge Config ID ↳ createdAt number Creation timestamp ↳ updatedAt number Last update timestamp countnumber Number of items returned
Create, update, upsert, or delete items in an Edge Config store
Inputs and outputsParameter Type Required Description apiKeystring Yes Vercel Access Token edgeConfigIdstring Yes Edge Config ID to update items in itemsjson Yes Array of operations: [{operation: "create"|"update"|"upsert"|"delete", key: string, value?: any}] teamIdstring No Team ID to scope the request
Parameter Type Description statusstring Operation status
Delete an Edge Config store by ID
Inputs and outputsParameter Type Required Description apiKeystring Yes Vercel Access Token edgeConfigIdstring Yes Edge Config ID to delete teamIdstring No Team ID to scope the request
Parameter Type Description deletedboolean Whether the Edge Config was successfully deleted
List webhooks for a Vercel project or team
Inputs and outputsParameter Type Required Description apiKeystring Yes Vercel Access Token projectIdstring No Filter webhooks by project ID teamIdstring No Team ID to scope the request
Parameter Type Description webhooksarray List of webhooks ↳ id string Webhook ID ↳ url string Webhook URL ↳ events array Events the webhook listens to ↳ ownerId string Owner ID ↳ projectIds array Associated project IDs ↳ projectsMetadata array Metadata for the projects the webhook is associated with ↳ createdAt number Creation timestamp ↳ updatedAt number Last updated timestamp countnumber Number of webhooks returned
Get details about a specific Vercel webhook
Inputs and outputsParameter Type Required Description apiKeystring Yes Vercel Access Token webhookIdstring Yes Webhook ID to look up teamIdstring No Team ID to scope the request
Parameter Type Description idstring Webhook ID urlstring Webhook URL eventsarray Events the webhook listens to ownerIdstring Owner ID projectIdsarray Associated project IDs createdAtnumber Creation timestamp updatedAtnumber Last updated timestamp
Create a new webhook for a Vercel team
Inputs and outputsParameter Type Required Description apiKeystring Yes Vercel Access Token urlstring Yes Webhook URL (must be https) eventsstring Yes Comma-separated event names to subscribe to projectIdsstring No Comma-separated project IDs to scope the webhook to teamIdstring No Team ID to scope the webhook to (optional; omit for personal account)
Parameter Type Description idstring Webhook ID urlstring Webhook URL secretstring Webhook signing secret eventsarray Events the webhook listens to ownerIdstring Owner ID projectIdsarray Associated project IDs createdAtnumber Creation timestamp updatedAtnumber Last updated timestamp
Delete a webhook from a Vercel team
Inputs and outputsParameter Type Required Description apiKeystring Yes Vercel Access Token webhookIdstring Yes The webhook ID to delete teamIdstring No Team ID to scope the request
Parameter Type Description deletedboolean Whether the webhook was successfully deleted
Create a new deployment check
Inputs and outputsParameter Type Required Description apiKeystring Yes Vercel Access Token deploymentIdstring Yes Deployment ID to create the check for namestring Yes Name of the check (max 100 characters) blockingboolean Yes Whether the check blocks the deployment pathstring No Page path being checked detailsUrlstring No URL with details about the check externalIdstring No External identifier for the check rerequestableboolean No Whether the check can be rerequested teamIdstring No Team ID to scope the request slugstring No Team slug to scope the request (alternative to teamId)
Parameter Type Description idstring Check ID namestring Check name statusstring Check status: registered, running, or completed conclusionstring Check conclusion: canceled, failed, neutral, succeeded, skipped, or stale blockingboolean Whether the check blocks the deployment deploymentIdstring Associated deployment ID integrationIdstring Associated integration ID externalIdstring External identifier detailsUrlstring URL with details about the check pathstring Page path being checked rerequestableboolean Whether the check can be rerequested createdAtnumber Creation timestamp in milliseconds updatedAtnumber Last update timestamp in milliseconds startedAtnumber Start timestamp in milliseconds completedAtnumber Completion timestamp in milliseconds outputjson Check result output including metrics (FCP, LCP, CLS, TBT, virtualExperienceScore)
Get details of a specific deployment check
Inputs and outputsParameter Type Required Description apiKeystring Yes Vercel Access Token deploymentIdstring Yes Deployment ID the check belongs to checkIdstring Yes Check ID to retrieve teamIdstring No Team ID to scope the request slugstring No Team slug to scope the request (alternative to teamId)
Parameter Type Description idstring Check ID namestring Check name statusstring Check status: registered, running, or completed conclusionstring Check conclusion: canceled, failed, neutral, succeeded, skipped, or stale blockingboolean Whether the check blocks the deployment deploymentIdstring Associated deployment ID integrationIdstring Associated integration ID externalIdstring External identifier detailsUrlstring URL with details about the check pathstring Page path being checked rerequestableboolean Whether the check can be rerequested createdAtnumber Creation timestamp in milliseconds updatedAtnumber Last update timestamp in milliseconds startedAtnumber Start timestamp in milliseconds completedAtnumber Completion timestamp in milliseconds outputjson Check result output including metrics (FCP, LCP, CLS, TBT, virtualExperienceScore)
List all checks for a deployment
Inputs and outputsParameter Type Required Description apiKeystring Yes Vercel Access Token deploymentIdstring Yes Deployment ID to list checks for teamIdstring No Team ID to scope the request slugstring No Team slug to scope the request (alternative to teamId)
Parameter Type Description checksarray List of deployment checks ↳ id string Check ID ↳ name string Check name ↳ status string Check status ↳ conclusion string Check conclusion ↳ blocking boolean Whether the check blocks the deployment ↳ deploymentId string Associated deployment ID ↳ integrationId string Associated integration ID ↳ externalId string External identifier ↳ detailsUrl string URL with details about the check ↳ path string Page path being checked ↳ rerequestable boolean Whether the check can be rerequested ↳ createdAt number Creation timestamp ↳ updatedAt number Last update timestamp ↳ startedAt number Start timestamp ↳ completedAt number Completion timestamp ↳ output json Check result output including metrics countnumber Total number of checks
Update an existing deployment check
Inputs and outputsParameter Type Required Description apiKeystring Yes Vercel Access Token deploymentIdstring Yes Deployment ID the check belongs to checkIdstring Yes Check ID to update namestring No Updated name of the check statusstring No Updated status: running or completed conclusionstring No Check conclusion: canceled, failed, neutral, succeeded, or skipped detailsUrlstring No URL with details about the check externalIdstring No External identifier for the check pathstring No Page path being checked outputstring No JSON string with check output metrics teamIdstring No Team ID to scope the request slugstring No Team slug to scope the request (alternative to teamId)
Parameter Type Description idstring Check ID namestring Check name statusstring Check status: registered, running, or completed conclusionstring Check conclusion: canceled, failed, neutral, succeeded, skipped, or stale blockingboolean Whether the check blocks the deployment deploymentIdstring Associated deployment ID integrationIdstring Associated integration ID externalIdstring External identifier detailsUrlstring URL with details about the check pathstring Page path being checked rerequestableboolean Whether the check can be rerequested createdAtnumber Creation timestamp in milliseconds updatedAtnumber Last update timestamp in milliseconds startedAtnumber Start timestamp in milliseconds completedAtnumber Completion timestamp in milliseconds outputjson Check result output including metrics (FCP, LCP, CLS, TBT, virtualExperienceScore)
Rerequest a deployment check
Inputs and outputsParameter Type Required Description apiKeystring Yes Vercel Access Token deploymentIdstring Yes Deployment ID the check belongs to checkIdstring Yes Check ID to rerequest teamIdstring No Team ID to scope the request slugstring No Team slug to scope the request (alternative to teamId) autoUpdateboolean No Whether to mark the check as running immediately on rerequest
Parameter Type Description rerequestedboolean Whether the check was successfully rerequested
List all teams in a Vercel account
Inputs and outputsParameter Type Required Description apiKeystring Yes Vercel Access Token limitnumber No Maximum number of teams to return sincenumber No Timestamp in milliseconds to only include teams created since then untilnumber No Timestamp in milliseconds to only include teams created until then
Parameter Type Description teamsarray List of teams ↳ id string Team ID ↳ slug string Team slug ↳ name string Team name ↳ avatar string Avatar file ID ↳ description string Short team description ↳ stagingPrefix string Prefix used for staging deployments ↳ createdAt number Creation timestamp in milliseconds ↳ updatedAt number Last update timestamp in milliseconds ↳ creatorId string User ID of team creator ↳ membership object Current user membership details ↳ role string Membership role ↳ confirmed boolean Whether membership is confirmed ↳ created number Membership creation timestamp ↳ uid string User ID of the member ↳ teamId string Team ID countnumber Number of teams returned paginationobject Pagination information ↳ count number Items in current page ↳ next number Timestamp for next page request ↳ prev number Timestamp for previous page request
Get information about a specific Vercel team
Inputs and outputsParameter Type Required Description apiKeystring Yes Vercel Access Token teamIdstring Yes The team ID to retrieve
Parameter Type Description idstring Team ID slugstring Team slug namestring Team name avatarstring Avatar file ID descriptionstring Short team description stagingPrefixstring Prefix used for staging deployments createdAtnumber Creation timestamp in milliseconds updatedAtnumber Last update timestamp in milliseconds creatorIdstring User ID of team creator membershipobject Current user membership details ↳ uid string User ID of the member ↳ teamId string Team ID ↳ role string Membership role ↳ confirmed boolean Whether membership is confirmed ↳ created number Membership creation timestamp ↳ createdAt number Membership creation timestamp (milliseconds) ↳ accessRequestedAt number When access was requested ↳ teamRoles array Team role assignments ↳ teamPermissions array Team permission assignments
List all members of a Vercel team
Inputs and outputsParameter Type Required Description apiKeystring Yes Vercel Access Token teamIdstring Yes The team ID to list members for limitnumber No Maximum number of members to return rolestring No Filter by role (OWNER, MEMBER, DEVELOPER, SECURITY, BILLING, VIEWER, VIEWER_FOR_PLUS, CONTRIBUTOR) sincenumber No Timestamp in milliseconds to only include members added since then untilnumber No Timestamp in milliseconds to only include members added until then searchstring No Search team members by their name, username, and email
Parameter Type Description membersarray List of team members ↳ uid string Member user ID ↳ email string Member email ↳ username string Member username ↳ name string Member full name ↳ avatar string Avatar file ID ↳ role string Member role ↳ confirmed boolean Whether membership is confirmed ↳ createdAt number Join timestamp in milliseconds ↳ accessRequestedAt number When access was requested in milliseconds ↳ isEnterpriseManaged boolean Whether the member is enterprise managed ↳ joinedFrom object Origin of how the member joined ↳ origin string Join origin identifier countnumber Number of members returned paginationobject Pagination information ↳ hasNext boolean Whether there are more pages ↳ count number Items in current page ↳ next number Timestamp to request the next page ↳ prev number Timestamp to request the previous page
Get information about the authenticated Vercel user
Inputs and outputsParameter Type Required Description apiKeystring Yes Vercel Access Token
Parameter Type Description idstring User ID emailstring User email usernamestring Username namestring Display name avatarstring SHA1 hash of the avatar defaultTeamIdstring Default team ID createdAtnumber Account creation timestamp in milliseconds stagingPrefixstring Prefix for preview deployment URLs softBlockobject Account restriction details if blocked ↳ blockedAt number When the account was blocked ↳ reason string Reason for the block hasTrialAvailableboolean Whether a trial is available
A trigger starts a workflow when a supported event occurs in this service.
Trigger workflow when a deployment is canceled
Configuration and outputsParameter Type Required Description apiKeystring Yes Required to create the webhook in Vercel. teamIdstring No Scope webhook to a specific team filterProjectIdsstring No Limit webhook to specific projects
Parameter Type Description typestring Event type (e.g., deployment.created) idstring Unique webhook delivery ID (string) createdAtnumber Event timestamp in milliseconds regionstring Region where the event occurred payloadjson Raw event payload from Vercel linksobject ↳ deployment string Vercel Dashboard URL for the deployment ↳ project string Vercel Dashboard URL for the project regionsjson Regions associated with the deployment (array), when provided by Vercel deploymentobject ↳ id string Deployment ID ↳ url string Deployment URL ↳ name string Deployment name ↳ meta json Deployment metadata map (e.g. Git metadata), per Vercel Webhooks API projectobject ↳ id string Project ID ↳ name string Project name teamobject ↳ id string Team ID userobject ↳ id string User ID targetstring Deployment target (production, staging, or preview) planstring Account plan type domainobject ↳ name string Domain name ↳ delegated boolean Whether the domain was delegated/shared when present on the payload
Trigger workflow when a new deployment is created
Configuration and outputsParameter Type Required Description apiKeystring Yes Required to create the webhook in Vercel. teamIdstring No Scope webhook to a specific team filterProjectIdsstring No Limit webhook to specific projects
Parameter Type Description typestring Event type (e.g., deployment.created) idstring Unique webhook delivery ID (string) createdAtnumber Event timestamp in milliseconds regionstring Region where the event occurred payloadjson Raw event payload from Vercel linksobject ↳ deployment string Vercel Dashboard URL for the deployment ↳ project string Vercel Dashboard URL for the project regionsjson Regions associated with the deployment (array), when provided by Vercel deploymentobject ↳ id string Deployment ID ↳ url string Deployment URL ↳ name string Deployment name ↳ meta json Deployment metadata map (e.g. Git metadata), per Vercel Webhooks API projectobject ↳ id string Project ID ↳ name string Project name teamobject ↳ id string Team ID userobject ↳ id string User ID targetstring Deployment target (production, staging, or preview) planstring Account plan type domainobject ↳ name string Domain name ↳ delegated boolean Whether the domain was delegated/shared when present on the payload
Trigger workflow when a deployment fails
Configuration and outputsParameter Type Required Description apiKeystring Yes Required to create the webhook in Vercel. teamIdstring No Scope webhook to a specific team filterProjectIdsstring No Limit webhook to specific projects
Parameter Type Description typestring Event type (e.g., deployment.created) idstring Unique webhook delivery ID (string) createdAtnumber Event timestamp in milliseconds regionstring Region where the event occurred payloadjson Raw event payload from Vercel linksobject ↳ deployment string Vercel Dashboard URL for the deployment ↳ project string Vercel Dashboard URL for the project regionsjson Regions associated with the deployment (array), when provided by Vercel deploymentobject ↳ id string Deployment ID ↳ url string Deployment URL ↳ name string Deployment name ↳ meta json Deployment metadata map (e.g. Git metadata), per Vercel Webhooks API projectobject ↳ id string Project ID ↳ name string Project name teamobject ↳ id string Team ID userobject ↳ id string User ID targetstring Deployment target (production, staging, or preview) planstring Account plan type domainobject ↳ name string Domain name ↳ delegated boolean Whether the domain was delegated/shared when present on the payload
Trigger workflow when a deployment is ready to serve traffic
Configuration and outputsParameter Type Required Description apiKeystring Yes Required to create the webhook in Vercel. teamIdstring No Scope webhook to a specific team filterProjectIdsstring No Limit webhook to specific projects
Parameter Type Description typestring Event type (e.g., deployment.created) idstring Unique webhook delivery ID (string) createdAtnumber Event timestamp in milliseconds regionstring Region where the event occurred payloadjson Raw event payload from Vercel linksobject ↳ deployment string Vercel Dashboard URL for the deployment ↳ project string Vercel Dashboard URL for the project regionsjson Regions associated with the deployment (array), when provided by Vercel deploymentobject ↳ id string Deployment ID ↳ url string Deployment URL ↳ name string Deployment name ↳ meta json Deployment metadata map (e.g. Git metadata), per Vercel Webhooks API projectobject ↳ id string Project ID ↳ name string Project name teamobject ↳ id string Team ID userobject ↳ id string User ID targetstring Deployment target (production, staging, or preview) planstring Account plan type domainobject ↳ name string Domain name ↳ delegated boolean Whether the domain was delegated/shared when present on the payload
Trigger workflow when a domain is created
Configuration and outputsParameter Type Required Description apiKeystring Yes Required to create the webhook in Vercel. teamIdstring No Scope webhook to a specific team filterProjectIdsstring No Limit webhook to specific projects
Parameter Type Description typestring Event type (e.g., deployment.created) idstring Unique webhook delivery ID (string) createdAtnumber Event timestamp in milliseconds regionstring Region where the event occurred payloadjson Raw event payload from Vercel linksobject ↳ deployment string Vercel Dashboard URL for the deployment ↳ project string Vercel Dashboard URL for the project regionsjson Regions associated with the deployment (array), when provided by Vercel deploymentobject ↳ id string Deployment ID ↳ url string Deployment URL ↳ name string Deployment name ↳ meta json Deployment metadata map (e.g. Git metadata), per Vercel Webhooks API targetstring Deployment target (production, staging, or preview) planstring Account plan type domainobject ↳ name string Domain name ↳ delegated boolean Whether the domain was delegated/shared (domain.created), per Vercel Webhooks API projectobject ↳ id string Project ID teamobject ↳ id string Team ID userobject ↳ id string User ID
Trigger workflow when a new project is created
Configuration and outputsParameter Type Required Description apiKeystring Yes Required to create the webhook in Vercel. teamIdstring No Scope webhook to a specific team filterProjectIdsstring No Limit webhook to specific projects
Parameter Type Description typestring Event type (e.g., deployment.created) idstring Unique webhook delivery ID (string) createdAtnumber Event timestamp in milliseconds regionstring Region where the event occurred payloadjson Raw event payload from Vercel linksobject ↳ deployment string Vercel Dashboard URL for the deployment ↳ project string Vercel Dashboard URL for the project regionsjson Regions associated with the deployment (array), when provided by Vercel deploymentobject ↳ id string Deployment ID ↳ url string Deployment URL ↳ name string Deployment name ↳ meta json Deployment metadata map (e.g. Git metadata), per Vercel Webhooks API projectobject ↳ id string Project ID ↳ name string Project name teamobject ↳ id string Team ID userobject ↳ id string User ID targetstring Deployment target (production, staging, or preview) planstring Account plan type domainobject ↳ name string Domain name ↳ delegated boolean Whether the domain was delegated/shared when present on the payload
Trigger workflow when a project is removed
Configuration and outputsParameter Type Required Description apiKeystring Yes Required to create the webhook in Vercel. teamIdstring No Scope webhook to a specific team filterProjectIdsstring No Limit webhook to specific projects
Parameter Type Description typestring Event type (e.g., deployment.created) idstring Unique webhook delivery ID (string) createdAtnumber Event timestamp in milliseconds regionstring Region where the event occurred payloadjson Raw event payload from Vercel linksobject ↳ deployment string Vercel Dashboard URL for the deployment ↳ project string Vercel Dashboard URL for the project regionsjson Regions associated with the deployment (array), when provided by Vercel deploymentobject ↳ id string Deployment ID ↳ url string Deployment URL ↳ name string Deployment name ↳ meta json Deployment metadata map (e.g. Git metadata), per Vercel Webhooks API projectobject ↳ id string Project ID ↳ name string Project name teamobject ↳ id string Team ID userobject ↳ id string User ID targetstring Deployment target (production, staging, or preview) planstring Account plan type domainobject ↳ name string Domain name ↳ delegated boolean Whether the domain was delegated/shared when present on the payload
Trigger on a curated set of common Vercel events (deployments, projects, domains, edge config). Pick a specific trigger to listen to one event type only.
Configuration and outputsParameter Type Required Description apiKeystring Yes Required to create the webhook in Vercel. teamIdstring No Scope webhook to a specific team filterProjectIdsstring No Limit webhook to specific projects
Parameter Type Description typestring Event type (e.g., deployment.created) idstring Unique webhook delivery ID (string) createdAtnumber Event timestamp in milliseconds regionstring Region where the event occurred payloadjson Full event payload linksobject ↳ deployment string Vercel Dashboard URL for the deployment ↳ project string Vercel Dashboard URL for the project regionsjson Regions associated with the deployment (array), when provided by Vercel deploymentobject ↳ id string Deployment ID ↳ url string Deployment URL ↳ name string Deployment name ↳ meta json Deployment metadata map (e.g. Git metadata), per Vercel Webhooks API projectobject ↳ id string Project ID ↳ name string Project name teamobject ↳ id string Team ID userobject ↳ id string User ID targetstring Deployment target (production, staging, or preview) planstring Account plan type domainobject ↳ name string Domain name ↳ delegated boolean Whether the domain was delegated/shared when present on the payload