Documentation

Connect WordPress to OutscoreAgent

This guide walks you through installing the OutscoreAgent Publisher plugin on your WordPress site and connecting it to the platform so you can publish AI-generated articles with one click.

Before you start

  • An OutscoreAgent account (free trial available)
  • A self-hosted WordPress site (version 6.0 or newer) with HTTPS enabled
  • WordPress admin access (administrator role)

Install the plugin

There are two ways to install the OutscoreAgent Publisher plugin on your WordPress site:

Option A: Install from the OutscoreAgent platform

  1. Log in to Dashboard → Integrations and click Add WordPress Site.
  2. On the first step of the wizard, click the Download OutscoreAgent Publisher Plugin button to get the latest ZIP file.
  3. In your WordPress admin, go to Plugins → Add New → Upload Plugin.
  4. Select the downloaded ZIP file, click Install Now, then Activate Plugin.

Option B: Search the WordPress plugin directory

  1. In your WordPress admin, go to Plugins → Add New.
  2. Search for “OutscoreAgent”.
  3. Click Install Now next to “OutscoreAgent Publisher,” then Activate.
Tip: After activation, you should see a new Settings → OutscoreAgent Publisher menu item in your WordPress admin sidebar. If you don’t, refresh the page.

Start the connection wizard

  1. On the OutscoreAgent platform, go to Dashboard → Integrations.
  2. Click Add WordPress Site. If you already downloaded the plugin in step 1, check the “I’ve installed and activated the plugin” box and click Next.
  3. Enter your WordPress site URL (e.g. https://yourdomain.com) and click Check Connection.
  4. The platform will verify that the plugin is active on your site. Once detected, it automatically advances to the token step.
Behind a firewall? If the connection check can’t reach your site, click the “skip this check” link that appears below the error message. You can still connect by entering your token manually in the next step.

Generate and paste your API token

This is where the WordPress plugin and the OutscoreAgent platform meet. You’ll generate a secure token in WordPress and paste it into the platform.

In your WordPress admin:

  1. Go to Settings → OutscoreAgent Publisher.
  2. Under the Connection section, click the Generate Token button.
  3. A yellow box will appear with your token (it starts with osk_). Click Copy to copy it to your clipboard.
Important: The token is shown only once. If you close the page without copying it, you’ll need to click Regenerate Token to create a new one.

Back on the OutscoreAgent platform:

  1. Paste the token into the API Token field. The border turns green when the format is valid.
  2. Click Connect. The platform will test the connection to your WordPress site.
  3. If the test passes, you’ll see a success screen confirming your site name and WordPress version.

You’re connected

Click Done to close the wizard. Your WordPress site now appears on the Integrations page with a green “Connected” badge.

You can now publish articles directly from the Content Pipeline. When an article is ready, click Publish to WordPress and it will appear on your site with the title, content, featured image, and SEO metadata already in place.

Troubleshooting

“No token configured” after generating one

A conflicting plugin may be interfering with the token save. Temporarily deactivate other plugins that modify WordPress options (security suites, caching plugins) and try generating the token again.

Connection check can’t find the plugin

Make sure the plugin is activated (not just installed). If your site is behind a firewall, CDN, or maintenance-mode plugin that blocks external requests, use the “skip this check” link and enter your token manually.

“Connection test failed” after pasting the token

  • Double-check that you pasted the full token (it starts with osk_ and is at least 36 characters).
  • Make sure your site uses HTTPS. The plugin rejects connections over plain HTTP.
  • If you use a JWT authentication plugin (e.g. “JWT Authentication for WP-API”), update the OutscoreAgent plugin to version 1.3.0 or later, which uses a dedicated header to avoid conflicts.

How to regenerate or revoke a token

In your WordPress admin, go to Settings → OutscoreAgent Publisher. Click Regenerate Token to create a new one (the old token stops working immediately). To disconnect entirely, click Revoke Token.

After regenerating, paste the new token into the OutscoreAgent Integrations page by editing your existing WordPress connection.

Optional: configure publishing defaults

The plugin’s settings page lets you set defaults that apply when OutscoreAgent publishes an article:

  • Default Post Status — Draft, Pending Review, or Published. Articles published via the “Publish to WordPress” button on the platform are sent as Published; this default applies only when the platform doesn’t specify a status.
  • Default Author — the WordPress user credited as the article author.
  • Default Category — the category assigned to new articles.
  • Featured Image — when enabled (default), featured images are downloaded into your WordPress media library so themes pick them up automatically.
  • Image Credits — controls how stock-photo credits are displayed. If your articles use Unsplash images, keep this set to “Active links” or “Active links with nofollow” to comply with Unsplash’s attribution requirements.

Ready to connect?

Head to the Integrations page and add your WordPress site in under two minutes.

Go to Integrations