API referenceBlog Post

Create Blog Post

Write a website article (a blog post visitors can read). Call this in the same turn they ask you to write, draft, or publish an article. Do not paste the article in chat and ask whether to publish. It is visible unless hiddenFromBrowse is true. Content may be simple HTML or plain paragraphs. Do not send markdown. Do not invent imageID. Returns id and editorPath. App connections need the booking:write or inventory:write scope.

POST

/api/v1/blog-post

POST

/blog-post

curl -X POST "https://dash.lockii.app/api/v1/blog-post" \
  -H "x-api-key: $LOCKII_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "title": "string"
}'

Authorization

x-api-key
string
header
API key from Settings → Integrations → API.
Authorization
string
header
The same API key, or an OAuth access token, sent as Authorization: Bearer.
api_key
string
query
API key query parameter.

Body

application/json

authorName
string
Author name shown on the article. Omit to leave it blank.
content
string
Article body. Simple HTML the editor keeps (p, h2, h3, ul, ol, li, a, strong, em, blockquote) or plain paragraphs separated by a blank line. Do not send markdown. Do not invent an image id inside the HTML.
excerpt
string
Short summary for cards and search, as plain text. Aim for 140–160 characters when you write one.
hiddenFromBrowse
boolean
True hides the post from the website. False or omitted keeps it visible.
imageID
string
Existing cover image id. Omit when you do not have one. Do not invent an id.
siteTemplatePageID
string
Blog template page id. Omit to use the company's default blog template.
slug
string
Public URL segment. Omit to generate one from the title.
tags
string[]
Topic tags. On update, this replaces the whole list.
title
string
required
Post title

Response

application/json

JSON result for this operation.

object

{}

- Introduction
- User MCP
- Customer MCP
- Booking API
- Building a Lockii App
- Login with Lockii
- Building a Marketplace App

Create Blog Post - Lockii Help Center | Productlane

API referenceBlog Post

Create Blog Post

POST

/api/v1/blog-post

POST

/blog-post

curl -X POST "https://dash.lockii.app/api/v1/blog-post" \
  -H "x-api-key: $LOCKII_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "title": "string"
}'

Authorization

x-api-key
string
header
API key from Settings → Integrations → API.
Authorization
string
header
The same API key, or an OAuth access token, sent as Authorization: Bearer.
api_key
string
query
API key query parameter.

Body

application/json

authorName
string
Author name shown on the article. Omit to leave it blank.
content
string
Article body. Simple HTML the editor keeps (p, h2, h3, ul, ol, li, a, strong, em, blockquote) or plain paragraphs separated by a blank line. Do not send markdown. Do not invent an image id inside the HTML.
excerpt
string
Short summary for cards and search, as plain text. Aim for 140–160 characters when you write one.
hiddenFromBrowse
boolean
True hides the post from the website. False or omitted keeps it visible.
imageID
string
Existing cover image id. Omit when you do not have one. Do not invent an id.
siteTemplatePageID
string
Blog template page id. Omit to use the company's default blog template.
slug
string
Public URL segment. Omit to generate one from the title.
tags
string[]
Topic tags. On update, this replaces the whole list.
title
string
required
Post title

Response

application/json

JSON result for this operation.

object

{}