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"
  }
}