---
title: "POST /connect-peers"
method: POST
path: "/connect-peers"
---

# POST /connect-peers

`POST /connect-peers`

Creates a core network Connect peer for a specified core network connect attachment between a core network and an appliance. The peer address and transit gateway address must be the same IP address family (IPv4 or IPv6).

## Request body

- object
  - `ConnectAttachmentId` string, required — The ID of the connection attachment.
  - `CoreNetworkAddress` string — A Connect peer core network address.
  - `PeerAddress` string, required — The Connect peer address.
  - `BgpOptions` object — Describes the BGP options.
    - `PeerAsn` integer — The Peer ASN of the BGP.
  - `InsideCidrBlocks` ConstrainedString[], required — The inside IP addresses used for BGP peering.
  - `Tags` Tag[] — The tags associated with the peer request.
    - `Key` string — <p>The tag key.</p> <p>Constraints: Maximum length of 128 characters.</p>
    - `Value` string — <p>The tag value.</p> <p>Constraints: Maximum length of 256 characters.</p>
  - `ClientToken` string — The client token associated with the request.

## Response `200`

Success

- CreateConnectPeerResponse
  - `ConnectPeer` object — The response to the request.
    - `CoreNetworkId` string — The ID of a core network.
    - `ConnectAttachmentId` string — The ID of the attachment to connect.
    - `ConnectPeerId` string — The ID of the Connect peer.
    - `EdgeLocation` string — The Connect peer Regions where edges are located.
    - `State` 'CREATING' | 'FAILED' | 'AVAILABLE' | 'DELETING' — The state of the Connect peer.
    - `CreatedAt` string, date-time — The timestamp when the Connect peer was created.
    - `Configuration` object — The configuration of the Connect peer.
      - `CoreNetworkAddress` string — The IP address of a core network.
      - `PeerAddress` string — The IP address of the Connect peer.
      - `InsideCidrBlocks` ConstrainedString[] — The inside IP addresses used for a Connect peer configuration.
      - `Protocol` 'GRE' — The protocol used for a Connect peer configuration.
      - `BgpConfigurations` ConnectPeerBgpConfiguration[] — The Connect peer BGP configurations.
        - `CoreNetworkAsn` integer — The ASN of the Coret Network.
        - `PeerAsn` integer — The ASN of the Connect peer.
        - `CoreNetworkAddress` string — The address of a core network.
        - `PeerAddress` string — The address of a core network Connect peer.
    - `Tags` Tag[] — The list of key-value tags associated with the Connect peer.
      - `Key` string — <p>The tag key.</p> <p>Constraints: Maximum length of 128 characters.</p>
      - `Value` string — <p>The tag value.</p> <p>Constraints: Maximum length of 256 characters.</p>

## Other responses

- `480` — ValidationException
- `481` — AccessDeniedException
- `482` — ResourceNotFoundException
- `483` — ConflictException
- `484` — ThrottlingException
- `485` — InternalServerException

---

[API](https://skmtc.net/aws/apis/networkmanager.md) · [All operations](https://skmtc.net/aws/apis/networkmanager/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/networkmanager/versions/4ea0acef56bf/schema)