--- title: Create a new Site --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/python) [Magic Transit](https://developers.cloudflare.com/api/python/resources/magic_transit) [Sites](https://developers.cloudflare.com/api/python/resources/magic_transit/subresources/sites) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Create a new Site magic\_transit.sites.create(SiteCreateParams\*\*kwargs) -> [Site]() POST/accounts/{account\_id}/magic/sites Creates a new Site ##### 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` ##### ParametersExpand Collapse account\_id: str Identifier maxLength32 [Link to this property](<#(resource)%20magic_transit.sites%20%3E%20(method)%20create%20%3E%20(params)%20default%20%3E%20(param)%20account_id%20%3E%20(schema)>) name: str The name of the site. [Link to this property](<#(resource)%20magic_transit.sites%20%3E%20(method)%20create%20%3E%20(params)%20default%20%3E%20(param)%20name%20%3E%20(schema)>) connector\_id: Optional\[str] Magic Connector identifier tag. [Link to this property](<#(resource)%20magic_transit.sites%20%3E%20(method)%20create%20%3E%20(params)%20default%20%3E%20(param)%20connector_id%20%3E%20(schema)>) description: Optional\[str] [Link to this property](<#(resource)%20magic_transit.sites%20%3E%20(method)%20create%20%3E%20(params)%20default%20%3E%20(param)%20description%20%3E%20(schema)>) ha\_mode: Optional\[[bool]()] Site high availability mode. If set to true, the site can have two connectors and runs in high availability mode. [Link to this property](<#(resource)%20magic_transit.sites%20%3E%20(method)%20create%20%3E%20(params)%20default%20%3E%20(param)%20ha_mode%20%3E%20(schema)>)
location: Optional\[SiteLocationParam] Location of site in latitude and longitude. lat: Optional\[str] Latitude Link to this property lon: Optional\[str] Longitude Link to this property
[Link to this property](<#(resource)%20magic_transit.sites%20%3E%20(method)%20create%20%3E%20(params)%20default%20%3E%20(param)%20location%20%3E%20(schema)>) secondary\_connector\_id: Optional\[str] Magic Connector identifier tag. Used when high availability mode is on. [Link to this property](<#(resource)%20magic_transit.sites%20%3E%20(method)%20create%20%3E%20(params)%20default%20%3E%20(param)%20secondary_connector_id%20%3E%20(schema)>) ##### ReturnsExpand Collapse
class Site: … id: Optional\[str] Identifier maxLength32 Link to this property connector\_id: Optional\[str] Magic Connector identifier tag. Link to this property description: Optional\[str] Link to this property ha\_mode: Optional\[bool] Site high availability mode. If set to true, the site can have two connectors and runs in high availability mode. Link to this property
location: Optional\[SiteLocation] Location of site in latitude and longitude. lat: Optional\[str] Latitude Link to this property lon: Optional\[str] Longitude Link to this property
Link to this property name: Optional\[str] The name of the site. Link to this property secondary\_connector\_id: Optional\[str] Magic Connector identifier tag. Used when high availability mode is on. Link to this property
[Link to this property](<#(resource)%20magic_transit.sites%20%3E%20(model)%20site%20%3E%20(schema)>) ### Create a new Site Python HTTPTypeScriptPythonGoTerraform ``` import os from cloudflare import Cloudflare client = Cloudflare( api_token=os.environ.get("CLOUDFLARE_API_TOKEN"), # This is the default and can be omitted ) site = client.magic_transit.sites.create( account_id="023e105f4ecef8ad9ca31a8372d0c353", name="site_1", ) print(site.id) ``` 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": { "id": "023e105f4ecef8ad9ca31a8372d0c353", "connector_id": "ac60d3d0435248289d446cedd870bcf4", "description": "description", "ha_mode": true, "location": { "lat": "37.6192", "lon": "122.3816" }, "name": "site_1", "secondary_connector_id": "8d67040d3835dbcf46ce29da440dc482" }, "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": { "id": "023e105f4ecef8ad9ca31a8372d0c353", "connector_id": "ac60d3d0435248289d446cedd870bcf4", "description": "description", "ha_mode": true, "location": { "lat": "37.6192", "lon": "122.3816" }, "name": "site_1", "secondary_connector_id": "8d67040d3835dbcf46ce29da440dc482" }, "success": true } ```