Integrations

WordPress Integration

Welcome! This guide will help you connect your WordPress website to Blogree. We'll install a simple plugin and set up a webhook so that when you publish a post in Blogree, it instantly appears on your WordPress site.

Estimated setup time: 5 minutes

1. Get Your Webhook Secret from Blogree

Your website needs a secure key (called a "webhook secret") to verify that requests are really coming from Blogree and not from someone else trying to trick your site.

  1. Log in to your Blogree Dashboard
  2. Go to Sites and click on your WordPress site
  3. Click the Settings tab
  4. Find the Webhook Secret (it looks like: whs_xxxxxxxxxxxxx)
  5. Copy this secret— you'll need it in a later step

2. Download the Plugin

We've created an official Blogree WordPress plugin that handles everything. Download it here:

Download Blogree WordPress Plugin (ZIP)

3. Install the Plugin in WordPress

Now let's add the plugin to your WordPress site:

  1. Log in to your WordPress admin dashboard
  2. Go to Plugins → Add New
  3. Click Upload Plugin (at the top)
  4. Click Choose File and select the wordpress-plugin.zip you downloaded
  5. Click Install Now
  6. After installation, click Activate Plugin

4. Add Your Webhook Secret to WordPress Settings

Now you need to tell WordPress your webhook secret:

  1. In WordPress admin, go to Settings → Blogree Sync
  2. You'll see a text field labeled Webhook Secret
  3. Paste the secret you copied from Blogree in Step 1
  4. Click Save Changes

✅ That's it! WordPress now has your secret saved and is ready to receive posts from Blogree.

5. Get Your Webhook Endpoint URL

On the same Settings → Blogree Sync page, you'll see your Webhook Endpoint URL displayed. It looks something like this:

text
https://yoursite.com/wp-json/blogree/v1/sync

Copy this entire URL— you'll need it for the next step.

6. Connect Blogree to Your WordPress Site

Now tell Blogree where to send your posts:

  1. Go back to your Blogree Dashboard
  2. Go to Sites and click on your WordPress site
  3. Go to Settings
  4. Find the Webhook URL field
  5. Paste your webhook endpoint URL (from Step 5)
  6. Make sure the Webhook Secret matches exactly what you added to WordPress
  7. Click Save

7. Test Your Connection

Let's verify everything is working correctly:

  1. In Blogree, go to your site Settings
  2. Click Test Delivery or Test Webhook
  3. You should see a green checkmark ✓ and a message saying "Success" or "200 OK"

If you see an error: Go back to Step 4 and make sure your webhook secret in WordPress Settings matches exactly the one in Blogree (no extra spaces).

8. Publish Your First Post

You're all set! Now let's test with a real post:

  1. In Blogree, create and publish a new post
  2. Wait 5 seconds
  3. Go to your WordPress dashboard
  4. Go to Posts
  5. Your Blogree post should appear there automatically! ✅

How It Works

Publishing a Post

When you publish a post in Blogree, here's what happens:

  • Blogree creates a secure "signature" of your post
  • It sends your post data to your WordPress site's webhook URL
  • The plugin verifies the signature (makes sure it's really from Blogree)
  • WordPress creates the post automatically
  • The featured image is downloaded and set as the blog cover
  • SEO meta tags are added (if you use Yoast, RankMath, or AIOSEO)

Updating a Post

If you edit and re-publish a post in Blogree, WordPress finds the existing post (by comparing the slug/URL) and updates it instead of creating a duplicate.

Deleting a Post

If you delete a post in Blogree, WordPress automatically moves the corresponding post to Trash.

SEO Plugin Support

Blogree automatically fills in SEO meta tags for popular WordPress SEO plugins:

  • Yoast SEO ✅
  • RankMath ✅
  • AIOSEO ✅
  • SEOPress ✅

Your SEO meta description, SEO title, and featured image are all set automatically when your post arrives in WordPress.

Troubleshooting

Posts aren't appearing in WordPress

Check these things:

  • Is the webhook secret in WordPress exactly the same as in Blogree? (Check character-by-character with no extra spaces)
  • Did you refresh your permalinks? (Go to WordPress Settings → Permalinks → click Save Changes)
  • Are you using a security plugin like Wordfence? (Temporarily disable it to test)
  • Is the webhook URL correct? (Copy it again from Settings → Blogree Sync)

I get a "401 Unauthorized" error when testing

This means the signature verification failed. Your webhook secret doesn't match. Go back to Step 4 and make sure you copied the exact secret from Blogree with no extra spaces or characters.

Featured images aren't downloading

Make sure your hosting provider allows allow_url_fopen in PHP settings. Contact your hosting support to enable it if needed. Also, make sure you have a featured image/cover image set in Blogree for each post.

Posts appear but are empty or missing content

This usually means the HTML content isn't being passed correctly. Make sure you're using the latest version of the plugin. Delete the plugin and reinstall it with the latest download.

I'm getting "404 Not Found" error

Make sure your WordPress permalinks are NOT set to "Plain". Go to Settings → Permalinks and choose Post Name(or any option except "Plain").

I can see the plugin in WordPress but Settings → Blogree Sync doesn't exist

Try these steps:

  • Deactivate the plugin
  • Activate it again
  • Refresh the page
  • The Blogree Sync option should now appear under Settings

Need Help?

If you're still having issues:

  1. Check your webhook secret matches exactly (no spaces)
  2. Verify your webhook URL is correct
  3. Make sure permalinks are set to "Post Name" (not "Plain")
  4. Try disabling security plugins temporarily to test
  5. Contact Blogree support if you need further assistance