PUBLISH WORDPRESS BLOG POST

Publishes a post to a WordPress site via the WP REST API (v2), supporting both Application Password (Basic Auth) and Bearer Token authentication. Uploads inline data-URI images embedded in the HTML body and any additional images dataset to the WordPress media library, rewriting <img> src attributes to the resulting hosted URLs before creating the post.

When to use

Tagged: basic_auth, bearer_token, blog, cms, draft, html, image_rewrite, integrations.

Inputs

Label ID Type Default Required Description
WordPress Site URL wp_site_url text Base URL of the WordPress site (e.g. https://example.com); trailing slashes are stripped automatically — required.
WordPress Username wp_username text   WordPress account username; required when authenticating via Application Password (wp_app_password); leave blank if using a Bearer token.
WordPress Application Password wp_app_password password   WordPress Application Password for HTTP Basic Auth; provide together with wp_username; leave blank if authenticating with a Bearer token via wp_api_key.
WordPress API Key / Bearer Token wp_api_key password   Bearer / JWT token issued by a WordPress auth plugin (e.g. JWT Auth); leave blank if authenticating with wp_app_password + wp_username.
Post Title title text Plain-text title of the WordPress post — required; mapped to the WP REST API title field.
Post HTML Content html_content textarea Full HTML body of the post — required; any inline data:image/*;base64,… src values are automatically uploaded to the media library and their src attributes rewritten to the hosted URL.
Additional Images images dataset   Optional dataset of supplemental images to append after the main content; each row may contain name, data_uri (base64 data URI), path (server filesystem path), or url (already-hosted URL); images are uploaded to the media library and appended as <img> tags.
Post Status status list draft   WordPress post status on creation; choose from draft (default), publish, pending, private, or future (scheduled); defaults to draft if an unrecognised value is supplied.
Categories categories text   Comma-separated list of category names or numeric IDs to assign to the post; names that do not yet exist in WordPress are created automatically.
Tags tags text   Comma-separated list of tag names or numeric IDs to assign to the post; names that do not yet exist in WordPress are created automatically.

Outputs

Label ID Type Description
Post ID post_id integer Integer WordPress post ID assigned by the REST API after successful creation; 0 if the request failed.
Post URL post_url text Canonical permalink URL of the newly created post as returned by the WP REST API link field; empty string on failure.
Published published boolean Boolean flag that is true only when a post was successfully created AND its final status is publish; false for draft, pending, private, or future posts.
Post Status post_status string The actual post status string returned by WordPress after creation (e.g. draft, publish, pending, private, future); reflects the server-side state, not the requested status.
Uploaded Images uploaded_images dataset Dataset of images successfully uploaded to the WordPress media library during this run; each row contains name (filename), media_id (WP attachment ID), and url (hosted source URL).
Status status string Human-readable summary message describing the outcome — includes post ID, final status, and count of images uploaded; contains an error description if post creation failed.

Disciplines

  • platform.integration
  • platform.reporter

Auto-generated from platform schema. Worker id: wordpress_post_blog. Schema hash: 97a55b661477. Hand-curated docs in workerexamples/ override this page when present.