Create GRE tunnels

POST

https://api.cloudflare.com/client/v4/accounts/{account_identifier}/magic/gre_tunnels

Last modified:2022-12-16 13:48:33

Creates new GRE tunnels. Use ?validate_only=true as an optional query parameter to only run validation without persisting changes.

Request

Path Params

account_identifier

string

required

Body Params application/json

No schema defined

Example

{}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.cloudflare.com/client/v4/accounts//magic/gre_tunnels' \
--header 'Content-Type: application/json' \
--data-raw '{}'

Responses

🟢200Create GRE tunnels response

application/json

Body

allOf {2}

optional

object (api-response-single)

optional

errors

array [object {2}]

messages

required

Example:

[]

messages

array [object {2}]

messages

required

Example:

[]

result

required

success

enum<boolean>

required

Whether the API call was successful

Allowed value:

true

Example:

true

object

optional

result

object

optional

Example

{
    "errors": [],
    "messages": [],
    "result": {
        "gre_tunnels": [
            {
                "cloudflare_gre_endpoint": "203.0.113.1",
                "created_on": "2017-06-14T00:00:00Z",
                "customer_gre_endpoint": "203.0.113.1",
                "description": "Tunnel for ISP X",
                "health_check": {
                    "enabled": true,
                    "target": "203.0.113.1",
                    "type": "request"
                },
                "id": "c4a7362d577a6c3019a474fd6f485821",
                "interface_address": "192.0.2.0/31",
                "modified_on": "2017-06-14T05:20:00Z",
                "mtu": 1476,
                "name": "GRE_1",
                "ttl": 64
            }
        ]
    },
    "success": true
}

🟢200Create GRE tunnels response failure

Modified at 2022-12-16 13:48:33

List GRE tunnels

Update multiple GRE tunnels