Write captions
klynx_write_captionsUse this when the user wants social media captions written from a short text description and does not need a photo enhanced, for example to post with a photo they already have. Needs subject (text, up to 200 characters); platforms (any of instagram, facebook, tiktok, linkedin; default all four), tone and length are optional. Business name, type, location and English spelling come from the connected Klynx account, so do not ask the user for them. No photo is used, so no alt text is returned. Returns one caption per platform, each with up to five hashtags, plus post ids and the posts remaining in the plan allowance. Uses one post per platform from the account's plan allowance, as the Klynx web app would; a job the allowance does not cover is refused with plan_allowance_exhausted before any work and nothing is charged. On the free plan, captions paid from the plan allowance end with a short Made with klynx.ai line. A job that fails uses nothing from the allowance. It only creates drafts in the Klynx account: it does not publish, schedule or post anything. A caption-only draft needs a photo applied in the Klynx web app before it can be published.
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": {
"subject": "<subject>"
},
"name": "klynx_write_captions"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tone | No | Optional. Caption tone: Friendly, Professional, Casual, Enthusiastic, Informative or Humorous. Defaults to Casual. | |
| length | No | Optional. Caption length for every platform: short, medium or long. By default Instagram, Facebook, TikTok and LinkedIn are medium. | |
| subject | Yes | Short description of what the post is about (up to 200 characters are used). | |
| platforms | No | Platforms to write for. Any of instagram, facebook, tiktok, linkedin. Defaults to all four. | |
| idempotency_key | No | Optional key that makes a retry safe: a key already used is never charged or run twice. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| captions | Yes | ||
| post_ids | Yes | The saved posts in the Klynx account, in caption order. | |
| published | Yes | Always false: this tool only creates drafts and never publishes, schedules or posts anything. To post a Facebook or Instagram draft, use klynx_preview_publish, then klynx_publish_now or klynx_schedule_post once the user approves. | |
| operation_id | Yes | ||
| posts_remaining | Yes | Posts left in the plan allowance after this job, or null when there is no limit. |