Payload CMS

Connect Knowatoa to your Payload CMS instance to automatically publish approved articles via the Payload API.

Requirements

• A running Payload CMS instance
• An API key with permission to create content

Setup

1. Go to your site in Knowatoa and click Integrations > CMS Connections > New Connection.
2. Select Payload.
3. Fill in the required fields:

1. Click Verify Credentials to confirm the connection works.
2. Click Save.

How articles are published

• Articles are sent to Payload via its REST API.
• Markdown content is converted to Payload’s Lexical richText format, preserving headings (h1-h6) and paragraphs.
• Each post includes the title and formatted body content.

Generating an API key

1. Log in to your Payload admin panel.
2. Navigate to your API Keys collection (or the users/authentication section, depending on your Payload configuration).
3. Create a new API key with permission to create content in your target collection.
4. Copy the key.

Troubleshooting

Verify Credentials fails - Confirm your Payload instance is running and accessible at the URL you provided. - Check that the API key is valid and has the correct permissions.

Articles fail to publish - Verify that your Payload content collection accepts the fields Knowatoa sends (title, content). - Check your Payload logs for any validation errors.

See Connect Your CMS for general CMS setup instructions.