--- title: Create CF1 Sites --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api) [Magic Transit](https://developers.cloudflare.com/api/resources/magic_transit) [Cf1 Sites](https://developers.cloudflare.com/api/resources/magic_transit/subresources/cf1_sites) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Create CF1 Sites POST/accounts/{account\_id}/magic/cf1\_sites Creates new CF1 Sites for an account. Each site must have a unique name within the account. ##### 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 Identifier maxLength32 [Link to this property](<#(resource)%20magic_transit.cf1_sites%20%3E%20(method)%20create%20%3E%20(params)%20default%20%3E%20(param)%20account_id%20%3E%20(schema)>) ##### Body ParametersJSONExpand Collapse

body: array of Cf1Site { name, id, created\_on, 3 more }

name: string A human-provided name describing the CF1 Site that should be unique within the account. Link to this property id: optional string Identifier maxLength32 Link to this property created\_on: optional string formatdate-time Link to this property description: optional string A human-provided description of the CF1 Site. Link to this property

location: optional Cf1SiteLocation { lat, long, name }

lat: optional number Latitude of the CF1 Site. formatfloat Link to this property long: optional number Longitude of the CF1 Site. formatfloat Link to this property name: optional string Name of nearest town, city, or village. Link to this property

Link to this property modified\_on: optional string formatdate-time Link to this property

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

errors: array of ResponseInfo { code, message, documentation\_url, source }

code: number minimum1000 Link to this property message: string Link to this property documentation\_url: optional string Link to this property

source: optional object {pointer }

pointer: optional string Link to this property

Link to this property

[Link to this property](<#(resource)%20magic_transit.cf1_sites%20%3E%20(method)%20create%20%3E%20(network%20schema)%20%3E%20(property)%20errors>)

messages: array of ResponseInfo { code, message, documentation\_url, source }

code: number minimum1000 Link to this property message: string Link to this property documentation\_url: optional string Link to this property

source: optional object {pointer }

pointer: optional string Link to this property

Link to this property

[Link to this property](<#(resource)%20magic_transit.cf1_sites%20%3E%20(method)%20create%20%3E%20(network%20schema)%20%3E%20(property)%20messages>)

result: array of Cf1Site { name, id, created\_on, 3 more }

location: optional Cf1SiteLocation { lat, long, name }

Link to this property modified\_on: optional string formatdate-time Link to this property

[Link to this property](<#(resource)%20magic_transit.cf1_sites%20%3E%20(method)%20create%20%3E%20(network%20schema)%20%3E%20(property)%20result>) success: true Whether the API call was successful [Link to this property](<#(resource)%20magic_transit.cf1_sites%20%3E%20(method)%20create%20%3E%20(network%20schema)%20%3E%20(property)%20success>) ### Create CF1 Sites HTTP HTTPTypeScriptPythonGoTerraform ``` curl https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/magic/cf1_sites \ -H 'Content-Type: application/json' \ -H "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \ -d '[ { "name": "Pad 34", "description": "Launch Pad 34", "location": { "lat": 28.521339842093845, "long": -80.56092644815843, "name": "Cape Canaveral" } } ]' ``` 200 example ``` { "errors": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "messages": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "result": [ { "name": "Pad 34", "id": "023e105f4ecef8ad9ca31a8372d0c353", "created_on": "2019-12-27T18:11:19.117Z", "description": "Launch Pad 34", "location": { "lat": 28.521339842093845, "long": -80.56092644815843, "name": "Cape Canaveral" }, "modified_on": "2019-12-27T18:11:19.117Z" } ], "success": true } ``` ##### Returns Examples 200 example ``` { "errors": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "messages": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "result": [ { "name": "Pad 34", "id": "023e105f4ecef8ad9ca31a8372d0c353", "created_on": "2019-12-27T18:11:19.117Z", "description": "Launch Pad 34", "location": { "lat": 28.521339842093845, "long": -80.56092644815843, "name": "Cape Canaveral" }, "modified_on": "2019-12-27T18:11:19.117Z" } ], "success": true } ```