Skip to main content
POST
Create a creator collection

Authorizations

Authorization
string
header
required

OAuth 2.1 authorization code + PKCE (S256). Tokens are tenant-bound (company_id) and scoped. Discover endpoints via /.well-known/oauth-authorization-server.

Headers

Idempotency-Key
string

Client-chosen key; replaying the same key + body returns the original response, a different body returns 409.

Body

application/json
name
string
required
Minimum string length: 1
color
string
description
string

Response

Collection created.

data
object
required

A collection as returned when it is created. Deliberately a different shape from the list projection: it carries the stored record, so it includes description, createdAt, createdBy and companyId, and it does NOT include creatorCount or creatorIds - a new collection has no creators and those fields are absent rather than zero and empty.