API Docs/Reference/Create Draft
API Reference
Create Draft
Create a new post draft. Attach media by setting post_type and one of media_url or media_urls. Requires a paid Creator or Lifetime plan.
POSThttps://api.linkedmash.com/v1/posts
Header parameters
AuthorizationstringRequired
Your secret API key as a Bearer token.
Body parameters
contentstringRequired
The post body text.
titlestringOptional
An optional title for the draft.
formatstringOptional
Post format: text, image, video, article, or poll.
post_typestringOptional
Media type to attach: text, image, video, or pdf. Set this when attaching media.
media_urlstringOptional
Public URL of an image, video, or PDF to attach.
media_urlsarrayOptional
Multiple public media URLs to attach.
media_mime_typestringOptional
MIME type of the attached media (e.g., 'image/png').
Response
{
"status": true,
"data": {
"id": "drf_8f3a21c9",
"content": "5 lessons from shipping every week for a year:",
"title": "Weekly shipping lessons",
"format": "text",
"status": "draft",
"created_at": "2026-06-22T09:14:02.118Z",
"updated_at": "2026-06-22T09:14:02.118Z"
}
}