---
title: "Create a new partner attachment"
method: POST
path: "/v2/partner_network_connect/attachments"
tags: ["DigitalOcean-public.v2-new_Partner Network Connect"]
---

# Create a new partner attachment

`POST /v2/partner_network_connect/attachments`

To create a new partner attachment, send a `POST` request to
`/v2/partner_network_connect/attachments` with a JSON object containing the
required configuration details.

## Request body

- PartnerAttachmentWritable
  - `name` string, required — The name of the partner attachment. Must be unique and may only contain alphanumeric characters, dashes, and periods.
  - `connection_bandwidth_in_mbps` 1000 | 2000 | 5000 | 10000, required — Bandwidth (in Mbps) of the connection.
  - `region` 'nyc' | 'sfo' | 'fra' | 'ams' | 'sgp', required — The region to create the partner attachment.
  - `naas_provider` string, required
  - `vpc_ids` string[], required — An array of VPCs IDs.
  - `parent_uuid` string — Optional associated partner attachment UUID
  - `bgp` object — Optional BGP configurations
    - `local_router_ip` string, required — IP of the DO router
    - `peer_router_ip` string, required — IP of the Naas Provider router
    - `peer_router_asn` integer, required — ASN of the peer router
    - `auth_key` string, required — BGP Auth Key
  - `redundancy_zone` 'MEGAPORT_BLUE' | 'MEGAPORT_RED' — Optional redundancy zone for the partner attachment.

## Response `202`

The response will be a JSON object with details about the partner attachment
including attached VPC network IDs and BGP configuration information

- object
  - `partner_attachment` PartnerAttachment
    - `id` string, string — A unique ID that can be used to identify and reference the partner attachment.
    - `name` string — The name of the partner attachment. Must be unique and may only contain alphanumeric characters, dashes, and periods.
    - `state` string — The current operational state of the attachment.
    - `connection_bandwidth_in_mbps` integer — The bandwidth (in Mbps) of the connection.
    - `region` string — The region where the partner attachment is located.
    - `naas_provider` string — The Network as a Service (NaaS) provider for the partner attachment.
    - `vpc_ids` string[] — An array of VPC network IDs.
    - `bgp` object — The BGP configuration for the partner attachment.
      - `local_asn` integer — ASN of the local router.
      - `peer_asn` integer — ASN of the peer router
      - `local_router_ip` string — IP of the DigitalOcean router
      - `peer_router_ip` string — IP of the peer router
    - `created_at` string, date-time — A time value given in ISO8601 combined date and time format.
    - `parent_uuid` string — Associated partner attachment UUID
    - `children` string[] — An array of associated partner attachment UUIDs.

## Other responses

- `401` — Authentication failed due to invalid credentials.
- `404` — The resource was not found.
- `422` — Unprocessable Entity
- `429` — The API rate limit has been exceeded.
- `500` — There was a server error.
- `default` — There was an unexpected error.

---

[API](https://skmtc.net/digitalocean/apis/digitalocean-api.md) · [All operations](https://skmtc.net/digitalocean/apis/digitalocean-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/digitalocean/digitalocean-api/revisions/cb3bf9b21459/schema)