Connecting PayoutPress
PayoutPress writes affiliate content and publishes it to WordPress. Sites on AffiliateHost Unlimited and Enterprise VPS are ready for it out of the box: the WordPress REST API is on, HTTPS is automatic, and nothing on the platform blocks authenticated API requests. The connection itself takes a few minutes.
Before you start
- Your domain should be pointing at us with SSL active, so the site has a stable
https://address. See Your free SSL certificate. - You need a WordPress user with the Editor or Administrator role. Create a dedicated user for PayoutPress rather than using your own; it keeps the audit trail clean and lets you revoke access without changing your password.
1. Create an application password in WordPress
Application passwords are a built-in WordPress feature for exactly this: letting a tool publish on your behalf without your real password.
- Log in to the WordPress admin and open Users, then the user PayoutPress will publish as.
- Scroll to Application Passwords.
- Type a name such as
PayoutPressand press Add New Application Password. - Copy the password WordPress shows. It is shown once. Spaces in it do not matter.
If the Application Passwords section is missing, the site is not being served over HTTPS yet, or a security plugin has disabled the feature. Fix the HTTPS first; for a security plugin, look for a REST API or application passwords setting.
2. Add the site in PayoutPress
- In PayoutPress, add a WordPress site.
- Enter the site address with
https://, the WordPress username, and the application password from step 1. - Save and run the connection test.
3. Publish a test article
Send one short post as a draft first. Open it in the WordPress admin, check the formatting, the featured image, and the categories, then publish it from either side. Once a draft arrives cleanly, publishing live posts will work the same way.
Common problems
- 401 or "not allowed"
- The username or application password is wrong, or the user's role cannot publish. Recreate the application password and paste it again.
- Connection refused or timeout
- The site address is wrong, or the domain is not yet pointing at us. Check the DNS status on the site page.
- Posts arrive without images
- The user needs permission to upload media. Editor and Administrator roles have it; Author does too, Contributor does not.
- Security plugin blocks the API
- Allow the REST API for authenticated users. Our platform firewall does not block it, so the cause is inside WordPress.
Revoking access
To disconnect PayoutPress, delete the application password under the user's profile. Published posts stay. You can create a new password and reconnect at any time.
On Starter, the same steps work technically, but we mark PayoutPress as a feature of Unlimited and Enterprise VPS because the plans with unlimited sites are where publishing at volume makes sense.
Was this helpful? If something here is unclear or out of date, tell us and we will fix it.
Related articles
Detailed control panel how-tos live in the Help Desk inside your control panel. Open it from your account area.