--- title: Create a new interconnect --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api) [Network Interconnects](https://developers.cloudflare.com/api/resources/network_interconnects) [Interconnects](https://developers.cloudflare.com/api/resources/network_interconnects/subresources/interconnects) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Create a new interconnect POST/accounts/{account\_id}/cni/interconnects Creates a new network interconnect for connecting Cloudflare’s network to external networks. Interconnects provide dedicated bandwidth and reduced latency for traffic exchange. ##### Security

API Token

The preferred authorization scheme for interacting with the Cloudflare API. Create a token. **Example:**Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY

API Email + API Key

The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key. **Example:**X-Auth-Email: user@example.com The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys. **Example:**X-Auth-Key: 144c9defac04969c7bfad8efaa8ea194

##### Accepted Permissions (at least one required) `Magic WAN Write``Magic Transit Write` ##### P ath ParametersExpand Collapse account\_id: string Customer account tag [Link to this property](<#(resource)%20network_interconnects.interconnects%20%3E%20(method)%20create%20%3E%20(params)%200%20%3E%20(param)%20account_id%20%3E%20(schema)>) ##### Body ParametersJSONExpand Collapse

body: object {account, slot\_id, type, speed } or object {account, bandwidth, pairing\_key, type }

One of the following:

NscInterconnectCreatePhysicalBody object {account, slot\_id, type, speed }

account: string Link to this property slot\_id: string formatuuid Link to this property type: string Link to this property speed: optional string Link to this property

Link to this property

NscInterconnectCreateGcpPartnerBody object {account, bandwidth, pairing\_key, type }

account: string Link to this property

bandwidth: "50M"or "100M"or "200M"or 9 more Bandwidth structure as visible through the customer-facing API.

One of the following: "50M" Link to this property "100M" Link to this property "200M" Link to this property "300M" Link to this property "400M" Link to this property "500M" Link to this property "1G" Link to this property "2G" Link to this property "5G" Link to this property "10G" Link to this property "20G" Link to this property "50G" Link to this property

Link to this property pairing\_key: string Pairing key provided by GCP Link to this property type: string Link to this property

Link to this property

[Link to this property](<#(resource)%20network_interconnects.interconnects%20%3E%20(method)%20create%20%3E%20(params)%200%20%3E%20(param)%20body%20%3E%20(schema)>) ##### ReturnsExpand Collapse

NscInterconnectPhysicalBody object {account, facility, name, 7 more }

account: string Link to this property

facility: object {address, name }

address: array of string Link to this property name: string Link to this property

Link to this property name: string Link to this property site: string A Cloudflare site name. Link to this property slot\_id: string formatuuid Link to this property speed: string Link to this property type: string Link to this property virtual\_port\_reservation\_id: string formatuuid Link to this property ccr\_device\_name: optional string Link to this property owner: optional string Link to this property

[Link to this property](<#(resource)%20network_interconnects.interconnects%20%3E%20(model)%20interconnect_create_response%20%3E%20(schema)%20%3E%20(variant)%200>)

NscInterconnectGcpPartnerBody object {account, name, region, 4 more }

account: string Link to this property name: string Link to this property region: string Link to this property type: string Link to this property virtual\_port\_reservation\_id: string formatuuid Link to this property owner: optional string Link to this property

speed: optional "50M"or "100M"or "200M"or 9 more Bandwidth structure as visible through the customer-facing API.

Link to this property

[Link to this property](<#(resource)%20network_interconnects.interconnects%20%3E%20(model)%20interconnect_create_response%20%3E%20(schema)%20%3E%20(variant)%201>) ### Create a new interconnect HTTP HTTPTypeScriptPythonGoTerraform ``` curl https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/cni/interconnects \ -H 'Content-Type: application/json' \ -H "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \ -d '{ "account": "account", "slot_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e", "type": "type" }' ``` 200 example ``` { "account": "account", "facility": { "address": [ "string" ], "name": "name" }, "name": "name", "site": "site", "slot_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e", "speed": "speed", "type": "type", "virtual_port_reservation_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e", "ccr_device_name": "ccr_device_name", "owner": "owner" } ``` ##### Returns Examples 200 example ``` { "account": "account", "facility": { "address": [ "string" ], "name": "name" }, "name": "name", "site": "site", "slot_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e", "speed": "speed", "type": "type", "virtual_port_reservation_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e", "ccr_device_name": "ccr_device_name", "owner": "owner" } ```