Sign in

v52

OpenAPI 3.1.0raw.githubusercontent.com2026-07-311,1941,9384.1 MB
Virtual Cross Connects

Create a Virtual Cross Connect

Create a new Virtual Cross Connect.<br /><br />For AWS and GCE, you have the option of creating the primary connection first and the secondary connection later. You also have the option of disabling the primary and/or secondary connections at any time and later re-enabling them. With Azure, you do not have this option. Azure requires both the primary and secondary connections to be created at the same time and they can not be independantly disabled.

post/virtual_cross_connects

Request body

created_atstring

ISO 8601 formatted date-time indicating when the resource was created.

idstring uuid

Identifies the resource.

record_typestring

Identifies the type of the resource.

updated_atstring

ISO 8601 formatted date-time indicating when the resource was updated.

namestring

A user specified name for the interface.

network_idstring uuid required

The id of the network associated with the interface.

status'created' | 'provisioning' | 'provisioned' | 'deleting'

The current status of the interface deployment.

bandwidth_mbpsnumber

The desired throughput in Megabits per Second (Mbps) for your Virtual Cross Connect.<br /><br />The available bandwidths can be found using the /virtual_cross_connect_regions endpoint.

bgp_asnnumber required

The Border Gateway Protocol (BGP) Autonomous System Number (ASN). If null, value will be assigned by Telnyx.

cloud_provider'aws' | 'azure' | 'gce' required

The Virtual Private Cloud with which you would like to establish a cross connect.

cloud_provider_regionstring required

The region where your Virtual Private Cloud hosts are located.<br /><br />The available regions can be found using the /virtual_cross_connect_regions endpoint.

primary_bgp_keystring

The authentication key for BGP peer configuration.

primary_cloud_account_idstring required

The identifier for your Virtual Private Cloud. The number will be different based upon your Cloud provider.

primary_cloud_ipstring

The IP address assigned for your side of the Virtual Cross Connect.<br /><br />If none is provided, one will be generated for you.<br /><br />This value should be null for GCE as Google will only inform you of your assigned IP once the connection has been accepted.

primary_enabledboolean

Indicates whether the primary circuit is enabled. Setting this to false will disable the circuit.

primary_telnyx_ipstring

The IP address assigned to the Telnyx side of the Virtual Cross Connect.<br /><br />If none is provided, one will be generated for you.<br /><br />This value should be null for GCE as Google will only inform you of your assigned IP once the connection has been accepted.

secondary_bgp_keystring

The authentication key for BGP peer configuration.

secondary_cloud_account_idstring

The identifier for your Virtual Private Cloud. The number will be different based upon your Cloud provider.<br /><br />This attribute is only necessary for GCE.

secondary_cloud_ipstring

The IP address assigned for your side of the Virtual Cross Connect.<br /><br />If none is provided, one will be generated for you.<br /><br />This value should be null for GCE as Google will only inform you of your assigned IP once the connection has been accepted.

secondary_enabledboolean

Indicates whether the secondary circuit is enabled. Setting this to false will disable the circuit.

secondary_telnyx_ipstring

The IP address assigned to the Telnyx side of the Virtual Cross Connect.<br /><br />If none is provided, one will be generated for you.<br /><br />This value should be null for GCE as Google will only inform you of your assigned IP once the connection has been accepted.

region_codestring required

The region the interface should be deployed to.

Example request

{
  "created_at": "2018-02-02T22:25:27.521Z",
  "id": "6a09cdc3-8948-47f0-aa62-74ac943d6c58",
  "record_type": "virtual_cross_connect",
  "updated_at": "2018-02-02T22:25:27.521Z",
  "name": "test interface",
  "network_id": "6a09cdc3-8948-47f0-aa62-74ac943d6c58",
  "status": "provisioned",
  "bandwidth_mbps": 50,
  "bgp_asn": 1234,
  "cloud_provider": "aws",
  "cloud_provider_region": "us-east-1",
  "primary_bgp_key": "yFV4wEPtPVPfDUGLWiyQzwga",
  "primary_cloud_account_id": "123456789012",
  "primary_cloud_ip": "169.254.0.2",
  "primary_enabled": true,
  "primary_telnyx_ip": "169.254.0.1",
  "secondary_bgp_key": "ge1lONeK9RcA83uuWaw9DvZy",
  "secondary_cloud_ip": "169.254.0.4",
  "secondary_enabled": true,
  "secondary_telnyx_ip": "169.254.0.3",
  "region_code": "ashburn-va"
}

Response

Successful response

Example response

{
  "data": {
    "created_at": "2018-02-02T22:25:27.521Z",
    "id": "6a09cdc3-8948-47f0-aa62-74ac943d6c58",
    "record_type": "virtual_cross_connect",
    "updated_at": "2018-02-02T22:25:27.521Z",
    "name": "test interface",
    "network_id": "6a09cdc3-8948-47f0-aa62-74ac943d6c58",
    "status": "provisioned",
    "bandwidth_mbps": 50,
    "bgp_asn": 1234,
    "cloud_provider": "aws",
    "cloud_provider_region": "us-east-1",
    "primary_bgp_key": "yFV4wEPtPVPfDUGLWiyQzwga",
    "primary_cloud_account_id": "123456789012",
    "primary_cloud_ip": "169.254.0.2",
    "primary_enabled": true,
    "primary_telnyx_ip": "169.254.0.1",
    "secondary_bgp_key": "ge1lONeK9RcA83uuWaw9DvZy",
    "secondary_cloud_ip": "169.254.0.4",
    "secondary_enabled": true,
    "secondary_telnyx_ip": "169.254.0.3",
    "region_code": "ashburn-va",
    "region": {
      "code": "ashburn-va",
      "name": "Ashburn",
      "record_type": "region"
    }
  }
}