# Landbot

Landbot is a no-code chatbot builder that enables businesses to create conversational experiences for customer engagement, lead generation, and support across various messaging channels.

- **Category:** ai chatbots
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 13
- **Triggers:** 0
- **Slug:** `LANDBOT`
- **Version:** 20260312_00

## Tools

### Delete Bot

**Slug:** `LANDBOT_DELETE_BOT`

Tool to delete a specific bot from your account. Use when you need to remove an unused or test bot after confirming the bot ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `bot_id` | string | Yes | Unique identifier of the bot to delete. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Brand

**Slug:** `LANDBOT_GET_BRAND`

Tool to retrieve your brand data including contact information and settings. Use when you need to access brand profile details, configuration, or contact information.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Agents

**Slug:** `LANDBOT_LIST_AGENTS`

Tool to retrieve a list of agents in your Landbot account. Use after authenticating your account to enumerate all agents and their details.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Bots

**Slug:** `LANDBOT_LIST_BOTS`

Tool to list all bots in your Landbot account. Use after authenticating to discover your configured bots.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Channels

**Slug:** `LANDBOT_LIST_CHANNELS`

Tool to list all channels integrated with your account. Use after authenticating your account to enumerate available messaging channels and metadata.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Customers

**Slug:** `LANDBOT_LIST_CUSTOMERS`

Tool to list customers who have interacted with your bot. Use when you need to retrieve customer records with optional filters (channel_id, opt_in, search) and pagination.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum number of records to return per request. |
| `offset` | integer | No | Number of records to skip before returning results. |
| `opt_in` | boolean | No | Filter only customers who have opted in (e.g., WhatsApp opt-in). |
| `search` | string | No | Value to search for in the specified field. |
| `search_by` | string ("phone" | "email" | "name") | No | Field to search by. Must be one of 'phone', 'email', or 'name'. |
| `channel_id` | integer | No | Filter by specific channel ID through which customers interact. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List WhatsApp Templates

**Slug:** `LANDBOT_LIST_WHATSAPP_TEMPLATES`

Tool to list all WhatsApp message templates available for the account. Use after obtaining your WhatsApp channel ID to fetch template IDs and parameter counts.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `channel_id` | integer | No | Optional WhatsApp channel ID to filter templates and avoid duplicates |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Replace Agent

**Slug:** `LANDBOT_REPLACE_AGENT`

Tool to replace all data for a specific agent (full update). Use when you need to update agent information like name or password.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `agent_id` | string | Yes | The unique identifier of the agent to replace. |
| `password` | string | No | New password for the agent. Must be provided with password_confirmation if changing password. |
| `last_name` | string | Yes | Agent last name. |
| `first_name` | string | Yes | Agent first name. |
| `password_confirmation` | string | No | Password confirmation. Required when changing password. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Replace Brand

**Slug:** `LANDBOT_REPLACE_BRAND`

Tool to replace or update brand data with a full update (PUT operation). Use when you need to change company branding information in your Landbot account.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `city` | string | No | Brand city name. |
| `name` | string | Yes | Brand name. This is the only required field for updating brand information. |
| `phone` | string | No | Brand phone number. Include country code for international numbers. |
| `address` | string | No | Brand physical address or street address. |
| `country` | string | No | Brand country. Use ISO 3166-1 alpha-2 country codes (e.g., 'US', 'GB', 'ES'). |
| `zipcode` | string | No | Brand ZIP or postal code. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Send Message

**Slug:** `LANDBOT_SEND_MESSAGE`

Tool to send a plain text outbound message to a Landbot customer. Use when you need to reply to or continue a support chat with a known customer_id.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `message` | string | Yes | Plain text message to send to the customer. |
| `customer_id` | integer | Yes | Unique identifier of the customer to send the message to. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Set Agent Status

**Slug:** `LANDBOT_SET_AGENT_STATUS`

Tool to change your agent status to online, offline, or busy. Use when you need to update your availability status in Landbot.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `status` | string ("online" | "busy" | "offline") | Yes | New status for the agent. Must be one of: online, busy, or offline. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Agent

**Slug:** `LANDBOT_UPDATE_AGENT`

Tool to update an agent's information in your Landbot account. Use when you need to modify agent details such as name, email, or password. This performs a partial update.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | No | Agent's email address. |
| `agent_id` | string | Yes | Unique identifier of the agent to update. |
| `password` | string | No | New password for the agent. |
| `last_name` | string | No | Agent's last name. |
| `first_name` | string | No | Agent's first name. |
| `password_confirmation` | string | No | Password confirmation, required if password is provided. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Brand

**Slug:** `LANDBOT_UPDATE_BRAND`

Tool to partially update your brand data in Landbot. Use when you need to modify brand information such as name, phone, address, city, zipcode, or country.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `city` | string | No | Brand city to update. |
| `name` | string | No | Brand name to update. |
| `phone` | string | No | Brand phone number to update. |
| `address` | string | No | Brand address to update. |
| `country` | string | No | Brand country to update. |
| `zipcode` | string | No | Brand zipcode to update. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |