POST/accounts/connect-credential
Connect a credential platform with the PostEverywhere API
Connects a credential-based platform entirely through the API, no browser involved. Credentials are validated live against the platform before saving; invalid credentials return a 400 with the reason. Re-submitting credentials for an already-connected account updates it in place (this is also how these platforms reconnect). Required fields by platform: telegram needs `bot_token` (from @BotFather; the bot must be an admin of the channel) and `channel` (@username or numeric chat id); discord needs `webhook_url`; bluesky needs `handle` and `app_password` (an app password, never the main account password); wordpress needs `site_url`, `username` and `app_password` (a WordPress Application Password from Users > Profile, never the login password; WordPress 5.6+). WordPress.com sites connect in the PostEverywhere app (browser sign-in), not through this endpoint. Error codes: `missing_credentials` (a required field is empty), `invalid_platform` (not a credential platform), `credential_connect_failed` (the platform refused the credentials; the message says why, e.g. a wrong Application Password or a site with the REST API turned off).
Guides: Connecting accounts guide · Account health guide
This endpoint accepts a JSON request body. See the accounts guide for a worked example.
Responses
- 200Account connected
- 400
- 401
- 402
- 403
- 429
- 500