Ideas

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)

{
  "bulk": {
    "state": "draft_public",
    "posts": [
      {
        "networks": {
          "default": {
            "type": "article",
            "content": [
              {
                "id": "YbGFey6MEB",
                "type": "header",
                "data": {
                  "text": "Header",
                  "level": 2
                }
              },
              {
                "id": "zqVkpTFkho",
                "type": "list",
                "data": {
                  "style": "ordered",
                  "items": [
                    "list 1",
                    "list 2"
                  ]
                }
              },
              {
                "id": "QuAHevc2WU",
                "type": "paragraph",
                "data": {
                  "text": "<b>bold</b>"
                }
              },
              {
                "id": "dV4AN6yEA8",
                "type": "paragraph",
                "data": {
                  "text": "<i>italic</i>"
                }
              },
              {
                "id": "tlk38yADuj",
                "type": "paragraph",
                "data": {
                  "text": "<a href=\"https://publer.com\" target=\"_blank\">publer.com</a>" // link
                }
              },
              {
                "id": "hmy78yADuj",
                "type": "paragraph",
                "data": {
                  "text": "This is a simple paragraph"
                }
              }
            ],
            "title": "Title of the idea",
            "media": [
              {
                "id": "69415914c507c632c080d1e4",
                "name": "",
                "caption": "photo.by.unsplach:\n\nhttps://unsplash.com/photos/a-decorated-christmas-tree-with-merry-christmas-sign-92PZ2FVPhDE",
                "favorite": null,
                "path": "https://cdn.publer.com/uploads/photos/69415914c507c632c080d1e4.jpg",
                "type": "photo",
                "created_at": "2025-12-16T14:05:24.095+01:00",
                "labels": [],
                "in_library": true,
                "width": 2000.0,
                "height": 3000.0,
                "size": 1384790.0,
                "source": "unsplash",
                "folder_id": null,
                "thumbnail": "https://cdn.publer.com/uploads/photos/thumb_69415914c507c632c080d1e4.jpg"
              }
            ]
          }
        }
      }
    ]
  }
}

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).

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

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.

Related Topics

• Content Types
• Media Handling
• Publishing Methods
• Media