memo-circle-checkIdeas

What are Ideas?

Ideas are unfinished posts or content templates that aren’t linked to any specific social account yet. You can create them, work on them over time, collaborate with your team, and turn them into real posts whenever you’re ready.

Idea States

  • draft_public: visible to the entire workspace and editable by teammates (based on permissions)

  • draft_private: visible only to the creator

Endpoint

Ideas are created using the same bulk scheduling endpoint, but with an Idea state and no social accounts.

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)

Rules / Requirements

  • bulk.state must be draft_public or draft_private

  • Use networks.default

  • Ideas support two input modes:

    1. Rich content mode (recommended): type = "article" with title, content blocks, and optional media

    2. Simple content types: you can also submit status, photo, video, or link payloads; Publer will convert them automatically into the Idea content format (with tags) behind the scenes

  • At least one of title, content, or media must be present (for type: "article")

Rich content mode: Content blocks format

When using type: "article", content must be an array of blocks:

  • id: randomly generated string

  • type: one of the supported block types

  • data: object depending on block type

Example: Create an Idea (Public) — Rich Content (article)

Example: Create an Idea from a Simple Type (Auto-converted)

You can also create an Idea using other content types (for example status, photo, video, link). Publer will convert the payload into the Idea content format automatically (including tags).

Media Attachments (Ideas)

You can attach media to an Idea using networks.default.media.

Notes

  • media is an array.

  • Multiple attachments are supported for photos only.

  • Supported media types include photo and video (see network/provider specifics).

To attach media, first fetch/upload media using the Media or Media Handling, then reference the returned media objects in your payload.

Parameters

Bulk

Field
Type
Required
Description

bulk.state

string

Yes

draft_public or draft_private

bulk.posts

array

Yes

List of ideas to create

Post Object (Idea)

Field
Type
Required
Description

posts[].networks

object

Yes

Must contain default

posts[].networks.default.type

string

Yes

article (rich content) or a simple type like status, photo, video, link (auto-converted)

posts[].networks.default.title

string

Conditional

Used with type: "article"

posts[].networks.default.content

array

Conditional

Used with type: "article"

posts[].networks.default.text

string

Conditional

Used with type: "status" (and other simple types as applicable)

posts[].networks.default.media

array

No

Media attachments

Network Configuration

For Ideas (draft_public, draft_private):

  • Use default as the network key.

  • You can send either:

    • Rich content: type: "article" with title, content, and optional media, or

    • Simple types (e.g., status, photo, video, link) which are auto-converted into the Idea content format.

Best Practices

  • Save ideas early to avoid losing inspiration.

  • Use draft_public for collaboration and feedback.

  • Use draft_private for personal planning.

Last updated

Was this helpful?