Draft Posts

Create, manage, and collaborate on draft posts that aren't published immediately. Drafts help you save work-in-progress content, collaborate with your team, and schedule posts for later publishing.

Overview

Draft posts are unfinished posts connected to a social account. They can be:

• Dated drafts: drafts with a set date/time (these typically show up in Calendar views in the UI).
• Undated drafts: drafts without a set date/time (stored under Drafts in the UI for later review/scheduling).

Draft Posts are created via the scheduling endpoint using:

• bulk.state = "draft"

Draft Posts support the same post structures as normal scheduled/published posts, meaning you can create different kinds of drafts (photos, videos, carousels, reels, etc.) depending on the provider.

Endpoint

Use the scheduling endpoint with bulk.state: "draft" to save work-in-progress content without publishing.

POST /api/v1/posts/schedule

Request Headers

Header	Required	Value
Authorization	Yes	Bearer-API YOUR_API_KEY
Publer-Workspace-Id	Yes	Workspace ID
Content-Type	Yes	application/json
Accept	No	application/json (default)

Draft Type & Example

Account-Connected Draft (draft)

Drafts connected to specific social accounts that can optionally include scheduling information.

Key Features

• Must include accounts array with account IDs
• Can include scheduled_at for future publishing (dated drafts)
• Uses specific network keys (e.g., facebook, instagram, twitter, etc.)

Example Request

{
  "bulk": {
    "state": "draft",
    "posts": [
      {
        "networks": {
          "facebook": {
            "type": "status",
            "text": "First Draft"
          }
        },
        "accounts": [
          {
            "id": "647a0edddb2797b89044e2c1",
            "scheduled_at": "2025-06-23T10:43:00+02:00"
          }
        ]
      }
    ]
  }
}

Parameters

Bulk

Field	Type	Required	Description
bulk.state	string	Yes	Must be "draft" for Draft Posts
bulk.posts	array	Yes	List of posts to create

Post Object

Field	Type	Required	Description
posts[].networks	object	Yes	Network configurations for the post (use provider keys like facebook, instagram, etc.)
posts[].accounts	array	Yes	Social accounts the draft is connected to

Accounts (required for Draft Posts)

Field	Type	Required	Description
accounts[].id	string	Yes	Social account ID
accounts[].scheduled_at	string	No	ISO 8601 timestamp. If provided, the draft becomes a dated draft. If omitted, it’s an undated draft.

Network Configuration

• For Draft Posts (bulk.state = "draft"), use specific provider keys inside posts[].networks (e.g. facebook, instagram, twitter, etc.).
• The network payload structure depends on the provider and content type (e.g., status, photo, video, carousel, story, reel, etc.).
• Draft Posts support the same payload shapes as scheduled/published posts.

Content Types

Draft Posts can be created using any supported content type (the type field inside networks.[provider]).

See the full Content Types reference.

Best Practices

• Save often: create drafts early to avoid losing work-in-progress content.
• Use dated drafts as reminders: set scheduled_at to place drafts on a timeline for later review/publishing.
• Use the right tool: Draft Posts are for content already tied to specific social accounts. (Use Ideas for account-less planning and templates.)

Related Topics

• Content Types
• Publishing Methods
• Media Handling