{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"PublishBuddy","description":"Official documentation for the PublishBuddy API — schedule, publish, and analyse social media content programmatically.","colors":{"primary":"#16A34A","light":"#07C983","dark":"#15803D"},"logo":{"light":"https://mintcdn.com/publishbuddy/nWUw0kTKKpQWMu-J/logo/light.svg?fit=max\u0026auto=format\u0026n=nWUw0kTKKpQWMu-J\u0026q=85\u0026s=7a9f81aaa0e5b318450d92898c212a63","dark":"https://mintcdn.com/publishbuddy/nWUw0kTKKpQWMu-J/logo/dark.svg?fit=max\u0026auto=format\u0026n=nWUw0kTKKpQWMu-J\u0026q=85\u0026s=644eb4345be6bf3785ee6133097e67d8"},"favicon":"https://mintcdn.com/publishbuddy/_lHZwbQcuZuEHJ0r/favicon.ico?fit=max\u0026auto=format\u0026n=_lHZwbQcuZuEHJ0r\u0026q=85\u0026s=6d40f2740c2a60c0b66da156f42af7ba","navbar":{"links":[{"href":"mailto:hello@publishbuddy.com","label":"Support"}],"primary":{"type":"button","label":"Open app","href":"https://app.publishbuddy.com"}},"footer":{"socials":{"x":"https://x.com/publishbuddy","linkedin":"https://linkedin.com/company/publishbuddy"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Dashboard","icon":"house","href":"https://app.publishbuddy.com"},{"anchor":"Support","icon":"envelope","href":"mailto:hello@publishbuddy.com"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"publishbuddy","hasAudioNarration":false,"actualSubdomain":"publishbuddy","customDomains":["docs.publishbuddy.com"],"gitSource":{"type":"github","owner":"publishbuddy","repo":"publishbuddy-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6adf50096894e3d9c6b92180","collectionId":"4a1d2987-8d4c-4430-9793-a8496ae23159","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6adf50096894e3d9c6b92180"},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6adf50096894e3d9c6b92180","clientVersion":"0.0.3990","searchFilterCounts":[{"language":"default","tag":"Help","count":71},{"language":"default","tag":"API reference","count":27},{"language":"default","tag":"Guides","count":17},{"language":"default","tag":"Connect your accounts","count":14},{"language":"default","tag":"Troubleshooting","count":14},{"language":"default","tag":"Media library","count":12},{"language":"default","tag":"Analytics","count":11},{"language":"default","tag":"Each network","count":10},{"language":"default","tag":"AI","count":8},{"language":"default","tag":"Network options","count":8}]},"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":[],"page":{"pagePath":"api-reference/post/create-posts","slug":"/api-reference/post/create-posts","pageMetadata":{"title":"Create Post(s)","description":null,"deprecated":null,"version":null,"openapi":"/openapi.json post /workspaces/{workspace}/posts","href":"/api-reference/post/create-posts","autogeneratedByOpenApi":true},"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 Post(s)","description":null,"deprecated":null,"version":null,"openapi":"/openapi.json post /workspaces/{workspace}/posts","href":"/api-reference/post/create-posts","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"workspaces.posts.store","summary":"Create Post(s)","tags":["Post"],"parameters":["160beb21-a3e2-409d-90df-f938719b7348"],"requestBody":"e10c1834-6bb8-4793-9cce-6ff9f4d68cb0","responses":{"201":"e81bb596-d608-40b0-bf47-9bceafb7f97b","401":"bbe31d50-c7ca-487f-af29-3338799147d5","403":"55495ebc-047c-477c-8fa8-9b9e6383d58d","404":"8200df48-d245-484b-b2c2-1ffe9bec6288","422":"39391865-6b99-43a5-b27d-40bfd02c07c3"},"method":"post","type":"path","servers":["0ff2d9c6-a890-4ecc-a546-4c34d334ff8c"],"security":["f64d25d8-5722-4c14-8f98-5add2fcd7ed1"],"path":"/workspaces/{workspace}/posts","baseUrlOptions":["https://api.publishbuddy.com/v1"],"title":"Create Post(s)","description":"","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"160beb21-a3e2-409d-90df-f938719b7348":{"name":"workspace","in":"path","required":true,"description":"The workspace UUID","schema":{"type":"string","isRequired":true,"description":"The workspace UUID","uniqueKey":"","typeLabel":"string"}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"posts":{"type":"array","items":{"type":"object","properties":{"content":{"oneOf":[{"type":"string","maxLength":10000,"uniqueKey":"posts.items.[INDEX].content.oneOf.0","typeLabel":"string"},{"type":"null","maxLength":10000,"uniqueKey":"posts.items.[INDEX].content.oneOf.1","typeLabel":"null"}],"uniqueKey":"posts.items.[INDEX].content","typeLabel":"string | null"},"profile_id":{"type":"string","format":"uuid","description":"Profile UUID this post targets (from GET /workspaces/{workspace}/profiles). Required unless `status` is `draft`.","uniqueKey":"posts.items.[INDEX].profile_id","typeLabel":"string\u003cuuid>"},"media_ids":{"type":"array","items":{"type":"string","format":"uuid","uniqueKey":"posts.items.[INDEX].media_ids.items.[INDEX]","typeLabel":"string\u003cuuid>"},"maxItems":8,"uniqueKey":"posts.items.[INDEX].media_ids","typeLabel":"string\u003cuuid>[]"},"link":{"type":"string","maxLength":250,"uniqueKey":"posts.items.[INDEX].link","typeLabel":"string"},"status":{"type":"string","description":"Status to save the post with: `waiting` (scheduled), `draft` or `needs_approval`. Required with `profile_id`.","enum":["waiting","draft","needs_approval"],"uniqueKey":"posts.items.[INDEX].status","typeLabel":"enum\u003cstring>"},"publish_type":{"type":"string","description":"How the post publishes: `queue_using_timeslots`, `schedule_using_fixed_datetime` or `now`. Required with `profile_id`.","enum":["queue_using_timeslots","schedule_using_fixed_datetime","now"],"uniqueKey":"posts.items.[INDEX].publish_type","typeLabel":"enum\u003cstring>"},"scheduled_for":{"oneOf":[{"type":"string","format":"date-time","description":"Publish time (ISO 8601). An explicit offset wins, else interpreted in `timezone`, else UTC. Never the account timezone.","uniqueKey":"posts.items.[INDEX].scheduled_for.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"Publish time (ISO 8601). An explicit offset wins, else interpreted in `timezone`, else UTC. Never the account timezone.","uniqueKey":"posts.items.[INDEX].scheduled_for.oneOf.1","typeLabel":"null"}],"uniqueKey":"posts.items.[INDEX].scheduled_for","typeLabel":"string\u003cdate-time> | null"},"timezone":{"type":"string","description":"IANA timezone used to interpret a bare `scheduled_for` datetime (default UTC)","uniqueKey":"posts.items.[INDEX].timezone","typeLabel":"string"},"platform_content":{"type":"array","items":{"type":"string","uniqueKey":"posts.items.[INDEX].platform_content.items.[INDEX]","typeLabel":"string"},"uniqueKey":"posts.items.[INDEX].platform_content","typeLabel":"string[]"},"labels":{"type":"array","items":{"type":"string","maxLength":250,"uniqueKey":"posts.items.[INDEX].labels.items.[INDEX]","typeLabel":"string"},"uniqueKey":"posts.items.[INDEX].labels","typeLabel":"string[]"},"queue_side":{"type":"string","enum":["top","bottom"],"uniqueKey":"posts.items.[INDEX].queue_side","typeLabel":"enum\u003cstring>"},"preview":{"type":"object","properties":{"title":{"oneOf":[{"type":"string","maxLength":512,"uniqueKey":"posts.items.[INDEX].preview.title.oneOf.0","typeLabel":"string"},{"type":"null","maxLength":512,"uniqueKey":"posts.items.[INDEX].preview.title.oneOf.1","typeLabel":"null"}],"uniqueKey":"posts.items.[INDEX].preview.title","typeLabel":"string | null"},"description":{"oneOf":[{"type":"string","maxLength":2048,"uniqueKey":"posts.items.[INDEX].preview.description.oneOf.0","typeLabel":"string"},{"type":"null","maxLength":2048,"uniqueKey":"posts.items.[INDEX].preview.description.oneOf.1","typeLabel":"null"}],"uniqueKey":"posts.items.[INDEX].preview.description","typeLabel":"string | null"},"url":{"oneOf":[{"type":"string","maxLength":512,"uniqueKey":"posts.items.[INDEX].preview.url.oneOf.0","typeLabel":"string"},{"type":"null","maxLength":512,"uniqueKey":"posts.items.[INDEX].preview.url.oneOf.1","typeLabel":"null"}],"uniqueKey":"posts.items.[INDEX].preview.url","typeLabel":"string | null"},"images":{"type":"array","items":{"type":"string","maxLength":512,"uniqueKey":"posts.items.[INDEX].preview.images.items.[INDEX]","typeLabel":"string"},"uniqueKey":"posts.items.[INDEX].preview.images","typeLabel":"string[]"}},"uniqueKey":"posts.items.[INDEX].preview","typeLabel":"object"},"comments":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string","maxLength":1000,"uniqueKey":"posts.items.[INDEX].comments.items.[INDEX].text","typeLabel":"string"},"delay_n":{"type":"integer","minimum":1,"maximum":100,"uniqueKey":"posts.items.[INDEX].comments.items.[INDEX].delay_n","typeLabel":"integer"},"delay_type":{"type":"string","enum":["minutes","hours","days"],"uniqueKey":"posts.items.[INDEX].comments.items.[INDEX].delay_type","typeLabel":"enum\u003cstring>"},"media_ids":{"type":"array","items":{"type":"string","format":"uuid","uniqueKey":"posts.items.[INDEX].comments.items.[INDEX].media_ids.items.[INDEX]","typeLabel":"string\u003cuuid>"},"uniqueKey":"posts.items.[INDEX].comments.items.[INDEX].media_ids","typeLabel":"string\u003cuuid>[]"}},"uniqueKey":"posts.items.[INDEX].comments.items.[INDEX]","typeLabel":"object"},"uniqueKey":"posts.items.[INDEX].comments","typeLabel":"object[]"},"publication_method":{"oneOf":[{"type":"string","enum":["auto","notification"],"uniqueKey":"posts.items.[INDEX].publication_method.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["auto","notification"],"uniqueKey":"posts.items.[INDEX].publication_method.oneOf.1","typeLabel":"null"}],"uniqueKey":"posts.items.[INDEX].publication_method","typeLabel":"enum\u003cstring> | null"}},"uniqueKey":"posts.items.[INDEX]","typeLabel":"object"},"minItems":1,"maxItems":10,"isRequired":true,"uniqueKey":"posts","typeLabel":"object[]"}},"required":["posts"],"title":"StorePostRequestStub","uniqueKey":"","typeLabel":"StorePostRequestStub · object"},"examples":{"Example":{"title":"Example","value":{"posts":[{"content":"\u003cstring>","profile_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","media_ids":["3c90c3cc-0d44-4b50-8888-8dd25736052a"],"link":"\u003cstring>","scheduled_for":"2023-11-07T05:31:56Z","timezone":"\u003cstring>","platform_content":["\u003cstring>"],"labels":["\u003cstring>"],"preview":{"title":"\u003cstring>","description":"\u003cstring>","url":"\u003cstring>","images":["\u003cstring>"]},"comments":[{"text":"\u003cstring>","delay_n":50,"media_ids":["3c90c3cc-0d44-4b50-8888-8dd25736052a"]}]}]}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"e81bb596-d608-40b0-bf47-9bceafb7f97b":{"description":"Array of `PostResource`","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Post UUID","isRequired":true,"uniqueKey":"data.items.[INDEX].id","typeLabel":"string"},"group_id":{"oneOf":[{"type":"string","description":"Shared group ID for posts created in the same bulk request","isRequired":true,"uniqueKey":"data.items.[INDEX].group_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"Shared group ID for posts created in the same bulk request","isRequired":true,"uniqueKey":"data.items.[INDEX].group_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].group_id","typeLabel":"string | null"},"content":{"oneOf":[{"type":"string","description":"Post text","isRequired":true,"uniqueKey":"data.items.[INDEX].content.oneOf.0","typeLabel":"string"},{"type":"null","description":"Post text","isRequired":true,"uniqueKey":"data.items.[INDEX].content.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].content","typeLabel":"string | null"},"profile_id":{"oneOf":[{"type":"string","description":"Profile UUID this post targets","isRequired":true,"uniqueKey":"data.items.[INDEX].profile_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"Profile UUID this post targets","isRequired":true,"uniqueKey":"data.items.[INDEX].profile_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].profile_id","typeLabel":"string | null"},"scheduled_for":{"oneOf":[{"type":"string","description":"Scheduled publish time in ISO 8601 UTC","isRequired":true,"uniqueKey":"data.items.[INDEX].scheduled_for.oneOf.0","typeLabel":"string"},{"type":"null","description":"Scheduled publish time in ISO 8601 UTC","isRequired":true,"uniqueKey":"data.items.[INDEX].scheduled_for.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].scheduled_for","typeLabel":"string | null"},"media_ids":{"type":"array","description":"Attached media UUIDs","items":{"type":"string","uniqueKey":"data.items.[INDEX].media_ids.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"data.items.[INDEX].media_ids","typeLabel":"string[]"},"media":{"type":"array","description":"Attached media metadata","items":{"type":"object","properties":{"media_id":{"type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].media.items.[INDEX].media_id","typeLabel":"string"},"type":{"type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].media.items.[INDEX].type","typeLabel":"string"},"width":{"oneOf":[{"type":"integer","isRequired":true,"uniqueKey":"data.items.[INDEX].media.items.[INDEX].width.oneOf.0","typeLabel":"integer"},{"type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].media.items.[INDEX].width.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].media.items.[INDEX].width","typeLabel":"integer | null"},"height":{"oneOf":[{"type":"integer","isRequired":true,"uniqueKey":"data.items.[INDEX].media.items.[INDEX].height.oneOf.0","typeLabel":"integer"},{"type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].media.items.[INDEX].height.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].media.items.[INDEX].height","typeLabel":"integer | null"},"duration":{"oneOf":[{"type":"integer","isRequired":true,"uniqueKey":"data.items.[INDEX].media.items.[INDEX].duration.oneOf.0","typeLabel":"integer"},{"type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].media.items.[INDEX].duration.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].media.items.[INDEX].duration","typeLabel":"integer | null"}},"required":["media_id","type","width","height","duration"],"uniqueKey":"data.items.[INDEX].media.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.items.[INDEX].media","typeLabel":"object[]"},"platform_content":{"oneOf":[{"type":"object","description":"Per-platform settings keyed by platform slug (e.g. `instagram`, `tiktok`)","additionalProperties":{"type":"object","additionalProperties":{"oneOf":[{}],"uniqueKey":"data.items.[INDEX].platform_content.oneOf.0.additionalProperties.additionalProperties","typeLabel":"any"},"uniqueKey":"data.items.[INDEX].platform_content.oneOf.0.additionalProperties","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.items.[INDEX].platform_content.oneOf.0","typeLabel":"object"},{"type":"null","description":"Per-platform settings keyed by platform slug (e.g. `instagram`, `tiktok`)","additionalProperties":{"type":"object","additionalProperties":{"oneOf":[{}],"uniqueKey":"data.items.[INDEX].platform_content.oneOf.1.additionalProperties.additionalProperties","typeLabel":"any"},"uniqueKey":"data.items.[INDEX].platform_content.oneOf.1.additionalProperties","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.items.[INDEX].platform_content.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].platform_content","typeLabel":"object | null"},"publish_type":{"oneOf":[{"type":"string","description":"Publish mode: `queue_using_timeslots`, `schedule_using_fixed_datetime`, `now`, `recurring`","isRequired":true,"uniqueKey":"data.items.[INDEX].publish_type.oneOf.0","typeLabel":"string"},{"type":"null","description":"Publish mode: `queue_using_timeslots`, `schedule_using_fixed_datetime`, `now`, `recurring`","isRequired":true,"uniqueKey":"data.items.[INDEX].publish_type.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].publish_type","typeLabel":"string | null"},"status":{"oneOf":[{"type":"string","description":"Post status: `waiting`, `publishing`, `published`, `failed`, `needs_approval`, `draft`","isRequired":true,"uniqueKey":"data.items.[INDEX].status.oneOf.0","typeLabel":"string"},{"type":"null","description":"Post status: `waiting`, `publishing`, `published`, `failed`, `needs_approval`, `draft`","isRequired":true,"uniqueKey":"data.items.[INDEX].status.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].status","typeLabel":"string | null"},"created_at":{"type":"string","description":"Creation timestamp in ISO 8601 UTC","isRequired":true,"uniqueKey":"data.items.[INDEX].created_at","typeLabel":"string"},"updated_at":{"type":"string","description":"Last update timestamp in ISO 8601 UTC","isRequired":true,"uniqueKey":"data.items.[INDEX].updated_at","typeLabel":"string"},"link":{"oneOf":[{"type":"string","description":"Optional link attached to the post","isRequired":true,"uniqueKey":"data.items.[INDEX].link.oneOf.0","typeLabel":"string"},{"type":"null","description":"Optional link attached to the post","isRequired":true,"uniqueKey":"data.items.[INDEX].link.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].link","typeLabel":"string | null"},"labels":{"type":"array","description":"Labels attached to the post","items":{"type":"object","properties":{"name":{"type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].labels.items.[INDEX].name","typeLabel":"string"}},"required":["name"],"uniqueKey":"data.items.[INDEX].labels.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.items.[INDEX].labels","typeLabel":"object[]"},"comments":{"type":"array","description":"First-comment thread items","items":{"type":"object","properties":{"id":{"type":"string","description":"ID","isRequired":true,"uniqueKey":"data.items.[INDEX].comments.items.[INDEX].id","typeLabel":"string"},"text":{"type":"string","description":"Text of comment","isRequired":true,"uniqueKey":"data.items.[INDEX].comments.items.[INDEX].text","typeLabel":"string"},"delay_n":{"oneOf":[{"type":"integer","description":"Amount of time to delay the post, represented as a number","isRequired":true,"uniqueKey":"data.items.[INDEX].comments.items.[INDEX].delay_n.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Amount of time to delay the post, represented as a number","isRequired":true,"uniqueKey":"data.items.[INDEX].comments.items.[INDEX].delay_n.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].comments.items.[INDEX].delay_n","typeLabel":"integer | null"},"delay_type":{"type":"string","description":"Unit of time used for delay. Example: minutes, hours, days","isRequired":true,"uniqueKey":"data.items.[INDEX].comments.items.[INDEX].delay_type","typeLabel":"string"},"media_ids":{"type":"array","description":"Attached media UUIDs","items":{"type":"string","uniqueKey":"data.items.[INDEX].comments.items.[INDEX].media_ids.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"data.items.[INDEX].comments.items.[INDEX].media_ids","typeLabel":"string[]"},"media":{"type":"array","description":"Media content Info which included in comment","items":{"type":"object","properties":{"media_id":{"type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].comments.items.[INDEX].media.items.[INDEX].media_id","typeLabel":"string"},"type":{"type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].comments.items.[INDEX].media.items.[INDEX].type","typeLabel":"string"},"width":{"oneOf":[{"type":"integer","isRequired":true,"uniqueKey":"data.items.[INDEX].comments.items.[INDEX].media.items.[INDEX].width.oneOf.0","typeLabel":"integer"},{"type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].comments.items.[INDEX].media.items.[INDEX].width.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].comments.items.[INDEX].media.items.[INDEX].width","typeLabel":"integer | null"},"height":{"oneOf":[{"type":"integer","isRequired":true,"uniqueKey":"data.items.[INDEX].comments.items.[INDEX].media.items.[INDEX].height.oneOf.0","typeLabel":"integer"},{"type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].comments.items.[INDEX].media.items.[INDEX].height.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].comments.items.[INDEX].media.items.[INDEX].height","typeLabel":"integer | null"},"duration":{"oneOf":[{"type":"integer","isRequired":true,"uniqueKey":"data.items.[INDEX].comments.items.[INDEX].media.items.[INDEX].duration.oneOf.0","typeLabel":"integer"},{"type":"null","isRequired":true,"uniqueKey":"data.items.[INDEX].comments.items.[INDEX].media.items.[INDEX].duration.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].comments.items.[INDEX].media.items.[INDEX].duration","typeLabel":"integer | null"}},"required":["media_id","type","width","height","duration"],"uniqueKey":"data.items.[INDEX].comments.items.[INDEX].media.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.items.[INDEX].comments.items.[INDEX].media","typeLabel":"object[]"},"status":{"oneOf":[{"type":"string","description":"Comment status: `waiting`, `publishing`, `published`, `failed`","isRequired":true,"uniqueKey":"data.items.[INDEX].comments.items.[INDEX].status.oneOf.0","typeLabel":"string"},{"type":"null","description":"Comment status: `waiting`, `publishing`, `published`, `failed`","isRequired":true,"uniqueKey":"data.items.[INDEX].comments.items.[INDEX].status.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].comments.items.[INDEX].status","typeLabel":"string | null"},"published_at":{"oneOf":[{"type":"string","description":"Actual publish time in ISO 8601 UTC","isRequired":true,"uniqueKey":"data.items.[INDEX].comments.items.[INDEX].published_at.oneOf.0","typeLabel":"string"},{"type":"null","description":"Actual publish time in ISO 8601 UTC","isRequired":true,"uniqueKey":"data.items.[INDEX].comments.items.[INDEX].published_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].comments.items.[INDEX].published_at","typeLabel":"string | null"},"error_message":{"oneOf":[{"type":"string","description":"Why the comment failed to publish; null unless `status` is `failed`","isRequired":true,"uniqueKey":"data.items.[INDEX].comments.items.[INDEX].error_message.oneOf.0","typeLabel":"string"},{"type":"null","description":"Why the comment failed to publish; null unless `status` is `failed`","isRequired":true,"uniqueKey":"data.items.[INDEX].comments.items.[INDEX].error_message.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].comments.items.[INDEX].error_message","typeLabel":"string | null"}},"required":["id","text","delay_n","delay_type","media_ids","media","status","published_at","error_message"],"title":"CommentResource","uniqueKey":"data.items.[INDEX].comments.items.[INDEX]","typeLabel":"CommentResource · object"},"isRequired":true,"uniqueKey":"data.items.[INDEX].comments","typeLabel":"CommentResource · object[]"},"published_at":{"oneOf":[{"type":"string","description":"Actual publish time in ISO 8601 UTC","isRequired":true,"uniqueKey":"data.items.[INDEX].published_at.oneOf.0","typeLabel":"string"},{"type":"null","description":"Actual publish time in ISO 8601 UTC","isRequired":true,"uniqueKey":"data.items.[INDEX].published_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].published_at","typeLabel":"string | null"},"post_url":{"oneOf":[{"type":"string","description":"URL of the post on the network; null until published","isRequired":true,"uniqueKey":"data.items.[INDEX].post_url.oneOf.0","typeLabel":"string"},{"type":"null","description":"URL of the post on the network; null until published","isRequired":true,"uniqueKey":"data.items.[INDEX].post_url.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].post_url","typeLabel":"string | null"},"social_post_id":{"oneOf":[{"type":"string","description":"UUID of the published post as the analytics endpoints report it; null until published","isRequired":true,"uniqueKey":"data.items.[INDEX].social_post_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"UUID of the published post as the analytics endpoints report it; null until published","isRequired":true,"uniqueKey":"data.items.[INDEX].social_post_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].social_post_id","typeLabel":"string | null"},"error_message":{"oneOf":[{"type":"string","description":"Last publish error for the active profile","isRequired":true,"uniqueKey":"data.items.[INDEX].error_message.oneOf.0","typeLabel":"string"},{"type":"null","description":"Last publish error for the active profile","isRequired":true,"uniqueKey":"data.items.[INDEX].error_message.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.items.[INDEX].error_message","typeLabel":"string | null"}},"required":["id","group_id","content","profile_id","scheduled_for","media_ids","media","platform_content","publish_type","status","created_at","updated_at","link","labels","comments","published_at","post_url","social_post_id","error_message"],"title":"PostResource","uniqueKey":"data.items.[INDEX]","typeLabel":"PostResource · object"},"isRequired":true,"uniqueKey":"data","typeLabel":"PostResource · object[]"},"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["data","message"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"data":[{"id":"\u003cstring>","group_id":"\u003cstring>","content":"\u003cstring>","profile_id":"\u003cstring>","scheduled_for":"\u003cstring>","media_ids":["\u003cstring>"],"media":[{"media_id":"\u003cstring>","type":"\u003cstring>","width":123,"height":123,"duration":123}],"platform_content":{},"publish_type":"\u003cstring>","status":"\u003cstring>","created_at":"\u003cstring>","updated_at":"\u003cstring>","link":"\u003cstring>","labels":[{"name":"\u003cstring>"}],"comments":[{"id":"\u003cstring>","text":"\u003cstring>","delay_n":123,"delay_type":"\u003cstring>","media_ids":["\u003cstring>"],"media":[{"media_id":"\u003cstring>","type":"\u003cstring>","width":123,"height":123,"duration":123}],"status":"\u003cstring>","published_at":"\u003cstring>","error_message":"\u003cstring>"}],"published_at":"\u003cstring>","post_url":"\u003cstring>","social_post_id":"\u003cstring>","error_message":"\u003cstring>"}],"message":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"bbe31d50-c7ca-487f-af29-3338799147d5":{"description":"Unauthenticated","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Error overview.","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["message"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"55495ebc-047c-477c-8fa8-9b9e6383d58d":{"description":"Authorization error","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Error overview.","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["message"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"8200df48-d245-484b-b2c2-1ffe9bec6288":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Error overview.","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["message"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"39391865-6b99-43a5-b27d-40bfd02c07c3":{"description":"Validation error","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Errors overview.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"errors":{"type":"object","description":"A detailed description of each field that failed validation.","additionalProperties":{"type":"array","items":{"type":"string","uniqueKey":"errors.additionalProperties.items.[INDEX]","typeLabel":"string"},"uniqueKey":"errors.additionalProperties","typeLabel":"string[]"},"isRequired":true,"uniqueKey":"errors","typeLabel":"object"}},"required":["message","errors"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>","errors":{}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"f64d25d8-5722-4c14-8f98-5add2fcd7ed1":{"bearerAuth":{"type":"http","description":"Personal access token, sent as `Authorization: Bearer \u003ctoken>`.","scheme":"bearer","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"0ff2d9c6-a890-4ecc-a546-4c34d334ff8c":{"url":"https://api.publishbuddy.com/v1"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","description":"Personal access token, sent as `Authorization: Bearer \u003ctoken>`.","scheme":"bearer","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Personal access token, sent as `Authorization: Bearer \u003ctoken>`.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"openapi.json"},"subdomain":"publishbuddy","siteName":"PublishBuddy","title":"Create Post(s) - PublishBuddy","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-26T13:05:28.516Z","originalFileLocation":"api-reference/post/create-posts.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=\"application-name\" content=\"PublishBuddy\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/publishbuddy/iqKPreMDX2VrWNz0/_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/publishbuddy/iqKPreMDX2VrWNz0/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/publishbuddy/iqKPreMDX2VrWNz0/_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/publishbuddy/iqKPreMDX2VrWNz0/_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/publishbuddy/iqKPreMDX2VrWNz0/_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/publishbuddy/iqKPreMDX2VrWNz0/_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/publishbuddy/iqKPreMDX2VrWNz0/_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/publishbuddy/iqKPreMDX2VrWNz0/_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/publishbuddy/iqKPreMDX2VrWNz0/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create Post(s) - PublishBuddy\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"PublishBuddy\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.publishbuddy.com/api-reference/post/create-posts\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://publishbuddy.mintlify.app/_mintlify/api/og/v2?division=Posts\u0026amp;title=Create+Post%28s%29\u0026amp;theme=3b811a9f8f1a6056bac58497\u0026amp;signature=014f72778882ef4c9dc067169ec6f1d1b0f7ccd98564cf30c5139370aa5f2e21\">\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 Post(s) - PublishBuddy\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://publishbuddy.mintlify.app/_mintlify/api/og/v2?division=Posts\u0026amp;title=Create+Post%28s%29\u0026amp;theme=3b811a9f8f1a6056bac58497\u0026amp;signature=014f72778882ef4c9dc067169ec6f1d1b0f7ccd98564cf30c5139370aa5f2e21\">\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/publishbuddy/iqKPreMDX2VrWNz0/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"PublishBuddy\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#16A34A\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.publishbuddy.com/api-reference/post/create-posts\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/post/create-posts.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.publishbuddy.com/#organization\",\"name\":\"PublishBuddy\",\"url\":\"https://docs.publishbuddy.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/publishbuddy/nWUw0kTKKpQWMu-J/logo/light.svg?fit=max\u0026auto=format\u0026n=nWUw0kTKKpQWMu-J\u0026q=85\u0026s=7a9f81aaa0e5b318450d92898c212a63\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.publishbuddy.com#website\",\"name\":\"PublishBuddy\",\"url\":\"https://docs.publishbuddy.com\",\"publisher\":{\"@id\":\"https://docs.publishbuddy.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.publishbuddy.com/api-reference/post/create-posts#webpage\",\"url\":\"https://docs.publishbuddy.com/api-reference/post/create-posts\",\"name\":\"Create Post(s)\",\"dateModified\":\"2026-10-26T13:05:28.516Z\",\"isPartOf\":{\"@id\":\"https://docs.publishbuddy.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.publishbuddy.com/api-reference/post/create-posts#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.publishbuddy.com/api-reference/post/create-posts#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Posts\",\"item\":\"https://docs.publishbuddy.com/api-reference/post/get-list-of-posts\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create Post(s)\",\"item\":\"https://docs.publishbuddy.com/api-reference/post/create-posts\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.publishbuddy.com/api-reference/post/create-posts#apireference\",\"headline\":\"Create Post(s)\",\"name\":\"Create Post(s)\",\"url\":\"https://docs.publishbuddy.com/api-reference/post/create-posts\",\"mainEntityOfPage\":{\"@id\":\"https://docs.publishbuddy.com/api-reference/post/create-posts#webpage\"},\"dateModified\":\"2026-10-26T13:05:28.516Z\",\"publisher\":{\"@id\":\"https://docs.publishbuddy.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.publishbuddy.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"PublishBuddy\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"PublishBuddy","nav":{"global":{"anchors":[{"anchor":"Dashboard","icon":"house","href":"https://app.publishbuddy.com"},{"anchor":"Support","icon":"envelope","href":"mailto:hello@publishbuddy.com"}]},"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":""}]},{"tab":"API reference","groups":[{"group":"Overview","pages":[{"title":"API reference","icon":"code","href":"/api-reference/introduction"}]},{"group":"Workspaces","pages":[{"title":"Workspaces the authenticated user can access","deprecated":null,"version":null,"openapi":"/openapi.json get /workspaces","href":"/api-reference/workspace/workspaces-the-authenticated-user-can-access"}]},{"group":"Profiles","pages":[{"title":"Get list of profiles","deprecated":null,"version":null,"openapi":"/openapi.json get /workspaces/{workspace}/profiles","href":"/api-reference/profile/get-list-of-profiles"}]},{"group":"Posts","pages":[{"title":"Get list of posts","description":"Sorting:\npublish_at (asc) - default ordering\npublished_at (desc) - add this query to the URL \"?filters[sort_by]=published_at\" to order by the \"published_at\"","deprecated":null,"version":null,"openapi":"/openapi.json get /workspaces/{workspace}/posts","href":"/api-reference/post/get-list-of-posts"},{"title":"Create Post(s)","deprecated":null,"version":null,"openapi":"/openapi.json post /workspaces/{workspace}/posts","href":"/api-reference/post/create-posts"},{"title":"Get post info","description":null,"deprecated":null,"version":null,"openapi":"/openapi.json get /posts/{post}","href":"/api-reference/post/get-post-info"},{"title":"Update post","deprecated":null,"version":null,"openapi":"/openapi.json put /posts/{post}","href":"/api-reference/post/update-post"},{"title":"Delete post","deprecated":null,"version":null,"openapi":"/openapi.json delete /posts/{post}","href":"/api-reference/post/delete-post"},{"title":"Retry a failed post publication","deprecated":null,"version":null,"openapi":"/openapi.json put /posts/{post}/retry","href":"/api-reference/post/retry-a-failed-post-publication"}]},{"group":"Media library","pages":[{"title":"List of medias","deprecated":null,"version":null,"openapi":"/openapi.json get /workspaces/{workspace}/media_contents","href":"/api-reference/mediacontent/list-of-medias"},{"title":"Upload media","deprecated":null,"version":null,"openapi":"/openapi.json post /workspaces/{workspace}/media_contents","href":"/api-reference/mediacontent/upload-media"},{"title":"Request direct upload URLs","deprecated":null,"version":null,"openapi":"/openapi.json post /workspaces/{workspace}/media_contents/presign","href":"/api-reference/mediacontent/request-direct-upload-urls"},{"title":"Confirm direct uploads","deprecated":null,"version":null,"openapi":"/openapi.json post /workspaces/{workspace}/media_contents/confirm","href":"/api-reference/mediacontent/confirm-direct-uploads"},{"title":"Get media info","deprecated":null,"version":null,"openapi":"/openapi.json get /media_contents/{mediaContent}","href":"/api-reference/mediacontent/get-media-info"},{"title":"Update media","deprecated":null,"version":null,"openapi":"/openapi.json put /media_contents/{mediaContent}","href":"/api-reference/mediacontent/update-media"},{"title":"Delete media","deprecated":null,"version":null,"openapi":"/openapi.json delete /media_contents/{mediaContent}","href":"/api-reference/mediacontent/delete-media"}]},{"group":"Media library folders","pages":[{"title":"List of folders","deprecated":null,"version":null,"openapi":"/openapi.json get /workspaces/{workspace}/media_library/folders","href":"/api-reference/medialibraryfolder/list-of-folders"},{"title":"Create folder","deprecated":null,"version":null,"openapi":"/openapi.json post /workspaces/{workspace}/media_library/folders","href":"/api-reference/medialibraryfolder/create-folder"},{"title":"Show folder","deprecated":null,"version":null,"openapi":"/openapi.json get /media_library/folders/{folder}","href":"/api-reference/medialibraryfolder/show-folder"},{"title":"Update folder","deprecated":null,"version":null,"openapi":"/openapi.json patch /media_library/folders/{folder}","href":"/api-reference/medialibraryfolder/update-folder"},{"title":"Delete folder","deprecated":null,"version":null,"openapi":"/openapi.json delete /media_library/folders/{folder}","href":"/api-reference/medialibraryfolder/delete-folder"}]},{"group":"Analytics","pages":[{"title":"Cumulative metrics for all social posts tied to profiles in this workspace","deprecated":null,"version":null,"openapi":"/openapi.json get /analytics/workspaces/{workspace}","href":"/api-reference/workspaceanalytics/cumulative-metrics-for-all-social-posts-tied-to-profiles-in-this-workspace"},{"title":"Show profile analytics","deprecated":null,"version":null,"openapi":"/openapi.json get /analytics/profiles/{profile}","href":"/api-reference/profileanalytics/show-profile-analytics"},{"title":"Show best posting times heatmap","deprecated":null,"version":null,"openapi":"/openapi.json get /analytics/best_times","href":"/api-reference/besttimes/show-best-posting-times-heatmap"},{"title":"Show profile metrics","deprecated":null,"version":null,"openapi":"/openapi.json get /profiles/{profile}/metrics","href":"/api-reference/profilemetrics/show-profile-metrics"}]},{"group":"Hashtags","pages":[{"title":"List workspace hashtags","deprecated":null,"version":null,"openapi":"/openapi.json get /workspaces/{workspace}/hashtags","href":"/api-reference/workspacehashtags/list-workspace-hashtags"},{"title":"List profile hashtags","deprecated":null,"version":null,"openapi":"/openapi.json get /profiles/{profile}/hashtags","href":"/api-reference/profilehashtags/list-profile-hashtags"}]}]},{"tab":"MCP server","pages":[{"title":"MCP server","href":"/mcp-server/introduction"}]},{"tab":"Help","pages":[{"title":"Help","href":"/help"}]}]},"title":"Create Post(s) - PublishBuddy","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"]}