Create blog post
Tool ID: kocodesk_blog_post_create
Summary
Create a new blog post with its title, slug, teaser, lead image, publish date, categories and social meta.
When to use it
- When publishing a new article.
- When drafting a post you want to schedule for later.
What you need
| Requirement | Required? |
|---|---|
| Metraclick connection | Yes |
| Tool enabled for your account | Yes |
| KocoDesk credentials | Yes |
| Blog plugin enabled for the site | Yes |
Parameters
| Parameter | Required? | Description |
|---|---|---|
title |
Yes | The post title. |
confirm |
Yes | Must be true; nothing is created without it. |
slug |
No | URL part. Made from the title if you leave it out. |
teaser |
No | Short summary shown on the blog index. |
featured_image |
No | Id of an image already in your site's media library. |
published_at |
No | Publish date and time. Leave out to publish immediately. |
featured |
No | Mark the post as featured. |
hidden |
No | Keep the post off the public site. |
sorting |
No | Sort order. |
categories |
No | Category ids from List categories. |
meta |
No | Social sharing title, description and image for Facebook/Open Graph and Twitter. |
What you get back
The created post, including the id you'll use to add the article body.
Example prompts
Create a blog post called "Our new studio opens in May" with a short teaser, and ask me to confirm first.
Draft a hidden blog post about the autumn collection so I can review it before publishing.
Schedule a blog post about the summer sale to go live on 1 June at 9am. Confirm with me first.
Tips
- Mutating — you must confirm.
- This creates the post's metadata only. Add the article text with Create blog post content.
- Posts are always created in your primary language. Use Translate blog post for other languages.
- Leaving the publish date empty makes the post live straight away — set
hiddenif you want to review it first.