Publish and schedule WordPress posts

What this means in practice

Connect WordPress with WordPress.com OAuth, select a discovered WordPress.com or Jetpack-connected site, then target that account like any other App9 Post destination. Put the article-specific fields under platform_configurations.wordpress. App9 Post uploads ready media to the selected site, builds the WordPress post payload, and records the returned numeric post ID and permalink as the target result.

Use the documented brand and account boundaries consistently across the scheduler, REST API, SDK, MCP tools, SSE consumers, and webhooks. That makes the same social operation explainable to an operator and reproducible by an integration.

Implementation checklist

1. Register a WordPress.com OAuth application or select an available App9-managed credential.

2. Authorize the posts, media, taxonomy, and sites scopes required by the publishing connector.

3. Select the numeric site account returned during discovery and inspect its live capabilities.

4. Provide title and content_html when publishing a full article; use caption as the safe text fallback.

5. Optionally provide excerpt, slug, status, numeric category and tag IDs, comment status, ping status, or an existing featured media ID.

6. Schedule with App9 Post publish_at so dispatch, approval, events, credits, and target-level reconciliation stay consistent with other destinations.

Example request

This example uses a server-side API key and an explicit brand selection. Replace placeholder values and keep credentials out of browser bundles, client logs, and source control.

curl --request POST \
  --url 'https://postapi.app9.co/v1/social-posts' \
  --header 'Authorization: Bearer APP9_POST_API_KEY' \
  --header 'X-App9-Post-Brand: BRAND_ID' \
  --header 'Content-Type: application/json' \
  --data '{
  "external_id": "cms-post-8841",
  "mode": "scheduled",
  "publish_at": "2026-08-01T14:00:00Z",
  "target_account_ids": [
    "wordpress_site_123"
  ],
  "caption": "Product launch",
  "platform_configurations": {
    "wordpress": {
      "title": "Product launch",
      "content_html": "<p>Complete launch article.</p>",
      "excerpt": "A brief launch summary.",
      "status": "publish",
      "categories": [
        4
      ],
      "tags": [
        9
      ]
    }
  },
  "timezone": "America/New_York"
}'

Open the complete API reference

Operational details

Common mistakes to avoid

Frequently asked questions