WordPress Integration Documentation

Learn how to integrate Repostra with your WordPress site using our official WordPress plugin.

Quick Start: Install the Repostra WordPress plugin from the WordPress Plugin Directory and follow the setup instructions below.

Installation

  1. Install the Plugin:
    • Go to your WordPress admin dashboard
    • Navigate to Plugins → Add New
    • Search for "Repostra"
    • Click Install Now and then Activate
  2. Configure the Plugin:
    • Go to Settings → Repostra in your WordPress admin
    • Copy the API Key displayed on the settings page
    • Note your WordPress site URL (e.g., https://yoursite.com)
  3. Connect Repostra:
    • Log in to your Repostra account
    • Go to Social Accounts
    • Click Add Account or edit an existing account
    • Select Platform: Website
    • Select Posting Method: WordPress Plugin
    • Enter your WordPress Site URL
    • Paste the API Key from WordPress
    • Save the account

How It Works

Once configured, Repostra will automatically send blog posts to your WordPress site. The plugin handles all the technical details - you just need to configure the connection and start publishing!

Authentication

The plugin uses API key authentication. Each webhook request includes the API key in the X-Repostra-API-Key header.

Security Note: Keep your API key secure and never share it publicly. The API key is unique to your WordPress installation and is used to verify that requests are coming from your Repostra account.

Content Format

The content field contains HTML-formatted text that preserves all formatting including:

  • Headings (H1-H6)
  • Paragraphs
  • Lists (ordered and unordered)
  • Blockquotes
  • Images
  • Tables

The plugin automatically converts this HTML into WordPress blocks (Gutenberg) for optimal editing experience.

Featured Images

If a featured_image_url is provided, the plugin will:

  1. Download the image from the provided URL
  2. Upload it to your WordPress media library
  3. Set it as the featured image for the post

Post Status and Categories

By default, posts are published immediately. You can configure this in the plugin settings:

  • Auto-publish: Posts are published immediately upon receipt
  • Draft mode: Posts are saved as drafts for review before publishing
  • Category assignment: Posts can be assigned to specific WordPress categories
  • Author assignment: Posts are assigned to a default WordPress user

Updating Posts

The plugin uses the repostra_post_id to identify existing posts. If you send an update webhook with the same repostra_post_id, the plugin will update the existing WordPress post instead of creating a new one.

Troubleshooting

Posts Not Appearing

  • Verify the API key matches in both Repostra and WordPress
  • Check that your WordPress site URL is correct (no trailing slash)
  • Ensure the plugin is activated
  • Check WordPress error logs for any issues
  • Verify your WordPress site is accessible from the internet

Formatting Issues

  • Ensure your WordPress theme supports Gutenberg blocks
  • Check that HTML is not being stripped by security plugins
  • Verify the content is being received correctly in the webhook logs

Image Issues

  • Verify the image URL is accessible from your WordPress server
  • Check WordPress file permissions for media uploads
  • Ensure your server has sufficient disk space

Plugin Information

https://wordpress.org/plugins/repostra/

Need Help?

If you need assistance with the WordPress integration, please visit our support page at repostra.app or check the plugin's support forum on WordPress.org.