inbound. page. publish
Publish landing pages, articles, or changelogs on a Heelo-hosted site. Link to them from social posts and outreach emails.
25 credits. Per page published.
Example prompt
Send this to your AI app when Heelo is connected:
Publish a landing page titled 'Early access' at slug 'early-access'
Input fields
| Field | Type | Description |
|---|---|---|
slugRequired | string | URL slug, e.g. 'why-nobody-uses-your-app' |
titleRequired | string | Page title |
site_id | string | Hosted site id. Pass the site_id returned by an earlier publish to put the page in the same site; a new site is created if omitted |
kind | string | landing | article | changelog |
body_md | string | Page body in Markdown |
og_image_asset_id | string | Asset id from media.render |
og_image_url | string | Explicit og:image URL (overrides asset id) |
capture | object | {enabled, fields, cta} |
seo | object | {description, canonical, jsonld} |
Output fields
The fields in data when status is success.
| Field | Type | Description |
|---|---|---|
url | string | |
published_at | string | |
site_id | string | |
canonical_url | string | The canonical URL the page declares (a CMS post: its permalink) |
og_image_url | string | The og:image the hosted page declares |
kind | string | landing | article | changelog |
capture | object | The page's email form: {enabled, action (POST URL), cta}; on a CMS page whose form is not on the post (or not confirmed), enabled is false and `error` says why |
answer | string |
Code
The call with the input fields that the tool needs. Replace each word in capitals, such as SLUG. Set HEELO_API_KEY to your API key.
import os
import requests
response = requests.post(
"https://toolsprimitives.uk/v1/tools/inbound.page.publish/invoke",
headers={"Authorization": f"Bearer {os.environ['HEELO_API_KEY']}"},
json={"input": {
"slug": "SLUG",
"title": "TITLE",
}},
timeout=120,
)
response.raise_for_status()
print(response.json())// Node.js 18 or newer, in an ES module.
const response = await fetch("https://toolsprimitives.uk/v1/tools/inbound.page.publish/invoke", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.HEELO_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
input: {
"slug": "SLUG",
"title": "TITLE"
},
}),
signal: AbortSignal.timeout(120_000),
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
console.log(await response.json());