Draft Posts

Create, manage, and publish draft posts that aren’t sent immediately. Drafts can be private (only you) or shared with your workspace for review and scheduling.

Endpoint

POST /api/v1/posts/schedule

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

Creating Drafts

Set the state to one of the following:

Draft Type	State Value	Visibility
Private Draft	draft_private	Only you
Workspace Draft	draft_public	All workspace members
Default Workspace	draft	Same as draft_public

Private Draft Example

{
  "bulk": {
    "state": "draft_private",
    "posts": [
      {
        "networks": {
          "facebook": {
            "type": "status",
            "text": "This is a private draft post."
          }
        },
        "accounts": [
          { "id": "66db83154e299efa19a2d8eb" }
        ]
      }
    ]
  }
}

Workspace Draft Example

{
  "bulk": {
    "state": "draft_public",
    "posts": [
      {
        "networks": {
          "facebook": {
            "type": "photo",
            "text": "Draft for team review.",
            "media": [
              { "id": "6813892b5ec8b1e65235ae9e", "type": "image" }
            ]
          }
        },
        "accounts": [
          { "id": "66db83154e299efa19a2d8eb" }
        ]
      }
    ]
  }
}

Best Practices

• Save Often: Persist drafts early to avoid data loss.

• Collaborate: Use draft_public for workspace feedback and approvals.

Related Topics

• Content Types

• Media Handling

• Publishing Methods