Publishers

Create a publisher

Create a publisher under your publisher team account.

POST/api/publishers

Publishers represent the individual properties or apps under your team. Requests are authenticated with a publisher API token and are only available to publisher team accounts.

Body parameters

Name
name
Type
string
Required
required
Description
The display name of the publisher.
Name
reference_id
Type
string
Required
required
Description
A unique identifier for this publisher within your team. Max 64 characters. It cannot be changed after creation.

Headers

Name
Authorization
Type
string
Required
required
Description
Bearer [YOUR_API_TOKEN], using an API token generated from your Koah dashboard under Settings › API Tokens.
Name
Content-Type
Type
string
Required
required
Description
Must be application/json.

Response

Returns 201 Created with the new publisher.

Name
id
Type
string
Description
Unique identifier for the publisher.
Name
name
Type
string
Description
The display name of the publisher.
Name
reference_id
Type
string
Description
The identifier you provided for this publisher within your team.
Name
created_at
Type
string
Description
ISO 8601 timestamp of when the publisher was created.

Errors

Status	Error
`401`	`Unauthorized` — missing or invalid API token
`403`	`Forbidden` — not a publisher team account
`422`	`Unprocessable entity` — validation failed (e.g. missing name, duplicate `reference_id`)
`429`	`Rate limit exceeded` — max 10 requests per minute

curl -X POST https://app.koah.ai/api/publishers \
  -H "Authorization: Bearer [YOUR_API_TOKEN]" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My Publisher",
    "reference_id": "pub-001"
  }'

Response

{
  "id": "string-unique-identifier",
  "name": "My Publisher",
  "reference_id": "pub-001",
  "created_at": "2026-03-01T12:00:00Z"
}