Connect your Ghost publication to Wrodium for AI-powered content optimization.
Created date:
Dec 5, 2025
Updated date:
Dec 11, 2025
Prerequisites
Ghost 4.0 or later (self-hosted or Ghost Pro)
Admin access to your Ghost site
Custom Integration created in Ghost
Setup Steps
Step 1: Create a Custom Integration
Log into your Ghost Admin panel
Go to Settings → Integrations
Scroll to Custom Integrations
Click Add custom integration
Name it "Wrodium" and click Create
Step 2: Get Your Admin API Key
After creating the integration, you'll see:
Admin API Key: A long string in format
{id}:{secret}API URL: Your Ghost admin URL
Copy the Admin API Key — you'll need both parts (id and secret).
Step 3: Configure Wrodium
Go to Settings → CMS Connection in Wrodium
Select Ghost as your provider
Enter your configuration:
Field | Value | Example |
|---|---|---|
Admin URL | Your Ghost site URL |
|
Admin API Key | The full key with colon |
|
API Version | Ghost API version |
|
Click Test Connection then Save
Configuration Schema
API Behavior
Authentication
Ghost Admin API uses JWT authentication. Wrodium automatically:
Splits your API key into
{key_id}:{secret}Generates a short-lived JWT token
Signs requests with
Ghost {token}header
Listing Articles
Wrodium fetches posts via:
Updating Articles
Updates require the current updated_at timestamp (collision detection):
Content Format
Ghost uses HTML for post content by default. Wrodium sends optimized content as HTML.
Supported HTML elements:
Headings:
<h1>through<h6>Paragraphs:
<p>Lists:
<ul>,<ol>,<li>Links:
<a href="...">Images:
<img src="..." alt="...">Formatting:
<strong>,<em>,<code>Blockquotes:
<blockquote>Code blocks:
<pre><code>...</code></pre>
Lexical Format (Ghost 5.0+)
Ghost 5.0+ also supports Lexical JSON format. If your Ghost uses Lexical:
Wrodium can convert HTML to Lexical format when needed.
Post Status
Ghost Status | Description |
|---|---|
| Live on your site |
| Not published |
| Will publish at set time |
| Email newsletter sent |
When updating, set "status": "published" to keep content live.
API Version Compatibility
Ghost Version | API Version | Notes |
|---|---|---|
4.x |
| HTML content only |
5.x |
| Lexical or HTML |
5.70+ |
| Enhanced API |
Troubleshooting
"401 Unauthorized" Error
Verify the Admin API Key format:
{id}:{secret}Check that the integration is still active in Ghost
Ensure you're using the Admin API key, not the Content API key
"404 Not Found" Error
Verify the Admin URL doesn't have a trailing slash
Ensure the Ghost version matches the API version
"409 Conflict" Error (UpdateCollision)
The post was modified since you fetched it
Wrodium will automatically retry with the latest
updated_at
"422 Validation" Error
HTML content may contain unsupported tags
Check post slug format (lowercase, hyphens only)
SSL/TLS Errors (Self-Hosted)
Ensure your Ghost site has a valid SSL certificate
For self-signed certs, you may need to add exceptions
Code Example
Required Dependencies
For JWT token generation:
Webhooks (Optional)
Ghost can send webhooks when content changes:
Go to Settings → Integrations → Your Integration
Add a webhook:
Event: Post published
Target URL:
https://api.wrodium.com/webhooks/ghost/{your_brand_id}




