Skip to main content
POST
/
destinations
Create a custom RTMP destination.
curl --request POST \
  --url https://api.streamloop.app/v1/destinations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "rtmpKey": "<string>",
  "rtmpUrl": "<string>"
}
'
{
  "createdAt": "2023-11-07T05:31:56Z",
  "id": "<string>",
  "name": "<string>",
  "rtmpURL": "<string>",
  "rtmpUrlMasked": "<string>"
}

Authorizations

​
Authorization
string
header
required

OAuth 2.1 authorization-code flow with PKCE.

Headers

​
Idempotency-Key
string

Optional client-generated key. A repeated request with the same key replays the original response (within 24h) instead of re-executing — safe retries.

Body

application/json
​
name
string
required
​
rtmpKey
string
required
​
rtmpUrl
string
required

Response

Created.

​
createdAt
string<date-time>
required
​
id
string
required
​
kind
enum<string>
required
Available options:
custom_rtmp,
youtube
​
name
string
required
​
status
enum<string>
required
Available options:
active,
needs_reauth,
revoked,
disabled
​
rtmpURL
string | null

Full RTMP ingest URL, e.g. rtmp://live.twitch.tv/app. Null for non-rtmp kinds.

​
rtmpUrlMasked
string | null

Display-safe RTMP publish URL with the stream key redacted.