Ghost blog integration
Connect Spron to your Ghost blog through the Ghost Admin API by creating a custom integration, then entering its API URL and Admin API key in Spron. Once connected, you can send ready articles and saved images, publish public posts, keep drafts in Ghost, and update the same post later.
How Ghost publishing works
Spron sends ready articles to your Ghost blog through a custom integration. A new article first gets a Ghost post, then Spron adds its title, address, content, metadata, and saved images.
When you update an article, edit it in Spron and press Republish. Spron updates the same Ghost post, and edits made directly in Ghost are overwritten.
Draft mode leaves a new post as a draft. If the Ghost post is already live, sending it in draft mode does not return it to draft status. Published articles use public visibility, and Spron does not send newsletters.
- Titles, headings, links, lists, tables, and code are included.
- Article images are uploaded and saved in Ghost.
- Spron keeps the same Ghost post when it has the saved post ID.
Before you connect Ghost
You need a Ghost site with custom integrations, its Admin API details, and owner or admin access in Spron. Members can view the integration page, but they cannot connect or manage Ghost.
Your API URL must use public HTTPS. Spron does not accept an IP address, embedded username or password, custom port, query string, fragment, or a localhost, local, or internal hostname.
See the official Ghost Admin API documentation for background on Ghost integrations.
- Your Ghost site address
- A Ghost Admin API key, not the Content key
- Owner or admin access in Spron
Connect Ghost to Spron
Create an integration
In your Ghost admin, open
Settings → IntegrationsAdd custom integrationand name it.- Name:
Spron - Any integration name works.
- Name:
Copy the API URL
In the Ghost integration, copy the API URL. Paste it into the
Ghost API URLfield in Spron.Use the public HTTPS address supplied by Ghost. Spron checks the address before saving the connection.
Copy the Admin API key
Copy the Admin API key from the Ghost integration and paste it into
Ghost Admin API key. Do not use the Content key.Spron keeps the key on the server and uses short-lived signed requests when it communicates with Ghost.
Connect Ghost
Choose
Connect Ghost. Spron verifies the URL and key, saves the connection, and turns it on.Published articles are public. Newsletters are not sent. If the saved connection remains off, refresh the page and choose
Turn on Ghost.
What Spron sends to Ghost
Spron sends the article content and the fields Ghost needs to create or update its post. It removes an opening H1 from the article body because the article title becomes the Ghost post title.
The article title also becomes the meta title. Spron sends the meta description and uses up to 300 characters of it as Ghost’s custom excerpt.
Spron uploads the featured image and images used in the article, then replaces their source addresses with the Ghost image addresses. An article can reference up to 30 saved images.
- Title, article address, HTML content, meta title, and meta description
- Custom excerpt based on the meta description
- Featured image and images within the article
- PNG, JPEG, or WebP images that are each under 10 MB
Check your first Ghost post
Open Delivery history
A successful live post appears as Published. Other delivery labels include Waiting, Sending, Sent to Ghost, and Needs attention.
Open the article in Ghost and check its title, address, text, images, excerpt, and publication status. For a failed delivery on an active connection, an owner or admin can use the retry action shown in the history row.
Fix common Ghost connection issues
Why is Connect Ghost unavailable?
Both Ghost API URL and Ghost Admin API key must contain a value. The button remains unavailable while either field is empty or while Spron is connecting.
Why can’t Spron connect to Ghost?
Check that you entered your public Ghost HTTPS address and the Admin API key from the custom integration. A Content key, malformed key, unsupported address, or key that cannot read Ghost posts will not pass the connection check.
Why does an article show Needs attention?
Open the delivery details for the reported error. Proven content causes include a missing title, article address, or content, an image that is not saved with the article, more than 30 images, or an image that is not PNG, JPEG, or WebP under 10 MB.
What happens if the Ghost post was deleted?
On the next send, Spron checks whether the saved Ghost post still exists. If it does not, Spron looks for a post with the same article address and title. It updates that match or creates a new post when no match exists.
Need help connecting? Contact support, visit the Help Center, or see our other publishing integrations.