--- title: Create a Route --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/go) [Magic Transit](https://developers.cloudflare.com/api/go/resources/magic_transit) [Routes](https://developers.cloudflare.com/api/go/resources/magic_transit/subresources/routes) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Create a Route client.MagicTransit.Routes.New(ctx, params) (\*[RouteNewResponse](), error) POST/accounts/{account\_id}/magic/routes Creates a new Magic static route. Use `?validate_only=true` as an optional query parameter to run validation only without persisting changes. ##### 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
params RouteNewParams AccountID param.Field\[string] Path param: Identifier maxLength32 Link to this property Nexthop param.Field\[string] Body param: The next-hop IP Address for the static route. Link to this property Prefix param.Field\[string] Body param: IP Prefix in Classless Inter-Domain Routing format. Link to this property Priority param.Field\[int64] Body param: Priority of the static route. Link to this property Description param.Field\[string]Optional Body param: An optional human provided description of the static route. Link to this property Scope param.Field\[Scope]Optional Body param: Used only for ECMP routes. Link to this property Weight param.Field\[int64]Optional Body param: Optional weight of the ECMP scope - if provided. Link to this property
[Link to this property](<#(resource)%20magic_transit.routes%20%3E%20(method)%20create%20%3E%20(params)%20default>) ##### ReturnsExpand Collapse
type RouteNewResponse struct{…} ID string Identifier maxLength32 Link to this property Nexthop string The next-hop IP Address for the static route. Link to this property Prefix string IP Prefix in Classless Inter-Domain Routing format. Link to this property Priority int64 Priority of the static route. Link to this property CreatedOn TimeOptional When the route was created. formatdate-time Link to this property Description stringOptional An optional human provided description of the static route. Link to this property ModifiedOn TimeOptional When the route was last modified. formatdate-time Link to this property
Scope ScopeOptional Used only for ECMP routes. ColoNames \[]stringOptional List of colo names for the ECMP scope. Link to this property ColoRegions \[]stringOptional List of colo regions for the ECMP scope. Link to this property
Link to this property Weight int64Optional Optional weight of the ECMP scope - if provided. Link to this property
[Link to this property](<#(resource)%20magic_transit.routes%20%3E%20(model)%20RouteNewResponse%20%3E%20(schema)>) ### Create a Route Go HTTPTypeScriptPythonGoTerraform ``` package main import ( "context" "fmt" "github.com/cloudflare/cloudflare-go" "github.com/cloudflare/cloudflare-go/magic_transit" "github.com/cloudflare/cloudflare-go/option" ) func main() { client := cloudflare.NewClient( option.WithAPIToken("Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY"), ) route, err := client.MagicTransit.Routes.New(context.TODO(), magic_transit.RouteNewParams{ AccountID: cloudflare.F("023e105f4ecef8ad9ca31a8372d0c353"), Nexthop: cloudflare.F("203.0.113.1"), Prefix: cloudflare.F("192.0.2.0/24"), Priority: cloudflare.F(int64(0)), }) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", route.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", "nexthop": "203.0.113.1", "prefix": "192.0.2.0/24", "priority": 0, "created_on": "2017-06-14T00:00:00Z", "description": "New route for new prefix 203.0.113.1", "modified_on": "2017-06-14T05:20:00Z", "scope": { "colo_names": [ "den01" ], "colo_regions": [ "APAC" ] }, "weight": 0 }, "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", "nexthop": "203.0.113.1", "prefix": "192.0.2.0/24", "priority": 0, "created_on": "2017-06-14T00:00:00Z", "description": "New route for new prefix 203.0.113.1", "modified_on": "2017-06-14T05:20:00Z", "scope": { "colo_names": [ "den01" ], "colo_regions": [ "APAC" ] }, "weight": 0 }, "success": true } ```