--- title: Create a new CNI object --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api) [Network Interconnects](https://developers.cloudflare.com/api/resources/network_interconnects) [CNIs](https://developers.cloudflare.com/api/resources/network_interconnects/subresources/cnis) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Create a new CNI object POST/accounts/{account\_id}/cni/cnis Creates a new Cloud Network Interconnect (CNI) for private network connectivity between Cloudflare and your infrastructure. CNIs enable dedicated, high-performance network links. ##### 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.cnis%20%3E%20(method)%20create%20%3E%20(params)%20default%20%3E%20(param)%20account_id%20%3E%20(schema)>) ##### Body ParametersJSONExpand Collapse account: string Customer account tag [Link to this property](<#(resource)%20network_interconnects.cnis%20%3E%20(method)%20create%20%3E%20(params)%200%20%3E%20(param)%20account%20%3E%20(schema)>) interconnect: string [Link to this property](<#(resource)%20network_interconnects.cnis%20%3E%20(method)%20create%20%3E%20(params)%200%20%3E%20(param)%20interconnect%20%3E%20(schema)>)

magic: object {conduit\_name, description, mtu }

conduit\_name: string Link to this property description: string Link to this property mtu: number formatint32 minimum0 Link to this property

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

bgp: optional object {customer\_asn, extra\_prefixes, md5\_key }

customer\_asn: number ASN used on the customer end of the BGP session formatint32 minimum0 Link to this property extra\_prefixes: array of string Extra set of static prefixes to advertise to the customer’s end of the session Link to this property md5\_key: optional string MD5 key to use for session authentication. Note that *this is not a security measure*. MD5 is not a valid security mechanism, and the key is not treated as a secret value. This is *only* supported for preventing misconfiguration, not for defending against malicious attacks. The MD5 key, if set, must be of non-zero length and consist only of the following types of character: - ASCII alphanumerics: [a-zA-Z0-9] - Special characters in the set '!@#$%^&*()+[]{}<>/.,;:_-~= |\` In other words, MD5 keys may contain any printable ASCII character aside from newline (0x0A), quotation mark ("), vertical tab (0x0B), carriage return (0x0D), tab (0x09), form feed (0x0C), and the question mark (?). Requests specifying an MD5 key with one or more of these disallowed characters will be rejected. Link to this property

[Link to this property](<#(resource)%20network_interconnects.cnis%20%3E%20(method)%20create%20%3E%20(params)%200%20%3E%20(param)%20bgp%20%3E%20(schema)>) ##### ReturnsExpand Collapse id: string formatuuid [Link to this property](<#(resource)%20network_interconnects.cnis%20%3E%20(model)%20cni_create_response%20%3E%20(schema)%20%3E%20(property)%20id>) account: string Customer account tag [Link to this property](<#(resource)%20network_interconnects.cnis%20%3E%20(model)%20cni_create_response%20%3E%20(schema)%20%3E%20(property)%20account>) cust\_ip: string Customer end of the point-to-point link This should always be inside the same prefix as `p2p_ip`. formatA.B.C.D/N [Link to this property](<#(resource)%20network_interconnects.cnis%20%3E%20(model)%20cni_create_response%20%3E%20(schema)%20%3E%20(property)%20cust_ip>) interconnect: string Interconnect identifier hosting this CNI [Link to this property](<#(resource)%20network_interconnects.cnis%20%3E%20(model)%20cni_create_response%20%3E%20(schema)%20%3E%20(property)%20interconnect>)

magic: object {conduit\_name, description, mtu }

conduit\_name: string Link to this property description: string Link to this property mtu: number formatint32 minimum0 Link to this property

[Link to this property](<#(resource)%20network_interconnects.cnis%20%3E%20(model)%20cni_create_response%20%3E%20(schema)%20%3E%20(property)%20magic>) p2p\_ip: string Cloudflare end of the point-to-point link formatA.B.C.D/N [Link to this property](<#(resource)%20network_interconnects.cnis%20%3E%20(model)%20cni_create_response%20%3E%20(schema)%20%3E%20(property)%20p2p_ip>)

bgp: optional object {customer\_asn, extra\_prefixes, md5\_key }

[Link to this property](<#(resource)%20network_interconnects.cnis%20%3E%20(model)%20cni_create_response%20%3E%20(schema)%20%3E%20(property)%20bgp>)

bgp\_mode: optional "dynamic\_route\_exchange"or "advertise\_only" The BGP mode for a CNI. One of the following: - dynamic_route_exchange - advertise_only

One of the following: "dynamic\_route\_exchange" Link to this property "advertise\_only" Link to this property

[Link to this property](<#(resource)%20network_interconnects.cnis%20%3E%20(model)%20cni_create_response%20%3E%20(schema)%20%3E%20(property)%20bgp_mode>) ### Create a new CNI object HTTP HTTPTypeScriptPythonGoTerraform ``` curl https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/cni/cnis \ -H 'Content-Type: application/json' \ -H "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \ -d '{ "account": "account", "interconnect": "interconnect", "magic": { "conduit_name": "conduit_name", "description": "description", "mtu": 0 } }' ``` 200 example ``` { "id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e", "account": "account", "cust_ip": "192.168.3.4/31", "interconnect": "interconnect", "magic": { "conduit_name": "conduit_name", "description": "description", "mtu": 0 }, "p2p_ip": "192.168.3.4/31", "bgp": { "customer_asn": 0, "extra_prefixes": [ "192.168.3.4/31" ], "md5_key": "md5_key" }, "bgp_mode": "dynamic_route_exchange" } ``` ##### Returns Examples 200 example ``` { "id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e", "account": "account", "cust_ip": "192.168.3.4/31", "interconnect": "interconnect", "magic": { "conduit_name": "conduit_name", "description": "description", "mtu": 0 }, "p2p_ip": "192.168.3.4/31", "bgp": { "customer_asn": 0, "extra_prefixes": [ "192.168.3.4/31" ], "md5_key": "md5_key" }, "bgp_mode": "dynamic_route_exchange" } ```