Publish a Shopify blog article
post_to_shopify_blogPublish, draft, or schedule articles on a Shopify store blog using a required title and text, converting light markdown to HTML and setting the first image as the featured cover.
Instructions
Use this when the user wants to publish, draft or schedule a BLOG ARTICLE on their Shopify store's blog. Publishing costs no credits. Works for an account created by installing Hermoso from the Shopify App Store (there is no Shopify tile to connect). A title is REQUIRED and the text becomes the body: plain text or light markdown (## headings, - lists, bold, links) becomes HTML, and HTML is sent as written. status: publish (default), draft, or scheduled with a future date, which Shopify schedules natively. The FIRST image becomes the featured image (Shopify copies it into the store); other images and a video go inside the body by their own links. A store with one blog needs no blog named; with several, pass blog (list_shopify_blogs); newBlogTitle creates a blog with the article. The reply is Shopify's own copy of the article, with its public address once published. An over-long tag is refused, never cut. A store that installed Hermoso before blog posts existed is asked to open the app once and approve the new permission. Shopify has no view counts on a blog article: never quote one.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"title": "<title>"
},
"name": "post_to_shopify_blog"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| blog | No | which blog: title, handle or id (not needed when the store has one) | |
| date | No | ISO time to publish at; a future date schedules it on Shopify itself | |
| hook | No | the post's angle — a list_hooks id or your own wording, reused exactly | |
| slug | No | the end of the article URL (its handle) | |
| tags | No | tags, by name | |
| text | No | the body: plain text, light markdown or HTML | |
| brand | No | WHICH PROFILE this post belongs to — id or exact name from list_brands (a shared workspace: its profile id). Beats the connection's pin for THIS CALL ONLY; a name that matches no profile, or two, is REFUSED and nothing is posted. | |
| title | Yes | REQUIRED: the article title | |
| author | No | the byline (default: the store name) | |
| ideaId | No | short id of the content-plan idea this post came from | |
| recipe | No | the post's FORMAT id, e.g. "slideshow" or "imessage_chat" — post_performance groups by it, so reuse one id per format | |
| status | No | default publish | |
| altText | No | alt text for the images | |
| excerpt | No | the summary shown in lists | |
| subject | No | what the post is about | |
| imageUrl | No | one image: becomes the cover (featured) image | |
| seoTitle | No | the search title | |
| videoUrl | No | one video, embedded in the body by its link | |
| imageUrls | No | several images: the first is the cover, the rest go inside the body | |
| newBlogTitle | No | create a new blog with this title and put the article in it | |
| allowDuplicate | No | post it even though an identical post was just made | |
| idempotencyKey | No | any stable string: a repeat within 24h returns the original post instead of posting again | |
| seoDescription | No | the search description |