Create a new channel

post

https://api.primis.tech/api/v1/platform/channel/create

Create a channel. Requires Publisher Plus.

Keyword field name is keywords (not keyWords).

isPublic: Marked required in ChannelFields, but channel create drops required fields the caller cannot EDIT. Publisher / Publisher Plus have no EDIT on isPublic, so it is not required for those roles (omit it). Primis Admin / Account Manager must send isPublic.

Optional fields below (deleteAfterDays, level, rank, geo, dma, domains, domainTargeting, domainsAction, etc.) are included in the create schema for all roles (only required fields are permission-filtered). Create does not re-check field EDIT on write.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

name

string

required

Channel name (1–80 chars; no backslashes)

type

string

enum

required

Allowed:

contentCategory

integer

required

Primis content category id (integer; string ids are also accepted by the API)

languages

string

required

^[a-z]{2}$

ISO 639-1 language code (exactly 2 lowercase letters)

irisEnabled

integer

enum

required

Allowed:

contextualOutboundResults

integer

enum

required

Allowed:

isCaptionsOn

integer

enum

required

Allowed:

site

string

keywords

array of strings

Channel keywords (field name is keywords)

keywords

contributor

string

sourceUrlType

string

enum

Defaults to url

Type of channel source URL content

Allowed:

sourceUrl

string

status

string

enum

Allowed:

geoBlock

integer

Geo-block flag (numeric), not a string like Allow

isPublic

integer

enum

0 = private, 1 = public. Required for Admin/AM only; omit for Publisher / Publisher Plus (not present in their create schema).

Allowed:

deleteAfterDays

integer | null

≥ -1

Days until content deletion; omit/null for unlimited. Min -1.

level

string

enum

MRSS priority level

Allowed:

rank

integer

enum

Channel rank (API field rank, not folder_rank)

Allowed:

geo

array of strings

Geo localisation codes, or all

geo

dma

array of integers

DMA targeting codes (typically when geo includes US)

dma

domainTargeting

integer

enum

0 = allowlist, 1 = blocklist

Allowed:

domains

string

Domains list upload reference / CSV identifier used with domainsAction

domainsAction

string

enum

Action to apply with domains

Allowed:

Response

200Created channel id