Skip to main content
POST
Create Creator Brief

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

organization_id
string
required
workspace_id
string
required

Body

application/json
creator_id
string
required

The creator the brief is written for. Must be on the workspace's shortlist.

brand
string
required

The brand behind the partnership.

country
string
required

The country the partnership targets.

category
string
required

The category the brand wants to collaborate on.

product_url
string | null

An http(s) URL of the product to feature.

topics
string[] | null

The topics the brand wants to own.

title
string | null

Omitted or blank: the API names the brief {creator} – {brand} – {category} – {YYYY-MM-DD HH:mm} (UTC).

body
string
default:""

The brief as one markdown document.

ai_assisted
boolean
default:false

True when the assistant wrote the text the user is saving.

change_note
string
default:""
Maximum string length: 500

Response

Successful Response

id
string
required
workspace_id
string
required
creator_id
string
required
creator
CreatorSummaryResponse · object
required
title
string
required
body
string
required
brand
string
required
country
string
required
category
string
required
current_sequence
integer
required

Sequence of the latest version; a save that changed nothing keeps it.

created_by
string
required

Id of the user who created the brief.

created_at
string<date-time>
required
updated_by
string
required

Id of the user who saved the latest version.

updated_at
string<date-time>
required

When the latest version was saved.

product_url
string | null
topics
string[] | null