WordPress
Articles post straight into your existing blog. Nothing to install.
- In WordPress, go to Users → Profile → Application Passwords.
- Create one called Helio SEO and copy the generated password.
- In your Helio account, open Settings, choose WordPress, and paste your site
address, WordPress username and that password.
- Hit Test the connection. It signs in as you and confirms by name.
Shopify
Articles post to your store's blog, so your shop ranks for buyer searches.
- In Shopify admin, go to Settings → Apps and sales channels → Develop apps
and create an app called Helio SEO.
- Under API scopes, enable write_content, install the app, and copy the
Admin API access token.
- In Helio's Settings, choose Shopify, paste your shop domain and the token, and save.
- Hit Test the connection: it lists your blogs with their IDs. Save the one
you want and test again.
Webflow
Articles publish as live items in your Blog Posts collection, in your own design.
- In Site settings → Apps & integrations, generate an API token with
CMS read and write access.
- Open your Blog Posts collection's settings and copy its Collection ID.
- In Helio's Settings, choose Webflow and paste both, plus your blog's public
address so we can link to live articles.
- Hit Test the connection. It checks the collection has a rich-text body field
(default slug post-body; change it in Settings if yours differs).
Ghost
Articles publish straight to your Ghost publication.
- In Ghost admin, go to Settings → Integrations and add a custom
integration called Helio SEO.
- Copy the Admin API key.
- In Helio's Settings, choose Ghost, paste your site address and the key.
- Hit Test the connection. It confirms your site by name.

Wix, Squarespace, and any other site
No API needed. One embed line puts your articles on any site that accepts
an embed or HTML block, styled to match your site's own fonts.
- Create a blog or news page on your site.
- Add an embed / HTML block to it (Wix: Add → Embed code → Embed HTML;
Squarespace: a Code block).
- Paste your two lines, shown in your Helio account under Settings → Any other
site. They look like this:
<div id="helio-seo-blog"></div>
<script src="https://helioseo.io/embed/your-business.js" async></script>
- Done. Approved articles appear on that page automatically, each linking to its full
article page carrying your business name.
Built your site with AI?
If your site came from Lovable, Bolt, v0, Cursor, Claude, or any coding
agent, you do not need to touch code. Copy this to your agent and it does the work.
The simple version (five minutes, no backend):
Add a blog page to my site at /blog titled "News & advice".
On that page, place this embed exactly as written:
<div id="helio-seo-blog"></div>
<script src="https://helioseo.io/embed/YOUR-BUSINESS.js" async></script>
The widget inherits my site's fonts and colours. Add the page to my
site navigation. Do not modify the script tag.
The native version (articles become real pages
on your own domain, best for search):
Build a webhook receiver and blog for my site:
1. Add POST /api/helio-seo. Verify the X-HelioSEO-Signature header:
it is the hex HMAC-SHA256 of the raw request body, using the
shared secret HELIO_SEO_SECRET from my environment variables.
Reject bad signatures with 401.
2. The payload is JSON:
{"event":"article.published","customer":"...","article":{
"slug","title","meta_description","primary_keyword",
"body_html","published_at"}}
On "article.published", store the article. Return 200.
3. Render stored articles at /blog/{slug} using my site's layout,
with the title as h1, meta_description as the meta description
tag, and body_html as the article body.
4. Add a /blog index page listing articles newest first, and add
it to my navigation.
- Give your agent one of the two prompts above (swap in your exact embed line from
Settings, or your chosen secret).
- For the native version, paste the same webhook address and secret into Helio's
Settings → Developer webhook and hit Test the connection: your new
endpoint gets a signed test event.
Developers: the webhook, in full
One signed POST per approved article. Verify, store, render, return 2xx.
POST your-endpoint
Content-Type: application/json
X-HelioSEO-Signature: hex(HMAC-SHA256(raw_body, shared_secret))
{
"event": "article.published",
"customer": "your-slug",
"article": {
"slug": "choosing-a-boiler-service-plan",
"title": "Choosing a boiler service plan that actually covers you",
"meta_description": "...",
"primary_keyword": "...",
"body_html": "<p>...</p>",
"published_at": "2026-08-11T09:05:00+00:00"
}
}
- The Test the connection button sends the same shape with
"event": "test", so you can verify your signature check end to end.
- Your response may include {"url": "https://..."} and Helio records it as
the article's live address.