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 schedulingdraft_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
Request Headers
Authorization
Yes
Bearer-API YOUR_API_KEY
Publer-Workspace-Id
Yes
Workspace ID for scheduling posts
Content-Type
Yes
application/json
Accept
No
application/json
(default)
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
)
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 IDsCan include
scheduled_at
for future publishingUses specific network configurations (e.g.,
facebook
,instagram
)
2. Public Workspace Draft (draft_public
)
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 requiredNo
scheduled_at
fieldUses
default
network configurationVisible to all workspace members
3. Private Draft (draft_private
)
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 requiredNo
scheduled_at
fieldUses
default
network configurationVisible only to the creator
Parameters
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
anddraft_private
: Usedefault
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 approvalsPre-schedule Account Drafts: Add
scheduled_at
todraft
posts for seamless transition to scheduled stateOrganize by Purpose: Use private drafts for personal planning and public drafts for team collaboration
Related Topics
Last updated
Was this helpful?