WordPress

Connect Knowatoa to your WordPress site to automatically publish approved articles via the WordPress REST API.

Requirements

  • A self-hosted WordPress site (or WordPress.com Business plan or higher)
  • An admin user account
  • The WordPress REST API must be accessible (not blocked by security plugins)

Setup

  1. Go to your site in Knowatoa and click Integrations > CMS Connections > New Connection.
  2. Select WordPress.
  3. Fill in the required fields:
Field Description
Site URL Your WordPress address (e.g., https://example.com)
Username A WordPress admin username
Application Password A WordPress application password (not your regular login password)
  1. Click Verify Credentials to confirm the connection works.
  2. Click Save.

Generating an Application Password

WordPress Application Passwords provide API access without exposing your main login credentials.

  1. Log in to your WordPress admin dashboard.
  2. Go to Users > Your Profile.
  3. Scroll down to the Application Passwords section.
  4. Enter a name (e.g., “Knowatoa”) and click Add New Application Password.
  5. Copy the generated password – you won’t be able to see it again.

How articles are published

  • Articles are sent to WordPress as posts via the /wp-json/wp/v2/posts endpoint.
  • Each post includes the title, body content (converted from markdown to HTML), slug, and excerpt.
  • You can view the published URL from the CMS Connections page in Knowatoa.

Troubleshooting

Verify Credentials fails - Check that the REST API is accessible at https://yoursite.com/wp-json. Some security plugins (like Wordfence or iThemes) block REST API access. - Verify the username and application password are correct. - Make sure the user has admin or editor permissions.

Articles fail to publish - Confirm the API user still has permission to create posts. - Check if your WordPress site has any content moderation plugins that might reject programmatic posts.

See Connect Your CMS for general CMS setup instructions.