Skip to main content
POST
Create an optimized post

Authorizations

Authorization
string
header
required

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

Headers

Idempotency-Key
string

A UUID. When present, deduplicates repeat submissions. See /api-reference/idempotency.

Body

application/json
format
enum<string>
default:image
required

text is the words alone (X and LinkedIn); image is the words with one picture, drawn by AI unless you send source_image_urls. Default image: a picture lifts engagement.

Available options:
text,
image
written_for
enum<string>

The network the post is written for. Its competitors are studied there, and its writer learns from the posts that did best and worst for accounts like yours on it: the post models' dataset for x and linkedin, and Instagram itself, read live, for instagram (which takes no text post). Omit to write one post for X and LinkedIn at once.

Available options:
x,
linkedin,
instagram
brief
string

What the post should be about, in a sentence or two: the subject, the audience and the feel.

Required string length: 1 - 1000
title
string

Your name for the post. Omit it and one is written.

Required string length: 1 - 100
language
enum<string>

The language the post is written in, as a code (en, es, fr, ...). Default en.

Available options:
en,
en-GB,
en-AU,
es,
es-ES,
fr,
fr-CA,
de,
it,
pt-BR,
pt,
nl,
pl,
sv,
da,
no,
fi,
cs,
el,
hu,
ro,
ru,
uk,
tr,
ar,
he,
hi,
zh,
zh-Hant,
zh-TW,
zh-Hans-TW,
yue,
yue-Hans,
ja,
ko,
id,
ms,
fil,
vi,
th
source_url
string<uri>

The business's website. Omit to use the one saved in the workspace's marketing profile.

source_text
string

A description of the business, product or offer, in your words

Required string length: 1 - 5000
source_image_urls
string<uri>[]

Images already uploaded to LumisReach; an image post uses one of them instead of drawing one

Maximum array length: 10

Response

Success

data
object
required