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
- Go to your site in Knowatoa and click Integrations > CMS Connections > New Connection.
- Select WordPress.
- 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) |
- Click Verify Credentials to confirm the connection works.
- Click Save.
Generating an Application Password
WordPress Application Passwords provide API access without exposing your main login credentials.
- Log in to your WordPress admin dashboard.
- Go to Users > Your Profile.
- Scroll down to the Application Passwords section.
- Enter a name (e.g., “Knowatoa”) and click Add New Application Password.
- 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/postsendpoint. - 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.