---
title: "Action api__callnode"
description: "Calls a node (connector) in another bot via the internal API."
---

# Action `api__callnode`

> **System ID:** `action_api__callnode`

## Description

Starts execution of the specified node in **another** bot. Passes chat context (`chat_id`, `channel`) and arbitrary data. All values in `chat_id`, `channel`, and in the `data` object support placeholders.

## Events (scenario branches)

| Event | When it occurs |
|-------|----------------|
| **ok** | Request succeeded; the target node returned success status |
| **not_ok** | Required parameters missing, request failed, or the target node returned an error |

## Parameters

| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| `bot_id` | string | yes | — | Target bot ID |
| `connector_alias` | string | yes | — | Node (connector) alias in the target bot |
| `chat_id` | string | yes | — | Chat ID for execution context (placeholders) |
| `channel` | string | yes | — | Channel for execution context (placeholders) |
| `data` | object | yes | `{}` | Data for the target node; values support placeholders |

## Configuration example

```json
{
  "bot_id": "12345",
  "connector_alias": "welcome_message",
  "chat_id": "{{chat_id}}",
  "channel": "{{channel}}",
  "data": {
    "order_id": "{{order_id}}",
    "user_name": "{{user_name}}"
  }
}
```

## Related docs

- [Actions reference](/en/actionjail/reference/actions-reference.md)