# Immediate Publishing

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

### Endpoint

```html
POST /api/v1/posts/schedule/publish
```

### Request Headers

<table><thead><tr><th width="185.71710205078125">Header</th><th width="139.91455078125">Required</th><th>Description</th></tr></thead><tbody><tr><td>Authorization</td><td>Yes</td><td><code>Bearer-API YOUR_API_KEY</code></td></tr><tr><td>Publer-Workspace-Id</td><td>Yes</td><td>Workspace ID</td></tr><tr><td>Content-Type</td><td>Yes</td><td><code>application/json</code></td></tr><tr><td>Accept</td><td>No</td><td><code>application/json</code> (default)</td></tr></tbody></table>

### Request Body

Use the standard bulk structure. Omit `scheduled_at` under `accounts`:

```json
{
  "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

```bash
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

```json
{ 
   "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

<table data-header-hidden><thead><tr><th width="182.8759765625"></th><th></th></tr></thead><tbody><tr><td>Issue</td><td>Solution</td></tr><tr><td>Rate limiting</td><td>Space out immediate publishing requests to avoid triggering platform limits</td></tr><tr><td>Authentication errors</td><td>Check that social accounts are properly connected and authorized</td></tr><tr><td>Content rejection</td><td>Review platform guidelines for content that might be flagged</td></tr><tr><td>Processing delays</td><td>For media posts, allow extra time for media processing</td></tr></tbody></table>

### Related Topics

* [Content Types](/docs/posting/create-posts/content-types.md) - Details on different content formats
* [Media Handling](/docs/posting/create-posts/media-handling.md) - Information about uploading and managing media
* [Network Reference](/docs/posting/create-posts/networks.md) - Platform-specific capabilities and limitations


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://publer.com/docs/posting/create-posts/publishing-methods/immediate-publishing.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.