---
title: "Create a custom stream target"
method: POST
path: "/stream_targets/custom"
tags: ["stream_targets"]
---

# Create a custom stream target

`POST /stream_targets/custom`

This operation creates a custom stream target for an external, third-party destination.

## Request body

- CustomStreamTargetCreateInput
  - `stream_target_custom` object, required
    - `name` string, required — A descriptive name for the custom stream target. Maximum 255 characters.
    - `primary_url` string, required — The primary RTMP ingest URL. Hostnames can't contain underscores.
    - `provider` 'akamai_cupertino' | 'rtmp' | 'rtmps', required — The CDN for the target.
    - `stream_name` string, required — The name of the stream as defined in the target's ingestion settings. The protocol, host name, and path components of the stream name URL must be 255 characters or less. The query strings and parameter components of the stream name URL must be 1024 characters or less.
    - `backup_url` string — The backup RTMP ingest URL of the custom stream target. Not all providers or third-party CDNs provide backup URLs. Not for use with the akamai_cuptertino custom *provider*. **Note:** When both the primary and backup URLs are used, Wowza Video sends the stream to both URLs, allowing a provider or 3rd party CDN to improve reliability and prevent playback disruption. If you want to use both URLs, make sure you add the stream target to the output rendition twice, once with *use_stream_target_backup_url* as **false** (the default) and once with *use_stream_target_backup_url* as **true**. See <a href="https://api.docs.video.wowza.com/index/current/tag/transcoders/#tag/transcoders/operation/createTranscoderOutputOutputStreamTarget">POST /transcoders/[ID]/outputs/[ID]/output_stream_targets</a> for more information. **Example:** <code>"backup_url": "rtmp://b.ep337857.i.akamaientrypoint.net/EntryPoint"</code>
    - `playback_urls` object — Web addresses that the target uses to play streams. Available from version 1.7. **Example:** See response body sample
      - `hls` string — Web address that the target uses to play HLS streams. <br/><br/> The format is a hash where the key is **hls** and the value is the playback URL. <br/>Example&#58; "hls":&nbsp;"http&#58;//&lt;*domain*&gt;/master.m3u8"
      - `hds` string — Web address that the target uses to play HDS streams. Not for use with the akamai_cupertino custom *provider*. <br/><br/>The format is a hash where the key is **hds** and the value is the playback URL. <br/>Example&#58; "hds":&nbsp;"http&#58;//&lt;*domain*&gt;/manifest.f4m"
      - `rtmp` string — Web address that the target uses to play RTMP streams. <br/><br/>The format is a hash where the key is **rtmp** and the value is the playback URL. <br/>Example&#58; "rtmp":&nbsp;"rtmp&#58;//cp319499.live.edgefcs.net/live/c9467d50@337857"
    - `password` string — A *username* must also be present. The password associated with the target username for RTMP authentication. Not for use with the akamai_cupertino custom *provider*. **Example:** <code>"password": "cb1e77e98d"</code>
    - `username` string — The username or ID that the target uses for RTMP authentication. Not for use with the akamai_cupertino custom *provider*.

## Response `201`

Success

- object
  - `stream_target_custom` StreamTargetCustom
    - `backup_url` string — The backup ingest URL for a custom stream target. Not for use with the akamai_cupertino custom *provider*.
    - `created_at` string, date-time — The date and time that the custom stream target was created.
    - `delivery_protocols` string[] — An array of the delivery protocols available for this stream target. Available from version 1.7.
    - `id` string — The unique alphanumeric string that identifies the custom stream target.
    - `name` string — A descriptive name for the custom stream target. Maximum 255 characters.
    - `password` string — A *username* must be present. The password associated with the target username for RTMP authentication. Not for use with the akamai_cupertino custom *provider*.
    - `playback_urls` object — Web addresses that the target uses to play streams. Available from version 1.7.
      - `hls` object[] — Web address that the target uses to play HLS streams.
        - `name` string — The name of the playback URL.
        - `url` string — The playback URL.
      - `hds` object[] — Web address that the target uses to play HDS streams. Not for use with the akamai_cupertino custom *provider*.
        - `name` string — The name of the playback URL.
        - `url` string — The playback URL.
      - `rtmp` object[] — Web address that the target uses to play RTMP streams.
        - `name` string — The name of the playback URL.
        - `url` string — The playback URL.
    - `primary_url` string — The primary ingest URL of the custom stream target.
    - `provider` string — The CDN for the target.
    - `stream_name` string — The name of the stream being ingested into the target.
    - `updated_at` string, date-time — The date and time that the custom stream target was updated.
    - `username` string — The username or ID that the target uses for RTMP authentication. Not for use with the akamai_cupertino custom *provider*.

## Other responses

- `401` — Unauthorized
- `422` — Unprocessable Entity

---

[API](https://skmtc.net/wowza/apis/wowza-video-rest-api-reference-documentation.md) · [All operations](https://skmtc.net/wowza/apis/wowza-video-rest-api-reference-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/wowza/wowza-video-rest-api-reference-documentation/versions/157b6f741f2a/schema)