Cloudflare API | Calls › TURN › Create A New TURN Key

API Reference

Account & User Management

Resource Sharing

AI

Certificate Management

Certificate Authorities

Client Certificates

Custom Certificates

Custom Hostnames

Keyless Certificates

MTLS Certificates

Origin CA Certificates

Origin Post Quantum Encryption

Origin TLS Client Auth

Cloudflare One

DNS

Account Custom Nameservers

Domain/Zone Management

IP Addresses

Media

Create a new TURN key

Delete TURN key

Retrieve TURN key details

Edit TURN key details

Networking

Magic Cloud Networking

Magic Network Monitoring

Network Interconnects

Observability

Security Center

Radar

Routing & Performance

Rules

Cloud Connector

Managed Transforms

URL Normalization

Security

Schema Validation

Content Scanning

Leaked Credential Checks

Storage & Databases

Threat Intelligence

Brand Protection

Workers & Pages

Browser Rendering

Durable Objects

Workers For Platforms

Shared

Calls

calls

SFU

calls.sfu

Methods

Create A New App -> Envelope<{ created, modified, name, 2 more... }>

post/accounts/{account_id}/calls/apps

Creates a new Cloudflare calls app. An app is an unique enviroment where each Session can access all Tracks within the app.

Delete App -> Envelope<{ created, modified, name, 1 more... }>

delete/accounts/{account_id}/calls/apps/{app_id}

Deletes an app from Cloudflare Calls

Retrieve App Details -> Envelope<{ created, modified, name, 1 more... }>

get/accounts/{account_id}/calls/apps/{app_id}

Fetches details for a single Calls app.

List Apps -> SinglePage<{ created, modified, name, 1 more... }>

get/accounts/{account_id}/calls/apps

Lists all apps in the Cloudflare account

Edit App Details -> Envelope<{ created, modified, name, 1 more... }>

put/accounts/{account_id}/calls/apps/{app_id}

Edit details for a single app.

TURN

calls.turn

Methods

Create A New TURN Key -> Envelope<{ created, key, modified, 2 more... }>

post/accounts/{account_id}/calls/turn_keys

Creates a new Cloudflare Calls TURN key.

Security

API Token

The preferred authorization scheme for interacting with the Cloudflare API. Create a token.

Example: Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY

Accepted Permissions (at least one required)

Calls Write

path Parameters

account_id: string

(maxLength: 32)

The account identifier tag.

Response fields

errors: Array<{ code, message, documentation_url, 1 more... }>

messages: Array<{ code, message, documentation_url, 1 more... }>

success: true

Whether the API call was successful.

result: { created, key, modified, 2 more... }

Optional

Request example

curl https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/calls/turn_keys \
    -H 'Content-Type: application/json' \
    -H "X-Auth-Email: $CLOUDFLARE_EMAIL" \
    -H "X-Auth-Key: $CLOUDFLARE_API_KEY" \
    -d '{
          "name": "my-turn-key"
        }'

200Example

{
  "errors": [
    {
      "code": 1000,
      "message": "message",
      "documentation_url": "documentation_url",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "messages": [
    {
      "code": 1000,
      "message": "message",
      "documentation_url": "documentation_url",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "success": true,
  "result": {
    "created": "2014-01-02T02:20:00Z",
    "key": "66bcf64aa8907b9f9d90ac17746a77ce394c393b92b3916633dc02846e608ad4",
    "modified": "2014-01-02T02:20:00Z",
    "name": "my-turn-key",
    "uid": "2a95132c15732412d22c1476fa83f27a"
  }
}

Delete TURN Key -> Envelope<{ created, modified, name, 1 more... }>

delete/accounts/{account_id}/calls/turn_keys/{key_id}

Deletes a TURN key from Cloudflare Calls

Retrieve TURN Key Details -> Envelope<{ created, modified, name, 1 more... }>

get/accounts/{account_id}/calls/turn_keys/{key_id}

Fetches details for a single TURN key.

List TURN Keys -> SinglePage<{ created, modified, name, 1 more... }>

get/accounts/{account_id}/calls/turn_keys

Lists all TURN keys in the Cloudflare account

Edit TURN Key Details -> Envelope<{ created, modified, name, 1 more... }>

put/accounts/{account_id}/calls/turn_keys/{key_id}

Edit details for a single TURN key.