Bots

Create a bot

Creates the bot, its draft, its test copy and — for a landbot bot — a web channel.

Without diagram the draft holds a start point and nothing else. With one, the bot can be talked to straight away; a diagram that breaks a rule is refused and nothing is created.

source duplicates a bot. Not built yet: 501.

post/bots

Request

  • Base URL: https://api.landbot.io/v0-alpha
  • URL: https://api.landbot.io/v0-alpha/bots
  • Auth: one of:
    • API key in header Authorization
    • API key in cookie sessionid
    • HTTP bearer

Request body

namestring required
channel_family'landbot' | 'whatsapp' | 'facebook' | 'apichat' required
workspaceinteger

The workspace to file the bot under. A workspace that does not exist, or belongs to another brand, is rejected with 422.

Example request

{
  "name": "Support bot",
  "channel_family": "landbot"
}

Response

The created bot

Example response

{
  "data": {
    "created_at": "2026-09-16T09:18:19",
    "edited_at": "2026-09-16T09:18:19",
    "last_published_at": "2026-09-16T09:18:19"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.