---
title: Create a relay
---
[Skip to content](#_top)
[API Reference](https://developers.cloudflare.com/api)
[MoQ](https://developers.cloudflare.com/api/resources/moq)
[Relays](https://developers.cloudflare.com/api/resources/moq/subresources/relays)
Copy Markdown
Open in **Claude**Open in **ChatGPT**Open in **Cursor**
---
**Copy Markdown****View as Markdown**
# Create a relay
POST/accounts/{account\_id}/moq/relays
Provisions a new MoQ relay instance. Auto-creates a publish+subscribe token and a subscribe-only token. Token values are included in the response (shown once). Config is always set to defaults (upstreams off) and cannot be supplied here — sending a non-empty `config` is rejected (21014); `null` or `{}` is accepted as absent. Use PUT to configure the relay after it exists.
##### Security
API Token
The preferred authorization scheme for interacting with the Cloudflare API. [Create a token](https://developers.cloudflare.com/fundamentals/api/get-started/create-token/).
**Example:**`Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY`
##### P ath ParametersExpand Collapse
account\_id: string
Cloudflare account identifier.
[Link to this property](<#(resource)%20moq.relays%20%3E%20(method)%20create%20%3E%20(params)%20default%20%3E%20(param)%20account_id%20%3E%20(schema)>)
##### Body ParametersJSONExpand Collapse
name: string
Human-readable name for the relay.
minLength1
[Link to this property](<#(resource)%20moq.relays%20%3E%20(method)%20create%20%3E%20(params)%200%20%3E%20(param)%20name%20%3E%20(schema)>)
##### ReturnsExpand Collapse
errors: array of object {code, message }
code: optional number
Link to this property
message: optional string
Link to this property
[Link to this property](<#(resource)%20moq.relays%20%3E%20(method)%20create%20%3E%20(network%20schema)%20%3E%20(property)%20errors>)
messages: array of object {code, message }
code: optional number
Link to this property
message: optional string
Link to this property
[Link to this property](<#(resource)%20moq.relays%20%3E%20(method)%20create%20%3E%20(network%20schema)%20%3E%20(property)%20messages>)
success: boolean
[Link to this property](<#(resource)%20moq.relays%20%3E%20(method)%20create%20%3E%20(network%20schema)%20%3E%20(property)%20success>)
result: optional object {config, created, issuers, 3 more }
Relay with its auto-created default token pair (one full-access \[publish, subscribe] and one \[subscribe]-only), each with its one-time secret, wrapped in the issuers envelope.
config: object {upstreams }
upstreams: optional object {enabled, upstreams }
Upstreams are external MOQT server publishers that a relay falls back to when it has no local publisher for a requested namespace/track.
enabled: optional boolean
Link to this property
upstreams: optional array of object {url }
Ordered list of upstream MOQT server publishers. Each entry is an object (not a bare string) so per-upstream configuration can be added in the future without another breaking change.
url: string
Upstream MOQT server publisher URL. Must be an absolute URL with a host and a scheme the relay can dial: moqt:// (raw QUIC) or https:// (WebTransport). Validated on update (PUT); rejected with 21013.
formaturi
Link to this property
Link to this property
Link to this property
Link to this property
created: string
formatdate-time
Link to this property
issuers: array of object {cloudflare\_tokens, issuer, type }
Token collection (discriminated union on type). On create this holds the auto-created default pair, each including its one-time secret.
cloudflare\_tokens: array of object {created, expires, jti, 3 more }
Always present (\[] when empty).
created: string
formatdate-time
Link to this property
expires: string
Mandatory; no more than 1 year after created.
formatdate-time
Link to this property
jti: string
Token identity and registry key (32 hex chars).
Link to this property
operations: array of "publish"or "subscribe"
Signed allowlist of what the token may do. V1 coarse roles; the array form extends to fine-grained MoQT message names later without a breaking change.
One of the following:
"publish"
Link to this property
"subscribe"
Link to this property
Link to this property
label: optional string
Optional, customer-set.
Link to this property
secret: optional string
The signed JWT. Present ONLY in create / auto-create responses (shown once); never returned by list, never stored.
Link to this property
Link to this property
issuer: "cloudflare"
Link to this property
type: "cloudflare\_jwt"
Link to this property
Link to this property
modified: string
formatdate-time
Link to this property
name: string
Link to this property
uid: string
Server-generated unique identifier (32 hex chars).
Link to this property
[Link to this property](<#(resource)%20moq.relays%20%3E%20(method)%20create%20%3E%20(network%20schema)%20%3E%20(property)%20result>)
### Create a relay
HTTP
HTTPTypeScriptPythonGoTerraform
```
curl https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/moq/relays \
-H 'Content-Type: application/json' \
-H "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
-d '{
"name": "Production Live Stream"
}'
```
200 example
```
{
"errors": [
{
"code": 0,
"message": "message"
}
],
"messages": [
{
"code": 0,
"message": "message"
}
],
"success": true,
"result": {
"config": {
"upstreams": {
"enabled": true,
"upstreams": [
{
"url": "https://example.com"
}
]
}
},
"created": "2019-12-27T18:11:19.117Z",
"issuers": [
{
"cloudflare_tokens": [
{
"created": "2019-12-27T18:11:19.117Z",
"expires": "2019-12-27T18:11:19.117Z",
"jti": "f3a1b2c3d4e5f67890a1b2c3d4e5f678",
"operations": [
"publish",
"subscribe"
],
"label": "primary-encoder",
"secret": "eyJhbGciOiJFZDI1NTE5..."
}
],
"issuer": "cloudflare",
"type": "cloudflare_jwt"
}
],
"modified": "2019-12-27T18:11:19.117Z",
"name": "Production Live Stream",
"uid": "a1b2c3d4e5f67890a1b2c3d4e5f67890"
}
}
```
##### Returns Examples
200 example
```
{
"errors": [
{
"code": 0,
"message": "message"
}
],
"messages": [
{
"code": 0,
"message": "message"
}
],
"success": true,
"result": {
"config": {
"upstreams": {
"enabled": true,
"upstreams": [
{
"url": "https://example.com"
}
]
}
},
"created": "2019-12-27T18:11:19.117Z",
"issuers": [
{
"cloudflare_tokens": [
{
"created": "2019-12-27T18:11:19.117Z",
"expires": "2019-12-27T18:11:19.117Z",
"jti": "f3a1b2c3d4e5f67890a1b2c3d4e5f678",
"operations": [
"publish",
"subscribe"
],
"label": "primary-encoder",
"secret": "eyJhbGciOiJFZDI1NTE5..."
}
],
"issuer": "cloudflare",
"type": "cloudflare_jwt"
}
],
"modified": "2019-12-27T18:11:19.117Z",
"name": "Production Live Stream",
"uid": "a1b2c3d4e5f67890a1b2c3d4e5f67890"
}
}
```