Skip to main content
POST
Manually create a new content engine record.

Authorizations

X-API-Key
string
header
required

Company API key - scoped to a specific company. Generate from the Integrations page in your dashboard.

Body

application/json

Content fields for the new record

Request body for manually creating a content engine record

companyId
string
required

Company ID

title
string
required

Content title

type
string
required

Content type. One of: blog_post, facebook_post, linkedin_post, instagram_post, x_post, youtube_video, tiktok_video, email_newsletter, podcast_episode, website_copy, marketing_email, ad_copy, press_release

status
string

Content status (default: draft). One of: ideated, generating, draft, scheduled, published, archived

category
string

Content category

topicSummary
string

Topic summary

hookOptions
string[]

List of hook options

selectedHook
string

Selected hook

funnelStage
string

Funnel stage: N/A, tofu, mofu, bofu

metaDescription
string

Meta description (used for SEO and social previews)

focusKeyword
string

Search phrase the post targets (blog posts only; blank for idea-only posts)

seoTitle
string

SERP , distinct from the article title (<=60 chars; blog posts only)

slug
string

Short URL slug for the published post (blog posts only)

variants
object

Content variants. Use {default: ''} to set the main body.

body
string

Convenience field for the main body. Stored at variants.default. Ignored if variants is provided.

publishDate
string

Planned publish date (ISO 8601 datetime)

publishedDate
string

Actual publish date when status is published (ISO 8601)

publishedUrl
string

Public URL of the published content

externalId
string

External platform identifier

platformType
string

Platform the content was published to (e.g., wordpress, linkedin)

campaignId
string

Campaign ID to associate this content with

Response

Created content record

Created content response

success
boolean

Operation success status

id
string

ID of the newly created content record

content
object

The full content object