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

Publer supports three types of draft states, each with different visibility and account connection requirements:

• draft - Connected to specific social accounts with optional scheduling

• draft_public - Workspace-wide drafts visible to all workspace members (posts without social accounts)

• draft_private - Private drafts visible only to you (posts without social accounts)

Endpoint

POST /api/v1/posts/schedule

Use the same scheduling endpoint—with a draft state—to save work-in-progress content without publishing.

Draft Types & Examples

1. Account-Connected Draft (draft)

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

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

Key Features:

• Must include accounts array with account IDs

• Can include scheduled_at for future publishing

• Uses specific network configurations (e.g., facebook, instagram)

2. Public Workspace Draft (draft_public)

Drafts visible to all workspace members for collaboration and review.

{
  "bulk": {
    "state": "draft_public",
    "posts": [
      {
        "networks": {
          "default": {
            "type": "status",
            "text": "Draft"
          }
        }
      }
    ]
  }
}

Key Features:

• No accounts array required

• No scheduled_at field

• Uses default network configuration

• Visible to all workspace members

3. Private Draft (draft_private)

Drafts visible only to the creator for personal use and planning.

{
  "bulk": {
    "state": "draft_private",
    "posts": [
      {
        "networks": {
          "default": {
            "type": "status",
            "text": "Private Draft"
          }
        }
      }
    ]
  }
}

Key Features:

• No accounts array required

• No scheduled_at field

• Uses default network configuration

• Visible only to the creator

Parameters

Field	Type	Required	Description
bulk.state	string	Yes	Draft type: "draft", "draft_public", or "draft_private"
posts[].networks	object	Yes	Network configurations for the post
posts[].accounts	array	Only for "draft" state	Array of account objects with IDs and optional scheduling
accounts[].id	string	Yes (when accounts present)	Social account ID
accounts[].scheduled_at	string	No	ISO 8601 timestamp (only for "draft" state)

Network Configuration

• For draft state: Use specific network keys (facebook, instagram, twitter, etc.)

• For draft_public and draft_private: Use default as the network key

Best Practices

• Save Often: Create drafts early in your content creation process to avoid data loss

• Use Public Drafts for Collaboration: Share draft_public posts with your team for feedback and approvals

• Pre-schedule Account Drafts: Add scheduled_at to draft posts for seamless transition to scheduled state

• Organize by Purpose: Use private drafts for personal planning and public drafts for team collaboration

Related Topics

• Content Types

• Media Handling

• Publishing Methods