Immediate Publishing

Publish content to social networks instantly using the Publer API. This method skips scheduling and sends posts for immediate delivery.

Endpoint

POST /api/v1/posts/schedule/publish

Request Headers

Request Body

Use the standard bulk structure. Omit scheduled_at under accounts:

{
  "bulk": {
    "state": "scheduled",
    "posts": [
      {
        "networks": {
          // network provider as key, e.g., facebook, twitter etc.
          "[network_provider]": {
            "type": "[content_type]",
            "text": "Post content",
            // Additional properties based on content type
          }
        },
        "accounts": [
          {
            "id": "account_id"
            // No scheduled_at parameter
          }
        ]
      }
    ]
  }
}

Key Fields

• state: must be "scheduled" for immediate publishing

• networks: per-network content configuration (facebook, twitter, linkedin, etc.)

• accounts: list of target account IDs (no scheduled_at timestamp)

Sample Request

curl -X POST https://app.publer.com/api/v1/posts/schedule/publish \
  -H "Authorization: Bearer-API YOUR_API_KEY" \
  -H "Publer-Workspace-Id: YOUR_WORKSPACE_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "bulk": {
      "state": "scheduled",
      "posts": [
        {
          "networks": {
            "facebook": {
              "type": "status",
              "text": "Just published this update via the Publer API! #RealTimePosting"
            }
          },
          "accounts": [
            { "id": "66db83154e299efa19a2d8eb" }
          ]
        }
      ]
    }
  }'

Sample Response

Status: 200 OK

{ 
   "job_id": "6810dec617eae6d55d7a5e5b"
}

Use the returned job_id to poll /api/v1/job_status/{job_id} until status: "completed".

Important Considerations

• Delivery Timing

  • Posts are sent as soon as Publer processes the request.

  • Network-side processing may introduce slight delays.

  • Job remains in working state until all targets confirm receipt.

• Platform Requirements

  • All network-specific content rules still apply (e.g., character limits, media formats).

  • Some networks may perform additional reviews before public display.

  • Ensure the connected accounts have immediate-posting permissions.

Common Issues

Related Topics

• Content Types - Details on different content formats

• Media Handling - Information about uploading and managing media

• Network Reference - Platform-specific capabilities and limitations