Make a text post (format: text) or a post with one picture (format: image) written to perform on the network it is for (written_for: x, linkedin or instagram). Unlike a slideshow from POST /v1/videos, which is written plainly from your sources, the post producer makes it start to finish, the way the dashboard’s Create Post > Generate Automatically does: it researches the business, its competitors on that network and the news, recommends five post ideas, picks the strongest, and writes it with the tuned writer, which learns from the posts that did best and worst for accounts like yours and keeps the best of five drafts. It runs in the background (usually a few minutes): this answers 201 with status: researching; poll GET /v1/optimized-posts/{id} until it is ready, then post it with POST /v1/videos/{video_id}/posts. It is charged once, when the post is made, like a video (included video credits first, then the prepaid balance): its picture and writing at cost plus 20%, and for instagram, reading Instagram for the writer. price_cents is the estimate until then. On the API & MCP plan and the Growth Marketing Manager hire it is charged; on Revenue Engine and Custom it is free; other plans get 403 plan_not_included.
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.
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.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"LumisReach","colors":{"primary":"#111827","light":"#d6d6d6","dark":"#111827"},"favicon":"https://mintcdn.com/lumis-labs/buUUrJV81nyLaiDT/favicon.png?fit=max\u0026auto=format\u0026n=buUUrJV81nyLaiDT\u0026q=85\u0026s=56327232f3ec8c84959027c8e5ec7585","api":{},"navbar":{"links":[{"href":"mailto:founders@lumisreach.com","label":"Contact Support"}],"primary":{"type":"button","label":"Get Started","href":"https://app.lumisreach.com"}},"footer":{"socials":{"x":"https://x.com/lumisreach","linkedin":"https://linkedin.com/company/lumisreach"}},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"lumis-labs","hasAudioNarration":false,"actualSubdomain":"lumis-labs","customDomains":["docs.lumisreach.com"],"gitSource":{"type":"github","owner":"lumisai","repo":"reach","deployBranch":"prod","contentDirectory":"apps/docs","isPrivate":true,"mountPath":"","label":""},"chroma":{"latestBuiltDeploymentHistoryId":"6ae06b6e07896b4595e15047","collectionId":"6d3c47c9-a732-4d73-b998-f87101bf1fe0","liveDeploymentHistoryId":"6ae06b6e07896b4595e15047","schemaVersion":"v3"},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6ae13005ffc995e58e8a46af","clientVersion":"0.0.3990","searchFilterCounts":[{"language":"default","tag":"API Reference","count":131},{"language":"default","tag":"Solutions","count":37},{"language":"default","tag":"Get Started","count":31},{"language":"default","tag":"Integrations","count":20},{"language":"default","tag":"Quick Agent Actions","count":14},{"language":"default","tag":"Videos","count":13},{"language":"default","tag":"Use Cases","count":10},{"language":"default","tag":"Calls, Texts and Contacts","count":9},{"language":"default","tag":"Concepts","count":9},{"language":"default","tag":"Enterprise Registration","count":9}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-v7-file-tree","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-nav-generations","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"isAtlas":false,"googleFontsInlined":false},"customCss":[{"filePath":"global.css","content":"sidebar-group:has(sidebar-group-header .sidebar-group-tag),sidebar-group:has(sidebar-group-header .tag),sidebar-group:has(sidebar-group-header [data-tag]){opacity:.45}"}],"page":{"pagePath":"api-reference/optimized-posts/create-an-optimized-post","slug":"/api-reference/optimized-posts/create-an-optimized-post","pageMetadata":{"title":"Create an optimized post","description":"Make a text post (`format: text`) or a post with one picture (`format: image`) written to perform on the network it is for (`written_for`: `x`, `linkedin` or `instagram`). Unlike a `slideshow` from `POST /v1/videos`, which is written plainly from your sources, the post producer makes it start to finish, the way the dashboard's Create Post > Generate Automatically does: it researches the business, its competitors on that network and the news, recommends five post ideas, picks the strongest, and writes it with the tuned writer, which learns from the posts that did best and worst for accounts like yours and keeps the best of five drafts. It runs in the background (usually a few minutes): this answers `201` with `status: researching`; poll `GET /v1/optimized-posts/{id}` until it is `ready`, then post it with `POST /v1/videos/{video_id}/posts`. It is charged once, when the post is made, like a video (included video credits first, then the prepaid balance): its picture and writing at cost plus 20%, and for `instagram`, reading Instagram for the writer. `price_cents` is the estimate until then. On the API \u0026 MCP plan and the Growth Marketing Manager hire it is charged; on Revenue Engine and Custom it is free; other plans get `403 plan_not_included`.","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/optimized-posts","href":"/api-reference/optimized-posts/create-an-optimized-post","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Make a text post (\", _jsx(_components.code, {\n children: \"format: text\"\n }), \") or a post with one picture (\", _jsx(_components.code, {\n children: \"format: image\"\n }), \") written to perform on the network it is for (\", _jsx(_components.code, {\n children: \"written_for\"\n }), \": \", _jsx(_components.code, {\n children: \"x\"\n }), \", \", _jsx(_components.code, {\n children: \"linkedin\"\n }), \" or \", _jsx(_components.code, {\n children: \"instagram\"\n }), \"). Unlike a \", _jsx(_components.code, {\n children: \"slideshow\"\n }), \" from \", _jsx(_components.code, {\n children: \"POST /v1/videos\"\n }), \", which is written plainly from your sources, the post producer makes it start to finish, the way the dashboard’s Create Post > Generate Automatically does: it researches the business, its competitors on that network and the news, recommends five post ideas, picks the strongest, and writes it with the tuned writer, which learns from the posts that did best and worst for accounts like yours and keeps the best of five drafts. It runs in the background (usually a few minutes): this answers \", _jsx(_components.code, {\n children: \"201\"\n }), \" with \", _jsx(_components.code, {\n children: \"status: researching\"\n }), \"; poll \", _jsx(_components.code, {\n children: \"GET /v1/optimized-posts/{id}\"\n }), \" until it is \", _jsx(_components.code, {\n children: \"ready\"\n }), \", then post it with \", _jsx(_components.code, {\n children: \"POST /v1/videos/{video_id}/posts\"\n }), \". It is charged once, when the post is made, like a video (included video credits first, then the prepaid balance): its picture and writing at cost plus 20%, and for \", _jsx(_components.code, {\n children: \"instagram\"\n }), \", reading Instagram for the writer. \", _jsx(_components.code, {\n children: \"price_cents\"\n }), \" is the estimate until then. On the API \u0026 MCP plan and the Growth Marketing Manager hire it is charged; on Revenue Engine and Custom it is free; other plans get \", _jsx(_components.code, {\n children: \"403 plan_not_included\"\n }), \".\"]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Create an optimized post","description":"Make a text post (`format: text`) or a post with one picture (`format: image`) written to perform on the network it is for (`written_for`: `x`, `linkedin` or `instagram`). Unlike a `slideshow` from `POST /v1/videos`, which is written plainly from your sources, the post producer makes it start to finish, the way the dashboard's Create Post > Generate Automatically does: it researches the business, its competitors on that network and the news, recommends five post ideas, picks the strongest, and writes it with the tuned writer, which learns from the posts that did best and worst for accounts like yours and keeps the best of five drafts. It runs in the background (usually a few minutes): this answers `201` with `status: researching`; poll `GET /v1/optimized-posts/{id}` until it is `ready`, then post it with `POST /v1/videos/{video_id}/posts`. It is charged once, when the post is made, like a video (included video credits first, then the prepaid balance): its picture and writing at cost plus 20%, and for `instagram`, reading Instagram for the writer. `price_cents` is the estimate until then. On the API \u0026 MCP plan and the Growth Marketing Manager hire it is charged; on Revenue Engine and Custom it is free; other plans get `403 plan_not_included`.","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/optimized-posts","href":"/api-reference/optimized-posts/create-an-optimized-post","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/lumis-labs/b06234118c1a31ee/scripts/autofill-auth.js"],"openApiReferenceData":{"operation":{"operationId":"v1_optimized_posts_post","tags":["Optimized posts"],"summary":"Create an optimized post","description":"Make a text post (`format: text`) or a post with one picture (`format: image`) written to perform on the network it is for (`written_for`: `x`, `linkedin` or `instagram`). Unlike a `slideshow` from `POST /v1/videos`, which is written plainly from your sources, the post producer makes it start to finish, the way the dashboard's Create Post > Generate Automatically does: it researches the business, its competitors on that network and the news, recommends five post ideas, picks the strongest, and writes it with the tuned writer, which learns from the posts that did best and worst for accounts like yours and keeps the best of five drafts. It runs in the background (usually a few minutes): this answers `201` with `status: researching`; poll `GET /v1/optimized-posts/{id}` until it is `ready`, then post it with `POST /v1/videos/{video_id}/posts`. It is charged once, when the post is made, like a video (included video credits first, then the prepaid balance): its picture and writing at cost plus 20%, and for `instagram`, reading Instagram for the writer. `price_cents` is the estimate until then. On the API \u0026 MCP plan and the Growth Marketing Manager hire it is charged; on Revenue Engine and Custom it is free; other plans get `403 plan_not_included`.","parameters":["e7de7a90-e73e-4ef2-961f-763ee097a54f"],"requestBody":"a437b6ec-5ddc-4013-9d34-a852b2a919db","responses":{"200":"ce119050-62b0-4411-838d-bfb0226cbe39","400":"d18b858c-00f9-4ead-924b-826b3ff5a3c1","401":"c1d500da-fa3d-46d5-b29d-0ff651a0edff","403":"c777323f-ce4e-439d-8b55-e392411b905d","404":"0e7bd9f2-5d60-4ead-9645-061f3f85c1b9","409":"cdd2f618-f864-48aa-a94a-45b273346cb4","429":"53b880ff-d072-4713-9f22-a1ac71be7e09"},"x-scopes":["videos:write"],"x-rate-limit":{"requestsPerMinute":600},"method":"post","type":"path","servers":["a60c90a9-5726-43bf-b29c-11cbc5e7adbb"],"security":["2ce536b7-a93f-48fb-a6b2-85a3855c62a4"],"path":"/v1/optimized-posts","baseUrlOptions":["https://api.lumisreach.com/api"],"title":"Create an optimized post","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"e7de7a90-e73e-4ef2-961f-763ee097a54f":{"name":"Idempotency-Key","in":"header","required":false,"description":"A UUID. When present, deduplicates repeat submissions. See /api-reference/idempotency.","schema":{"type":"string","isRequired":false,"description":"A UUID. When present, deduplicates repeat submissions. See /api-reference/idempotency.","uniqueKey":"","typeLabel":"string"}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"format":{"default":"image","description":"`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.","type":"string","enum":["text","image"],"isRequired":true,"uniqueKey":"format","typeLabel":"enum\u003cstring>"},"written_for":{"description":"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.","type":"string","enum":["x","linkedin","instagram"],"uniqueKey":"written_for","typeLabel":"enum\u003cstring>"},"brief":{"description":"What the post should be about, in a sentence or two: the subject, the audience and the feel.","type":"string","minLength":1,"maxLength":1000,"uniqueKey":"brief","typeLabel":"string"},"title":{"description":"Your name for the post. Omit it and one is written.","type":"string","minLength":1,"maxLength":100,"uniqueKey":"title","typeLabel":"string"},"language":{"description":"The language the post is written in, as a code (`en`, `es`, `fr`, ...). Default `en`.","type":"string","enum":["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"],"uniqueKey":"language","typeLabel":"enum\u003cstring>"},"source_url":{"description":"The business's website. Omit to use the one saved in the workspace's marketing profile.","type":"string","format":"uri","uniqueKey":"source_url","typeLabel":"string\u003curi>"},"source_text":{"description":"A description of the business, product or offer, in your words","type":"string","minLength":1,"maxLength":5000,"uniqueKey":"source_text","typeLabel":"string"},"source_image_urls":{"description":"Images already uploaded to LumisReach; an `image` post uses one of them instead of drawing one","maxItems":10,"type":"array","items":{"type":"string","format":"uri","uniqueKey":"source_image_urls.items.[INDEX]","typeLabel":"string\u003curi>"},"uniqueKey":"source_image_urls","typeLabel":"string\u003curi>[]"}},"required":["format"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"format":"image","brief":"\u003cstring>","title":"\u003cstring>","source_url":"\u003cstring>","source_text":"\u003cstring>","source_image_urls":["\u003cstring>"]}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"ce119050-62b0-4411-838d-bfb0226cbe39":{"description":"Success","content":{"application/json":{"schema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","isRequired":true,"uniqueKey":"data.id","typeLabel":"string\u003cuuid>"},"status":{"type":"string","enum":["researching","writing","producing","ready","failed"],"description":"`researching` the business, its competitors and the news; `writing` the post ideas and the post; `producing` its picture; `ready` to post; `failed` (see `error`)","isRequired":true,"uniqueKey":"data.status","typeLabel":"enum\u003cstring>"},"format":{"type":"string","enum":["text","image"],"isRequired":true,"uniqueKey":"data.format","typeLabel":"enum\u003cstring>"},"written_for":{"oneOf":[{"type":"string","description":"Null when it is written for X and LinkedIn at once","enum":["x","linkedin","instagram"],"isRequired":true,"uniqueKey":"data.written_for.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","description":"Null when it is written for X and LinkedIn at once","isRequired":true,"uniqueKey":"data.written_for.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.written_for","typeLabel":"enum\u003cstring> | null"},"title":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"data.title.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.title.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.title","typeLabel":"string | null"},"text":{"oneOf":[{"description":"The post's words, with its hashtags, once written","type":"string","isRequired":true,"uniqueKey":"data.text.oneOf.0","typeLabel":"string"},{"description":"The post's words, with its hashtags, once written","type":"null","isRequired":true,"uniqueKey":"data.text.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.text","typeLabel":"string | null"},"image_url":{"oneOf":[{"description":"An `image` post's picture, once made","type":"string","isRequired":true,"uniqueKey":"data.image_url.oneOf.0","typeLabel":"string"},{"description":"An `image` post's picture, once made","type":"null","isRequired":true,"uniqueKey":"data.image_url.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.image_url","typeLabel":"string | null"},"video_id":{"oneOf":[{"type":"string","description":"The post as a video record, once it exists: post it with `POST /v1/videos/{id}/posts` and read every detail with `GET /v1/videos/{id}`","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","isRequired":true,"uniqueKey":"data.video_id.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","description":"The post as a video record, once it exists: post it with `POST /v1/videos/{id}/posts` and read every detail with `GET /v1/videos/{id}`","isRequired":true,"uniqueKey":"data.video_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.video_id","typeLabel":"string\u003cuuid> | null"},"price_cents":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"What it costs: what it was charged once made, an estimate before then","isRequired":true,"uniqueKey":"data.price_cents","typeLabel":"integer"},"price_estimated":{"type":"boolean","isRequired":true,"uniqueKey":"data.price_estimated","typeLabel":"boolean"},"billed_cents":{"oneOf":[{"type":"integer","description":"What it was charged, once made; 0 on a plan where it is free","maximum":9007199254740991,"minimum":-9007199254740991,"isRequired":true,"uniqueKey":"data.billed_cents.oneOf.0","typeLabel":"integer"},{"type":"null","description":"What it was charged, once made; 0 on a plan where it is free","isRequired":true,"uniqueKey":"data.billed_cents.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.billed_cents","typeLabel":"integer | null"},"error":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"data.error.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.error.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.error","typeLabel":"string | null"},"dashboard_url":{"type":"string","description":"Where to watch the producer work, in the dashboard","isRequired":true,"uniqueKey":"data.dashboard_url","typeLabel":"string"},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","isRequired":true,"uniqueKey":"data.created_at","typeLabel":"string\u003cdate-time>"},"updated_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","isRequired":true,"uniqueKey":"data.updated_at","typeLabel":"string\u003cdate-time>"}},"required":["id","status","format","written_for","title","text","image_url","video_id","price_cents","price_estimated","billed_cents","error","dashboard_url","created_at","updated_at"],"additionalProperties":false,"isRequired":true,"uniqueKey":"data","typeLabel":"object"}},"required":["data"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"data":{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","status":"researching","format":"text","written_for":"x","title":"\u003cstring>","text":"\u003cstring>","image_url":"\u003cstring>","video_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","price_cents":0,"price_estimated":true,"billed_cents":0,"error":"\u003cstring>","dashboard_url":"\u003cstring>","created_at":"2023-11-07T05:31:56Z","updated_at":"2023-11-07T05:31:56Z"}}}},"exampleType":"generated"}},"exampleType":"generated"},"d18b858c-00f9-4ead-924b-826b3ff5a3c1":{"description":"Validation error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"fields":{"type":"object","additionalProperties":{"type":"string","uniqueKey":"error.fields.additionalProperties","typeLabel":"string"},"uniqueKey":"error.fields","typeLabel":"object"},"doc_url":{"type":"string","format":"uri","uniqueKey":"error.doc_url","typeLabel":"string\u003curi>"}},"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","fields":{},"doc_url":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"c1d500da-fa3d-46d5-b29d-0ff651a0edff":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"fields":{"type":"object","additionalProperties":{"type":"string","uniqueKey":"error.fields.additionalProperties","typeLabel":"string"},"uniqueKey":"error.fields","typeLabel":"object"},"doc_url":{"type":"string","format":"uri","uniqueKey":"error.doc_url","typeLabel":"string\u003curi>"}},"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","fields":{},"doc_url":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"c777323f-ce4e-439d-8b55-e392411b905d":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"fields":{"type":"object","additionalProperties":{"type":"string","uniqueKey":"error.fields.additionalProperties","typeLabel":"string"},"uniqueKey":"error.fields","typeLabel":"object"},"doc_url":{"type":"string","format":"uri","uniqueKey":"error.doc_url","typeLabel":"string\u003curi>"}},"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","fields":{},"doc_url":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"0e7bd9f2-5d60-4ead-9645-061f3f85c1b9":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"fields":{"type":"object","additionalProperties":{"type":"string","uniqueKey":"error.fields.additionalProperties","typeLabel":"string"},"uniqueKey":"error.fields","typeLabel":"object"},"doc_url":{"type":"string","format":"uri","uniqueKey":"error.doc_url","typeLabel":"string\u003curi>"}},"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","fields":{},"doc_url":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"cdd2f618-f864-48aa-a94a-45b273346cb4":{"description":"Conflict (incl. idempotency conflicts)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"fields":{"type":"object","additionalProperties":{"type":"string","uniqueKey":"error.fields.additionalProperties","typeLabel":"string"},"uniqueKey":"error.fields","typeLabel":"object"},"doc_url":{"type":"string","format":"uri","uniqueKey":"error.doc_url","typeLabel":"string\u003curi>"}},"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","fields":{},"doc_url":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"53b880ff-d072-4713-9f22-a1ac71be7e09":{"description":"Rate limited","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"fields":{"type":"object","additionalProperties":{"type":"string","uniqueKey":"error.fields.additionalProperties","typeLabel":"string"},"uniqueKey":"error.fields","typeLabel":"object"},"doc_url":{"type":"string","format":"uri","uniqueKey":"error.doc_url","typeLabel":"string\u003curi>"}},"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","fields":{},"doc_url":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"2ce536b7-a93f-48fb-a6b2-85a3855c62a4":{"bearerAuth":{"type":"http","scheme":"bearer","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"a60c90a9-5726-43bf-b29c-11cbc5e7adbb":{"url":"https://api.lumisreach.com/api"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"openapi.json"},"subdomain":"lumis-labs","siteName":"LumisReach","title":"Create an optimized post - LumisReach","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-27T23:14:58.049Z","originalFileLocation":"api-reference/optimized-posts/create-an-optimized-post.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Make a text post (format: text) or a post with one picture (format: image) written to perform on the network it is for (written_for: x, linkedin or instagram). Unlike a slideshow from POST /v1/videos, which is written plainly from your sources, the post producer makes it start to finish, the way the dashboard\u0026#x27;s Create Post \u0026gt; Generate Automatically does: it researches the business, its competitors on that network and the news, recommends five post ideas, picks the strongest, and writes it with the tuned writer, which learns from the posts that did best and worst for accounts like yours and keeps the best of five drafts. It runs in the background (usually a few minutes): this answers 201 with status: researching; poll GET /v1/optimized-posts/{id} until it is ready, then post it with POST /v1/videos/{video_id}/posts. It is charged once, when the post is made, like a video (included video credits first, then the prepaid balance): its picture and writing at cost plus 20%, and for instagram, reading Instagram for the writer. price_cents is the estimate until then. On the API \u0026amp; MCP plan and the Growth Marketing Manager hire it is charged; on Revenue Engine and Custom it is free; other plans get 403 plan_not_included.\">\u003cmeta data-mint-head name=\"application-name\" content=\"LumisReach\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/lumis-labs/UN69hXfwmW9E7Cph/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/lumis-labs/UN69hXfwmW9E7Cph/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/lumis-labs/UN69hXfwmW9E7Cph/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/lumis-labs/UN69hXfwmW9E7Cph/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/lumis-labs/UN69hXfwmW9E7Cph/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/lumis-labs/UN69hXfwmW9E7Cph/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/lumis-labs/UN69hXfwmW9E7Cph/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/lumis-labs/UN69hXfwmW9E7Cph/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/lumis-labs/UN69hXfwmW9E7Cph/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create an optimized post - LumisReach\">\u003cmeta data-mint-head property=\"og:description\" content=\"Make a text post (format: text) or a post with one picture (format: image) written to perform on the network it is for (written_for: x, linkedin or instagram). Unlike a slideshow from POST /v1/videos, which is written plainly from your sources, the post producer makes it start to finish, the way the dashboard\u0026#x27;s Create Post \u0026gt; Generate Automatically does: it researches the business, its competitors on that network and the news, recommends five post ideas, picks the strongest, and writes it with the tuned writer, which learns from the posts that did best and worst for accounts like yours and keeps the best of five drafts. It runs in the background (usually a few minutes): this answers 201 with status: researching; poll GET /v1/optimized-posts/{id} until it is ready, then post it with POST /v1/videos/{video_id}/posts. It is charged once, when the post is made, like a video (included video credits first, then the prepaid balance): its picture and writing at cost plus 20%, and for instagram, reading Instagram for the writer. price_cents is the estimate until then. On the API \u0026amp; MCP plan and the Growth Marketing Manager hire it is charged; on Revenue Engine and Custom it is free; other plans get 403 plan_not_included.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"LumisReach\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.lumisreach.com/api-reference/optimized-posts/create-an-optimized-post\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://lumis-labs.mintlify.app/_mintlify/api/og/v2?division=Optimized+posts\u0026amp;title=Create+an+optimized+post\u0026amp;description=Make+a+text+post+%28%60format%3A+text%60%29+or+a+post+with+one+picture+%28%60format%3A+image%60%29+written+to+perform+on+the+network+it+is+for+%28%60written_for%60%3A+%60x%60%2C+%60linkedin%60+or+%60i\u0026amp;theme=650d8e3bed5a44f3ca42822e\u0026amp;signature=b6dd3a54a15eccc146949942f8e1a0072e4024361beb5a7fb8734721dc58d42e\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Create an optimized post - LumisReach\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Make a text post (format: text) or a post with one picture (format: image) written to perform on the network it is for (written_for: x, linkedin or instagram). Unlike a slideshow from POST /v1/videos, which is written plainly from your sources, the post producer makes it start to finish, the way the dashboard\u0026#x27;s Create Post \u0026gt; Generate Automatically does: it researches the business, its competitors on that network and the news, recommends five post ideas, picks the strongest, and writes it with the tuned writer, which learns from the posts that did best and worst for accounts like yours and keeps the best of five drafts. It runs in the background (usually a few minutes): this answers 201 with status: researching; poll GET /v1/optimized-posts/{id} until it is ready, then post it with POST /v1/videos/{video_id}/posts. It is charged once, when the post is made, like a video (included video credits first, then the prepaid balance): its picture and writing at cost plus 20%, and for instagram, reading Instagram for the writer. price_cents is the estimate until then. On the API \u0026amp; MCP plan and the Growth Marketing Manager hire it is charged; on Revenue Engine and Custom it is free; other plans get 403 plan_not_included.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://lumis-labs.mintlify.app/_mintlify/api/og/v2?division=Optimized+posts\u0026amp;title=Create+an+optimized+post\u0026amp;description=Make+a+text+post+%28%60format%3A+text%60%29+or+a+post+with+one+picture+%28%60format%3A+image%60%29+written+to+perform+on+the+network+it+is+for+%28%60written_for%60%3A+%60x%60%2C+%60linkedin%60+or+%60i\u0026amp;theme=650d8e3bed5a44f3ca42822e\u0026amp;signature=b6dd3a54a15eccc146949942f8e1a0072e4024361beb5a7fb8734721dc58d42e\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/lumis-labs/UN69hXfwmW9E7Cph/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"LumisReach\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#111827\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.lumisreach.com/api-reference/optimized-posts/create-an-optimized-post\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/optimized-posts/create-an-optimized-post.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.lumisreach.com/#organization\",\"name\":\"LumisReach\",\"url\":\"https://docs.lumisreach.com\"},{\"@type\":\"WebSite\",\"@id\":\"https://docs.lumisreach.com#website\",\"name\":\"LumisReach\",\"url\":\"https://docs.lumisreach.com\",\"publisher\":{\"@id\":\"https://docs.lumisreach.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.lumisreach.com/api-reference/optimized-posts/create-an-optimized-post#webpage\",\"url\":\"https://docs.lumisreach.com/api-reference/optimized-posts/create-an-optimized-post\",\"name\":\"Create an optimized post\",\"description\":\"Make a text post (format: text) or a post with one picture (format: image) written to perform on the network it is for (written_for: x, linkedin or instagram). Unlike a slideshow from POST /v1/videos, which is written plainly from your sources, the post producer makes it start to finish, the way the dashboard's Create Post > Generate Automatically does: it researches the business, its competitors on that network and the news, recommends five post ideas, picks the strongest, and writes it with the tuned writer, which learns from the posts that did best and worst for accounts like yours and keeps the best of five drafts. It runs in the background (usually a few minutes): this answers 201 with status: researching; poll GET /v1/optimized-posts/{id} until it is ready, then post it with POST /v1/videos/{video_id}/posts. It is charged once, when the post is made, like a video (included video credits first, then the prepaid balance): its picture and writing at cost plus 20%, and for instagram, reading Instagram for the writer. price_cents is the estimate until then. On the API \u0026 MCP plan and the Growth Marketing Manager hire it is charged; on Revenue Engine and Custom it is free; other plans get 403 plan_not_included.\",\"dateModified\":\"2026-10-27T23:14:58.049Z\",\"isPartOf\":{\"@id\":\"https://docs.lumisreach.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.lumisreach.com/api-reference/optimized-posts/create-an-optimized-post#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.lumisreach.com/api-reference/optimized-posts/create-an-optimized-post#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Optimized posts\",\"item\":\"https://docs.lumisreach.com/api-reference/optimized-posts\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create an optimized post\",\"item\":\"https://docs.lumisreach.com/api-reference/optimized-posts/create-an-optimized-post\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.lumisreach.com/api-reference/optimized-posts/create-an-optimized-post#apireference\",\"headline\":\"Create an optimized post\",\"name\":\"Create an optimized post\",\"description\":\"Make a text post (format: text) or a post with one picture (format: image) written to perform on the network it is for (written_for: x, linkedin or instagram). Unlike a slideshow from POST /v1/videos, which is written plainly from your sources, the post producer makes it start to finish, the way the dashboard's Create Post > Generate Automatically does: it researches the business, its competitors on that network and the news, recommends five post ideas, picks the strongest, and writes it with the tuned writer, which learns from the posts that did best and worst for accounts like yours and keeps the best of five drafts. It runs in the background (usually a few minutes): this answers 201 with status: researching; poll GET /v1/optimized-posts/{id} until it is ready, then post it with POST /v1/videos/{video_id}/posts. It is charged once, when the post is made, like a video (included video credits first, then the prepaid balance): its picture and writing at cost plus 20%, and for instagram, reading Instagram for the writer. price_cents is the estimate until then. On the API \u0026 MCP plan and the Growth Marketing Manager hire it is charged; on Revenue Engine and Custom it is free; other plans get 403 plan_not_included.\",\"url\":\"https://docs.lumisreach.com/api-reference/optimized-posts/create-an-optimized-post\",\"mainEntityOfPage\":{\"@id\":\"https://docs.lumisreach.com/api-reference/optimized-posts/create-an-optimized-post#webpage\"},\"dateModified\":\"2026-10-27T23:14:58.049Z\",\"publisher\":{\"@id\":\"https://docs.lumisreach.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.lumisreach.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"LumisReach\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"LumisReach","nav":{"global":null,"tabs":[{"tab":"Get Started","pages":[{"title":"Get Started","href":""}]},{"tab":"Solutions","pages":[{"title":"Solutions","href":"/solutions"}]},{"tab":"Policies","pages":[{"title":"Policies","href":"/policies/privacy-policy"}]},{"tab":"Partners","pages":[{"title":"Partners","href":"/partners"}]},{"tab":"API Reference","groups":[{"group":"Getting Started","pages":[{"title":"Introduction","href":"/api-reference"},{"title":"Authentication","href":"/api-reference/authentication"},{"title":"Conventions","href":"/api-reference/conventions"},{"title":"MCP server","href":"/api-reference/mcp"}]},{"group":"Concepts","pages":[{"title":"Caller Trust","href":"/concepts/caller-trust"},{"title":"Sub-entities (multi-tenant organizations)","href":"/concepts/sub-entities"},{"title":"HIPAA \u0026 BAA coverage","href":"/concepts/hipaa"},{"title":"Outreach audit \u0026 consent records","sidebarTitle":"Outreach Audit","href":"/concepts/outreach-audit"}]},{"group":"Quick Agent Actions","pages":[{"title":"Quick Agent Actions","href":"/api-reference/quick-agent-actions"},{"title":"Start a Quick AI Phone Call","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/quick/ai-calls","href":"/api-reference/quick-agent-actions/start-a-quick-ai-phone-call"},{"title":"Start a Quick AI Text conversation","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/quick/ai-texts","href":"/api-reference/quick-agent-actions/start-a-quick-ai-text-conversation"},{"title":"Send a single text message","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/quick/texts","href":"/api-reference/quick-agent-actions/send-a-single-text-message"},{"title":"Send a Quick Email","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/quick/emails","href":"/api-reference/quick-agent-actions/send-a-quick-email"},{"title":"Send a Quick iMessage","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/quick/imessages","href":"/api-reference/quick-agent-actions/send-a-quick-imessage"},{"title":"Send a quick chat message","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/quick/chat-messages","href":"/api-reference/quick-agent-actions/send-a-quick-chat-message"},{"title":"List connected chat channels","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/quick/chat-channels","href":"/api-reference/quick-agent-actions/list-connected-chat-channels"},{"title":"Connect a chat channel","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/quick/chat-channels","href":"/api-reference/quick-agent-actions/connect-a-chat-channel"},{"title":"List Quick Agent Action jobs","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/quick/actions","href":"/api-reference/quick-agent-actions/list-quick-agent-action-jobs"},{"title":"Get a Quick Agent Action job","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/quick/actions/{id}","href":"/api-reference/quick-agent-actions/get-a-quick-agent-action-job"},{"title":"Cancel a Quick Agent Action job","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/quick/actions/{id}/cancel","href":"/api-reference/quick-agent-actions/cancel-a-quick-agent-action-job"},{"title":"Buy a phone number and set up its AI agent","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/quick/ai-numbers","href":"/api-reference/quick-agent-actions/buy-a-phone-number-and-set-up-its-ai-agent"},{"title":"Get AI phone number status","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/quick/ai-numbers/{id}","href":"/api-reference/quick-agent-actions/get-ai-phone-number-status"}]},{"group":"Lincoln AI","pages":[{"title":"Lincoln AI","href":"/api-reference/lincoln"},{"title":"Message Lincoln AI","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/lincoln/messages","href":"/api-reference/lincoln-ai/message-lincoln-ai"},{"title":"List Lincoln AI conversations","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/lincoln/conversations","href":"/api-reference/lincoln-ai/list-lincoln-ai-conversations"},{"title":"Get a Lincoln AI conversation","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/lincoln/conversations/{id}","href":"/api-reference/lincoln-ai/get-a-lincoln-ai-conversation"}]},{"group":"Videos","pages":[{"title":"Videos","href":"/api-reference/videos"},{"title":"Quote a video","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/quote","href":"/api-reference/videos/quote-a-video"},{"title":"Create a video","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos","href":"/api-reference/videos/create-a-video"},{"title":"List videos","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos","href":"/api-reference/videos/list-videos"},{"title":"Get a video","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}","href":"/api-reference/videos/get-a-video"},{"title":"Approve a video's script","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/approve","href":"/api-reference/videos/approve-a-videos-script"},{"title":"Retry a video","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/retry","href":"/api-reference/videos/retry-a-video"},{"title":"Delete a video","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/videos/{id}","href":"/api-reference/videos/delete-a-video"},{"title":"List music tracks","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/music","href":"/api-reference/videos/list-music-tracks"},{"title":"List social connections","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/social-connections","href":"/api-reference/videos/list-social-connections"},{"title":"Post a video","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/posts","href":"/api-reference/videos/post-a-video"},{"title":"List a video's posts","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/posts","href":"/api-reference/videos/list-a-videos-posts"},{"title":"Cancel a scheduled post","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/posts/{id}","href":"/api-reference/videos/cancel-a-scheduled-post"}]},{"group":"Optimized posts","pages":[{"title":"Optimized posts","description":"Make a text post, or a text post with one picture, researched and written to perform on X, LinkedIn or Instagram.","href":"/api-reference/optimized-posts"},{"title":"Create an optimized post","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/optimized-posts","href":"/api-reference/optimized-posts/create-an-optimized-post"},{"title":"Get an optimized post","description":"Where an optimized post stands (`researching`, `writing`, `producing`, `ready` or `failed`), and once it is written, its `text`, its `image_url` and its `video_id`, which `POST /v1/videos/{id}/posts` posts. Free.","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/optimized-posts/{id}","href":"/api-reference/optimized-posts/get-an-optimized-post"}]},{"group":"Predictions","pages":[{"title":"Predictions","href":"/api-reference/predictions"},{"title":"Predict performance","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/predictions","href":"/api-reference/predictions/predict-performance"},{"title":"Get a prediction","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/predictions/{id}","href":"/api-reference/predictions/get-a-prediction"},{"title":"List predictions","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/predictions","href":"/api-reference/predictions/list-predictions"}]},{"group":"Video Schedules","pages":[{"title":"Video schedules","href":"/api-reference/video-schedules"},{"title":"List video schedules","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/video-schedules","href":"/api-reference/video-schedules/list-video-schedules"},{"title":"Create a video schedule","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/video-schedules","href":"/api-reference/video-schedules/create-a-video-schedule"},{"title":"Get a video schedule","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/video-schedules/{id}","href":"/api-reference/video-schedules/get-a-video-schedule"},{"title":"Update a video schedule","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/video-schedules/{id}","href":"/api-reference/video-schedules/update-a-video-schedule"},{"title":"Delete a video schedule","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/video-schedules/{id}","href":"/api-reference/video-schedules/delete-a-video-schedule"},{"title":"Skip the next run","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/video-schedules/{id}/skip","href":"/api-reference/video-schedules/skip-the-next-run"},{"title":"List a schedule's videos","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/video-schedules/{id}/videos","href":"/api-reference/video-schedules/list-a-schedules-videos"}]},{"group":"Calls, Texts and Contacts","pages":[{"title":"Calls, texts and contacts","href":"/api-reference/conversations"},{"title":"List calls","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/calls","href":"/api-reference/calls/list-calls"},{"title":"Get a call","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/calls/{id}","href":"/api-reference/calls/get-a-call"},{"title":"Download a call recording","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/calls/{id}/recording","href":"/api-reference/calls/download-a-call-recording"},{"title":"Place an outbound call from one of your numbers to a destination","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/calls/dial","href":"/api-reference/calls/place-an-outbound-call-from-one-of-your-numbers-to-a-destination"},{"title":"List text messages","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/messages","href":"/api-reference/messages/list-text-messages"},{"title":"List emails with a person","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/emails","href":"/api-reference/emails/list-emails-with-a-person"},{"title":"List contacts","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/contacts","href":"/api-reference/contacts/list-contacts"},{"title":"Get a contact","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/contacts/{id}","href":"/api-reference/contacts/get-a-contact"}]},{"group":"Account","pages":[{"title":"Current authenticated principal","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/me","href":"/api-reference/account/current-authenticated-principal"},{"title":"Current account snapshot","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/account","href":"/api-reference/account/current-account-snapshot"},{"title":"API status","deprecated":null,"version":null,"openapi":"/openapi.json get /v1","href":"/api-reference/account/api-status"}]},{"group":"Sub-entities","pages":[{"title":"List sub-entities under the caller's umbrella organization","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/sub-entities","href":"/api-reference/sub-entities/list-sub-entities-under-the-callers-umbrella-organization"},{"title":"Create a sub-entity under the caller's umbrella organization","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/sub-entities","href":"/api-reference/sub-entities/create-a-sub-entity-under-the-callers-umbrella-organization"},{"title":"Retrieve a sub-entity","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/sub-entities/{id}","href":"/api-reference/sub-entities/retrieve-a-sub-entity"},{"title":"Update a sub-entity","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/sub-entities/{id}","href":"/api-reference/sub-entities/update-a-sub-entity"}]},{"group":"Billing","pages":[{"title":"Billing summary","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/billing","href":"/api-reference/billing/billing-summary"},{"title":"Usage and charges by category","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/billing/usage","href":"/api-reference/billing/usage-and-charges-by-category"},{"title":"List billing events","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/billing/events","href":"/api-reference/billing/list-billing-events"}]},{"group":"Phone Numbers","pages":[{"title":"List owned phone numbers","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/phone-numbers","href":"/api-reference/phone-numbers/list-owned-phone-numbers"},{"title":"Purchase a new phone number","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/phone-numbers","href":"/api-reference/phone-numbers/purchase-a-new-phone-number"},{"title":"Retrieve a phone number","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/phone-numbers/{id}","href":"/api-reference/phone-numbers/retrieve-a-phone-number"},{"title":"Update a phone number's settings","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/phone-numbers/{id}","href":"/api-reference/phone-numbers/update-a-phone-numbers-settings"},{"title":"Release a phone number","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/phone-numbers/{id}","href":"/api-reference/phone-numbers/release-a-phone-number"},{"title":"Check live CNAM status","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/phone-numbers/{id}/cnam-status","href":"/api-reference/phone-numbers/check-live-cnam-status"},{"title":"Search available phone numbers","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/phone-numbers/search","href":"/api-reference/phone-numbers/search-available-phone-numbers"}]},{"group":"Number Configuration","pages":[{"title":"Number configuration","href":"/api-reference/number-configuration"},{"title":"Get a number's AI configuration","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/phone-numbers/{id}/config","href":"/api-reference/phone-numbers/get-a-numbers-ai-configuration"},{"title":"Update a number's AI configuration","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/phone-numbers/{id}/config","href":"/api-reference/phone-numbers/update-a-numbers-ai-configuration"},{"title":"List voices for a number","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/phone-numbers/{id}/voices","href":"/api-reference/phone-numbers/list-voices-for-a-number"}]},{"group":"Caller IDs","pages":[{"title":"List caller IDs","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/voice/caller-ids","href":"/api-reference/caller-ids/list-caller-ids"},{"title":"Start caller ID verification","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/voice/caller-ids","href":"/api-reference/caller-ids/start-caller-id-verification"},{"title":"Update CNAM display name","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/voice/caller-ids/{id}","href":"/api-reference/caller-ids/update-cnam-display-name"},{"title":"Submit verification code","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/voice/caller-ids/{id}/verify","href":"/api-reference/caller-ids/submit-verification-code"}]},{"group":"Enterprise Registration","pages":[{"title":"List enterprise registrations","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/caller-trust/enterprises","href":"/api-reference/enterprise-registration/list-enterprise-registrations"},{"title":"Create a new enterprise registration draft","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/caller-trust/enterprises","href":"/api-reference/enterprise-registration/create-a-new-enterprise-registration-draft"},{"title":"Get enterprise by ID","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/caller-trust/enterprises/{id}","href":"/api-reference/enterprise-registration/get-enterprise-by-id"},{"title":"Update a DRAFT enterprise registration","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/caller-trust/enterprises/{id}","href":"/api-reference/enterprise-registration/update-a-draft-enterprise-registration"},{"title":"Delete enterprise by ID","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/caller-trust/enterprises/{id}","href":"/api-reference/enterprise-registration/delete-enterprise-by-id"},{"title":"Sign LOA + submit enterprise to carrier (by ID)","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/caller-trust/enterprises/{id}/sign-and-submit","href":"/api-reference/enterprise-registration/sign-loa-+-submit-enterprise-to-carrier-by-id"},{"title":"Submit enterprise to Telnyx (by ID)","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/caller-trust/enterprises/{id}/submit","href":"/api-reference/enterprise-registration/submit-enterprise-to-telnyx-by-id"},{"title":"Re-sign LOA for enterprise (by ID)","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/caller-trust/enterprises/{id}/resign","href":"/api-reference/enterprise-registration/re-sign-loa-for-enterprise-by-id"},{"title":"Generate LOA PDF for enterprise (by ID)","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/caller-trust/enterprises/{id}/generate-loa","href":"/api-reference/enterprise-registration/generate-loa-pdf-for-enterprise-by-id"}]},{"group":"Enterprise Registration (Legacy)","pages":[{"title":"Get the caller's enterprise registration (deprecated)","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/caller-trust/enterprise","href":"/api-reference/enterprise-registration/get-the-callers-enterprise-registration-deprecated"},{"title":"Create or update the caller's enterprise registration draft (deprecated)","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/caller-trust/enterprise","href":"/api-reference/enterprise-registration/create-or-update-the-callers-enterprise-registration-draft-deprecated"},{"title":"Generate LOA PDF for hand-signing (deprecated)","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/caller-trust/enterprise/generate-loa","href":"/api-reference/enterprise-registration/generate-loa-pdf-for-hand-signing-deprecated"},{"title":"Re-sign the LOA for an enterprise (deprecated)","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/caller-trust/enterprise/resign","href":"/api-reference/enterprise-registration/re-sign-the-loa-for-an-enterprise-deprecated"},{"title":"Submit enterprise to Telnyx (deprecated)","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/caller-trust/enterprise/submit","href":"/api-reference/enterprise-registration/submit-enterprise-to-telnyx-deprecated"},{"title":"Sign LOA + submit enterprise to carrier (deprecated)","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/caller-trust/enterprise/sign-and-submit","href":"/api-reference/enterprise-registration/sign-loa-+-submit-enterprise-to-carrier-deprecated"},{"title":"Delete the caller's enterprise registration (deprecated)","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/caller-trust/enterprise","href":"/api-reference/enterprise-registration/delete-the-callers-enterprise-registration-deprecated"}]},{"group":"Branded Calling","tag":"Coming Soon","pages":[{"title":"Branded Calling","href":"/api-reference/branded-calling"},{"title":"Retrieve the caller's Display Identity Record (brand)","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/caller-trust/brand","href":"/api-reference/branded-calling/retrieve-the-callers-display-identity-record-brand"},{"title":"Save (or update) the Display Identity Record draft","deprecated":null,"version":null,"openapi":"/openapi.json put /v1/caller-trust/brand","href":"/api-reference/branded-calling/save-or-update-the-display-identity-record-draft"},{"title":"Submit the brand profile for vetting","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/caller-trust/brand/submit","href":"/api-reference/branded-calling/submit-the-brand-profile-for-vetting"}]},{"group":"Dialer Calls","pages":[{"title":"Place a dialer call","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/voice/calls","href":"/api-reference/dialer-calls/place-a-dialer-call"},{"title":"List dialer calls","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/voice/calls","href":"/api-reference/dialer-calls/list-dialer-calls"},{"title":"Get a dialer call","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/voice/calls/{id}","href":"/api-reference/dialer-calls/get-a-dialer-call"},{"title":"Hang up a dialer call","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/voice/calls/{id}/hangup","href":"/api-reference/dialer-calls/hang-up-a-dialer-call"}]},{"group":"Call Webhooks","pages":[{"title":"Call webhooks","href":"/api-reference/calls/webhooks"},{"title":"Create a call webhook","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/voice/calls/webhooks","href":"/api-reference/calls/create-a-call-webhook"},{"title":"List call webhooks","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/voice/calls/webhooks","href":"/api-reference/calls/list-call-webhooks"},{"title":"Delete a call webhook","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/voice/calls/webhooks/{id}","href":"/api-reference/calls/delete-a-call-webhook"},{"title":"Send a test call event","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/voice/calls/webhooks/{id}/test","href":"/api-reference/calls/send-a-test-call-event"}]},{"group":"Inbound SMS","pages":[{"title":"Inbound SMS webhooks","href":"/api-reference/sms/webhooks"},{"title":"Create an inbound SMS webhook","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/sms/webhooks","href":"/api-reference/sms/create-an-inbound-sms-webhook"},{"title":"List inbound SMS webhooks","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/sms/webhooks","href":"/api-reference/sms/list-inbound-sms-webhooks"},{"title":"Delete an inbound SMS webhook","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/sms/webhooks/{id}","href":"/api-reference/sms/delete-an-inbound-sms-webhook"},{"title":"Send a test inbound SMS event","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/sms/webhooks/{id}/test","href":"/api-reference/sms/send-a-test-inbound-sms-event"},{"title":"Stream inbound texts","openapi":"GET /v1/sms/stream","href":"/api-reference/sms/stream"}]},{"group":"SMS","tag":"Coming Soon","pages":[{"title":"Send an SMS message","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/sms/send","href":"/api-reference/sms/send-an-sms-message"}]},{"group":"WebRTC","pages":[{"title":"Get WebRTC connection token","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/voice/webrtc-token","href":"/api-reference/webrtc/get-webrtc-connection-token"}]},{"group":"Documents","pages":[{"title":"Upload a document (e.g. signed LOA)","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/caller-trust/documents","href":"/api-reference/documents/upload-a-document-eg-signed-loa"},{"title":"Get document status","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/caller-trust/documents/{id}","href":"/api-reference/documents/get-document-status"}]},{"group":"Reputation","pages":[{"title":"Get Number Reputation enrollment settings","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/caller-trust/reputation","href":"/api-reference/reputation/get-number-reputation-enrollment-settings"},{"title":"Enable Number Reputation monitoring","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/caller-trust/reputation","href":"/api-reference/reputation/enable-number-reputation-monitoring"},{"title":"Update reputation check frequency","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/caller-trust/reputation","href":"/api-reference/reputation/update-reputation-check-frequency"},{"title":"Disable Number Reputation monitoring","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/caller-trust/reputation","href":"/api-reference/reputation/disable-number-reputation-monitoring"},{"title":"List reputation scores for every enrolled number","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/caller-trust/reputation/numbers","href":"/api-reference/reputation/list-reputation-scores-for-every-enrolled-number"},{"title":"Enroll phone numbers in reputation monitoring","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/caller-trust/reputation/numbers","href":"/api-reference/reputation/enroll-phone-numbers-in-reputation-monitoring"},{"title":"Get reputation scores for a phone number","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/caller-trust/reputation/numbers/{phone}","href":"/api-reference/reputation/get-reputation-scores-for-a-phone-number"},{"title":"Disenroll a phone number from reputation monitoring","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/caller-trust/reputation/numbers/{phone}","href":"/api-reference/reputation/disenroll-a-phone-number-from-reputation-monitoring"}]},{"group":"Usage","pages":[{"title":"Current-month usage rollup","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/usage","href":"/api-reference/usage/current-month-usage-rollup"},{"title":"Voice usage stats","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/voice/usage","href":"/api-reference/usage/voice-usage-stats"},{"title":"Per-phone usage","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/voice/usage/{phoneId}","href":"/api-reference/usage/per-phone-usage"}]}]}]},"title":"Create an optimized post - LumisReach","buildId":"dpl_2oYXwqkEXirXBPk8wV1FtM5USFWi","deploymentId":"dpl_2oYXwqkEXirXBPk8wV1FtM5USFWi","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-WRhTSUDL.js","utils-ChMov4Kr.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-_REmC2bI.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Bp6nVRCu.js","snippetPresets-DZadmXoU.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CY2WdoTl.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-DwYG-Q4l.js","shallow-BXQIGwv4.js","getApiPlaygroundDisplay-CK5nK5B9.js","CodeSnippet-TH4a2aGW.js","CodeSnippets-DwsQiOFS.js","Page-R3M_BF4L.js","getPastedJson-DD7kUzi_.js","icon-holE3QoJ.js","MethodPill-DUW0T8us.js","DuplicateIcon-CI_p4be-.js","createIcon-BdbRvavb.js","DynamicMarkdown-DN96a4Ur.js","SectionHeading-SCu36A9d.js","axios-vUo_bRtp.js","Markdown-CCeGv-zI.js","clsx-BGBGWFTt.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-Cv_O2fky.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-2C5OB2eV.js"]}