Skip to main content

Ghost.org Integration Setup Guide

Overview​

Bloggy AI's Ghost integration provides seamless publishing to both Ghost.org (hosted) and self-hosted Ghost installations using the Ghost Admin API. This integration offers direct API communication without requiring browser automation, making it faster and more reliable than traditional publishing methods.

Prerequisites​

  • Active Ghost site (Ghost.org hosted or self-hosted Ghost v4.0+)
  • Admin access to your Ghost site
  • Bloggy AI account with integration permissions

Step-by-Step Setup​

1. Access Ghost Admin Panel​

  1. Navigate to your Ghost site's admin panel
    • For Ghost.org: https://yourblog.ghost.io/ghost/
    • For self-hosted: https://yourdomain.com/ghost/
  2. Log in with your admin credentials

2. Create Custom Integration​

  1. In Ghost Admin, navigate to Settings → Integrations
  2. Scroll down to the "Custom integrations" section
  3. Click "Add custom integration"
  4. Enter integration details:
  • Name: Bloggy AI Integration (or your preferred name)
  • Description: Integration for automated blog publishing via Bloggy AI

3. Retrieve API Credentials​

After creating the integration, you'll see:

  1. Admin API Key: A long string in format id:secret (e.g., 64a1f2b3c4d5e6f7:a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9t0u1v2w3x4y5z6)
  2. API URL: Your site's API endpoint (e.g., https://yourblog.ghost.io/ghost/api/admin/)
  3. Webhooks: (Optional - not required for basic publishing)

Important: Copy both the Admin API Key and API URL - you'll need these for Bloggy AI setup.

4. Configure Bloggy AI Integration​

  1. Log into your Bloggy AI dashboard
  2. Navigate to Integrations → Add Integration
  3. Select Ghost as your platform
  4. Fill in the required fields:
    • Integration Name: Choose a descriptive name (e.g., "My Blog - Ghost")
    • Ghost Site URL: Enter your Ghost site URL (e.g., https://yourblog.ghost.io)
    • Admin API Key: Paste the Admin API Key from step 3

5. Test Connection​

  1. Click Save Integration
  2. Bloggy AI will automatically test the connection
  3. If successful, you'll see your Ghost site details displayed
  4. The integration status should show as "Connected"

API URL Formats​

Ghost.org (Hosted)​

Site URL: https://yourblog.ghost.io
API URL: https://yourblog.ghost.io/ghost/api/admin/

Self-Hosted Ghost​

Site URL: https://yourdomain.com
API URL: https://yourdomain.com/ghost/api/admin/

Custom Subdirectory Installation​

Site URL: https://yourdomain.com/blog
API URL: https://yourdomain.com/blog/ghost/api/admin/

Supported Features​

✅ Supported​

  • Post Publishing: Create and publish posts directly
  • Draft Creation: Save posts as drafts for later review
  • SEO Metadata: Title, meta description, and canonical URLs
  • Tags: Automatic tag assignment and creation
  • Featured Images: Upload and set featured images
  • Custom Slugs: Set custom post URLs
  • Publication Scheduling: Schedule posts for future publication
  • Content Formatting: Rich text, HTML, and Markdown support
  • Author Assignment: Posts published under your Ghost account

❌ Not Supported​

  • Member-only Content: Visibility settings (public/members/paid)
  • Newsletter Sending: Email newsletter distribution
  • Comment Management: Post comment settings
  • Custom Post Types: Pages, custom content types
  • Theme Modifications: Template or design changes

Security Considerations​

API Key Security​

  • Never share your Admin API Key publicly
  • Rotate keys periodically for enhanced security
  • Revoke access immediately if compromised

Permissions​

The Ghost Admin API key provides:

  • Full read/write access to posts and pages
  • Tag and author management
  • Site settings (limited)
  • Does not provide: User management, theme changes, or billing access

Best Practices​

  1. Use descriptive integration names for easy identification
  2. Monitor integration activity in Ghost Admin → Settings → Integrations
  3. Regularly review connected integrations
  4. Keep your Ghost installation updated

Next Steps​

After successful setup:

  1. Create Blog Series: Set up automated content series using your Ghost integration
  2. Configure Scheduling: Set posting schedules across different time zones
  3. Test Publishing: Create a test post to verify everything works correctly
  4. Monitor Performance: Use Bloggy AI's analytics to track content performance

See also:

Need Help?​

If you encounter issues during setup:

  1. Check the troubleshooting section below
  2. Verify your Ghost version compatibility (v4.0+ required)
  3. Contact Bloggy AI support with your integration details (never share API keys)
Get started now

Last updated: March 2024