---
title: "POST /transit-gateway-peerings"
method: POST
path: "/transit-gateway-peerings"
---

# POST /transit-gateway-peerings

`POST /transit-gateway-peerings`

Creates a transit gateway peering connection.

## Request body

- object
  - `CoreNetworkId` string, required — The ID of a core network.
  - `TransitGatewayArn` string, required — The ARN of the transit gateway for the peering request.
  - `Tags` Tag[] — The list of key-value tags associated with the 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

- CreateTransitGatewayPeeringResponse
  - `TransitGatewayPeering` object — Returns information about the transit gateway peering connection request.
    - `Peering` object — Describes a transit gateway peer connection.
      - `CoreNetworkId` string — The ID of the core network for the peering request.
      - `CoreNetworkArn` string — The ARN of a core network.
      - `PeeringId` string — The ID of the peering attachment.
      - `OwnerAccountId` string — The ID of the account owner.
      - `PeeringType` 'TRANSIT_GATEWAY' — The type of peering. This will be <code>TRANSIT_GATEWAY</code>.
      - `State` 'CREATING' | 'FAILED' | 'AVAILABLE' | 'DELETING' — The current state of the peering connection.
      - `EdgeLocation` string — The edge location for the peer.
      - `ResourceArn` string — The resource ARN of the peer.
      - `Tags` Tag[] — The list of key-value tags associated with the peering.
        - `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>
      - `CreatedAt` string, date-time — The timestamp when the attachment peer was created.
    - `TransitGatewayArn` string — The ARN of the transit gateway.
    - `TransitGatewayPeeringAttachmentId` string — The ID of the transit gateway peering attachment.

## 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/revisions/4ea0acef56bf/schema)