How do I connect Postiz to Wordpress?

[kamzata]

I read the docs but I didn't get how I should connect Wordpress to Postiz. Can anybody explain to me better?

[anjana-kanzariya]

I created a small step-by-step example showing how Postiz → WordPress integration actually works, including media example.
https://github.com/anjana-kanzariya/postiz-wp-integration-guide

It’s not an official solution—just a practical guide based on testing. Feel free to correct anything or add better examples.

[kamzata]

Thanks. I tried but it shows an 502 internal error once I try to add the Wordpress channel to Postiz. Postiz logs shows:

2|backend       | [Nest] 254  - 02/07/2026, 5:19:06 PM   ERROR [ExceptionsHandler] Organization not found
2|backend       | Error: Organization not found
2|backend       |     at NoAuthIntegrationsController.connectSocialMedia (/app/apps/backend/dist/apps/backend/src/api/routes/no.auth.integrations.controller.js:40:19)
2|backend       |     at process.processTicksAndRejections (node:internal/process/task_queues:105:5)

I tested it with Postiz v2.11.3 and with the latest v2.14.0.

I was able to successfully add Mastodon and Telegram channels.

[anjana-kanzariya]

Hey,

Sorry this didn't work. Thanks for sharing the logs.

The error is coming from connectSocialMedia inside Postiz, which is triggered when adding a WordPress channel from the Postiz UI. Our integration example only calls the Public Posts API (/public/v1/posts) using an API key, and does not interact with the channel connection endpoint.

The Organization not found error typically indicates that the Postiz instance does not have a valid organization record, or that the current user is not associated with one.

If this is a self-hosted setup, please verify:

1. That an organization exists in the database
2. That your user is linked to that organization
3. That database migrations have been run after upgrading

This appears to be a Postiz-side configuration issue rather than a WordPress integration issue.

[kamzata]

Yes, it is. It's a self-hosted setup. I upgraded to the latest v2.17.0 and now it seems to work. Thanks.