Skip to main content
POST
Create content

Authorizations

Authorization
string
header
required

Organization-scoped bearer credential: a customer API key (1club_sk_live_...) or an MCP OAuth access token.

Body

application/json
type
enum<string>
required
Available options:
post,
faq,
document,
block,
how-to-guide
title
string
required
slug
string

Derived from the title when omitted

contentBlocks
object[]

Editor.js blocks, e.g. [{ type: 'paragraph', data: { text: 'Hello' } }]

contentHtml
string

HTML body, as an alternative to contentBlocks

excerpt
string | null
tags
string[]
images
string[]

URLs from the media library - never invented URLs

imageNameQueries
string[]

Media library search terms, resolved to URLs and merged into images

status
enum<string>
Available options:
published,
draft
visibility
enum<string>
Available options:
Public,
Member_only,
Private
audience
object · null · null

Who may read it on the portal and website. Anyone outside it, signed-out visitors included, never sees it. Shared by every translation of the slug. Null or empty is everyone its visibility allows.

metaTitle
string | null

SEO title. Falls back to the item's title.

metaDescription
string | null

SEO description. Falls back to excerpt.

canonicalUrl
string<uri> | null

Absolute URL this item canonicalizes to, for content that also lives elsewhere and should be indexed there instead. Leave unset for original content - the page then canonicalizes to itself.

language
string | null

Locale code (bg, de, ...) marking this item as the variant of its slug for that language. Translations are separate items sharing one slug: send the same slug as the item you are translating, or the two are unrelated rows. Uniqueness is per (slug, language), so the same slug with a new language is accepted rather than de-duplicated. Leave unset for the base item, which every locale falls back to.

faqs
object[]

Posts only - the post's questions and answers, shown after its text in an accordion and described to search engines as FAQPage data. Plain text; blank lines separate an answer's paragraphs. A 400 for other types.

Maximum array length: 20

Response

The created content item

A content item (FAQ, post, document, block, or how-to guide) for the organization.

id
integer
organizationId
integer
title
string
slug
string
type
enum<string>
Available options:
faq,
post,
document,
block,
how-to-guide
status
string
visibility
enum<string>
Available options:
Public,
Member_only,
Private
audience
object · null · null

Who may read it on the portal and website. Anyone outside it, signed-out visitors included, never sees it. Shared by every translation of the slug. Null is everyone its visibility allows.

content
object

Body of the content item. May contain HTML, EditorJS blocks, a summary, and keywords.

excerpt
string | null
metaTitle
string | null
metaDescription
string | null
metaKeywords
string | null
canonicalUrl
string | null
template
string | null
layout
string | null
customFields
object | null
tags
string[]
summary
string | null
keywords
string[]
images
string[]
faqs
object[]

A post's questions and answers, shown after its text. Empty for other types.

authorId
integer | null
author
object | null
publishedAt
string<date-time> | null
language
string | null
createdAt
string<date-time>
updatedAt
string<date-time>