---
title: How do I add a domain using the Vercel API?
description: Information on adding a domain using the Vercel API.
url: /kb/guide/how-do-i-add-a-domain-using-the-vercel-api
canonical_url: "https://vercel.com/kb/guide/how-do-i-add-a-domain-using-the-vercel-api"
last_updated: 2025-11-10
authors: Sam Ko
related:
  - /docs/api
  - /docs/rest-api
install_vercel_plugin: npx plugins add vercel/vercel-plugin
---

With the [Vercel API](https://vercel.com/docs/api), you can [add domains](https://vercel.com/docs/rest-api#endpoints/domains/register-or-transfer-in-a-new-domain) to your Vercel accounts by sending a [POST](https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods/POST) request to this endpoint: `https://api.vercel.com/v4/domains`. To test a POST request to this endpoint, you can use the [curl](https://curl.haxx.se/) command in the terminal. You will also need to add a [testing token](https://vercel.com/account/tokens) inside your POST request.

## Personal Account

Here is an example request for adding a domain to a Vercel personal account.

`curl -X POST "https://api.vercel.com/v4/domains" \ -H "Authorization: Bearer TOKEN" \ -H "Content-Type: application/json" \ -d '{ "name": "example.com" }'`

## Team Account

First, you will need to obtain the team ID using a GET request to this endpoint: `https://api.vercel.com/v1/teams`.

`curl"https://api.vercel.com/v1/teams"\ -H "Authorization: Bearer TOKEN"`

Here is an example request for adding a domain to a Vercel team account.

`curl -X POST "https://api.vercel.com/v4/domains?teamId=TEAM_ID" \ -H "Authorization: Bearer TOKEN" \ -H "Content-Type: application/json" \ -d '{ "name": "example.com" }'`

> **NOTE:** Make sure to completely replace **TOKEN** and **TEAM\_ID** with their respective token and ID before making a Vercel API request.