---
title: "Create a PrivateLink endpoint"
method: POST
path: "/v1/networking/privatelink/endpoints"
tags: ["networking"]
---

# Create a PrivateLink endpoint

`POST /v1/networking/privatelink/endpoints`

Creates a PrivateLink endpoint for a project.

## Query parameters

- `teamId` string
- `slug` string

## Request body

- object
  - `projectId` string, required — The project ID to create the PrivateLink endpoint for.
  - `name` string, required — The name of the PrivateLink endpoint, used as its label in the Vercel dashboard.
  - `vercelRegion` string, required — The Vercel region to provision the endpoint in. Advanced Networking must be enabled for the project in that region. The endpoint service itself may live in another AWS region.
  - `awsServiceName` string, required — The name of the AWS VPC endpoint service to connect to. Its AWS region is read from the name; when that region differs from the one behind `vercelRegion`, the service must allow cross-region access.
  - `enablePrivateDns` boolean — Whether to resolve the endpoint service through its private DNS names, which are then returned in `privateDnsNames`. Defaults to `false`, in which case the endpoint is reachable through the DNS names in `awsDnsEntries`.

## Response `201`

The PrivateLink endpoint was created and is being provisioned.

- PrivateLinkEndpoint — A PrivateLink endpoint, which connects a project to an AWS VPC endpoint service in a single region so that traffic reaches the service over AWS PrivateLink rather than the public internet.
  - `endpointId` string, required — The unique identifier of the PrivateLink endpoint.
  - `name` string, required — The name of the PrivateLink endpoint, shown in the Vercel dashboard.
  - `teamId` string, required — The identifier of the team that owns the PrivateLink endpoint.
  - `projectId` string, required — The identifier of the project the PrivateLink endpoint belongs to.
  - `vercelRegion` string, required — The Vercel region the endpoint is provisioned in.
  - `awsServiceName` string, required — The AWS VPC endpoint service the endpoint connects to.
  - `vpcEndpointId` string — The identifier of the underlying AWS VPC endpoint. Absent until AWS has created the endpoint.
  - `awsDnsEntries` string[] — The regional DNS names assigned to the endpoint by AWS. Use these to reach the service when private DNS is not enabled.
  - `privateDnsNames` string[] — The private DNS names of the endpoint service, populated when private DNS is enabled for the endpoint.
  - `status` 'available' | 'creating' | 'deleting' | 'failed' | 'pending-acceptance' | 'provisioning' | 'rejected', required — The current state of the endpoint. - `creating`: the endpoint is being created. - `pending-acceptance`: waiting for the endpoint service owner to accept the connection. Only occurs for services that require manual acceptance. - `provisioning`: the connection was accepted and AWS is finishing setup. - `available`: the endpoint is fully provisioned and ready to use. - `rejected`: the endpoint service owner rejected the connection. - `failed`: the endpoint could not be provisioned. - `deleting`: the endpoint is being deleted.
  - `statusMessage` string — A human-readable explanation of why the endpoint could not be provisioned. Only set when `status` is `failed`, and absent for every other status including `rejected`, since AWS does not report a rejection reason.
  - `createdAt` number, required — Timestamp in milliseconds since the UNIX epoch for when the endpoint was created.
  - `updatedAt` number, required — Timestamp in milliseconds since the UNIX epoch for when the endpoint was last updated.

## Other responses

- `400` — One of the provided values in the request body is invalid.
- `401` — The request is not authorized.
- `403` — You do not have permission to access this resource.
- `404`
- `409`
- `410`

## Changes

- **2026-09-03** `7c947faac0ef` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/vercel/apis/api/changes/v1/networking/privatelink/endpoints/post.md)

---

[API](https://skmtc.dev/vercel/apis/api.md) · [All operations](https://skmtc.dev/vercel/apis/api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/vercel/api/revisions/f2c3b0a5aef3/schema)