---
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"
published: 2025-11-03
last_updated: 2025-11-10
authors: Sam Ko
related:
  - /docs/api
  - /docs/rest-api
install_vercel_plugin: npx plugins add vercel/vercel-plugin
---
<!-- docsgraph:related -->
## Related pages

> **For AI agents:** Follow these links to understand how this page connects to the rest of the Vercel ecosystem. For the full cross-link map (inbound, outbound, prerequisites, and semantic neighbors), see the .graph.md link below.

- [Add an existing domain to the Vercel platform](https://vercel.com/docs/rest-api/domains/add-an-existing-domain-to-the-vercel-platform?from=related)
- [Adding a Domain](https://vercel.com/docs/domains/working-with-domains/add-a-domain?from=related) — Learn how to add a custom domain to your Vercel project, verify it, and correctly set the DNS or Nameserver values.
- [Add a domain to a project](https://vercel.com/docs/rest-api/projects/add-a-domain-to-a-project?from=related)
- [Working with Domains](https://vercel.com/docs/domains/working-with-domains?from=related) — Learn how domains work and the options Vercel provides for managing them.
- [Set Up Custom Domain](https://vercel.com/docs/domains/set-up-custom-domain?from=related) — Add and configure a custom domain for your Vercel project using the CLI.
- [How do I add a custom domain to my Vercel project?](https://vercel.com/kb/guide/how-do-i-add-a-custom-domain-to-my-vercel-project?from=related) — Learn how to add a custom domain to your Vercel project.
- [How do I transfer my domain to Vercel?](https://vercel.com/kb/guide/how-do-i-transfer-my-domain-to-vercel?from=related) — Information on how to transfer a domain to Vercel.
- [How do I use a Vercel API Access Token?](https://vercel.com/kb/guide/how-do-i-use-a-vercel-api-access-token?from=related) — An Access Token is required in order to use the Vercel API. Tokens can be created and managed at the level of your accou
- [How can I move a domain to a Vercel team?](https://vercel.com/kb/guide/how-can-i-move-a-domain-to-a-team?from=related) — Information on how to move domains between accounts on Vercel.
- [How to Export Your Domain's DNS Records from Vercel](https://vercel.com/kb/guide/export-domain-dns-records-via-api?from=related) — Learn how to utilize our API to export your domain's DNS records from Vercel.

Full cross-link map for this page: [/kb/guide/how-do-i-add-a-domain-using-the-vercel-api.graph.md](/kb/guide/how-do-i-add-a-domain-using-the-vercel-api.graph.md)
<!-- /docsgraph:related -->


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.

```bash
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`.

```bash
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.

```bash
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.