---
title: "Start Typebot"
method: POST
path: "/typebot/start/{instance}"
tags: ["Typebot Controller"]
---

# Start Typebot

`POST /typebot/start/{instance}`

## Request

- Base URL: `https://evolution-example`
- URL: `https://evolution-example/typebot/start/{instance}`
- Auth: API key in header `apikey`

Start typebot

## Path parameters

- `instance` string, required

## Request body

- object
  - `url` string: Typebot URL
  - `typebot` string: Typebot name
  - `remoteJid` string: Receiver remote JID
  - `startSession` boolean: Start a new session
  - `variables` object[]
    - `name` string: Variable name
    - `value` string: Variable value

## Response `200`

Ok

## Changes

- **2024-11-25** (v2) `c153448703e5`: 1 breaking, 9 info
  - removed the media type `application/json` for the response with the status `200`
  - api operation id `startTypebot` was added
  - the endpoint scheme security `ApiKeyAuth` was added to the API
  - api tag `Typebot Controller` added
  - …6 more
- **2024-09-09** (v2) `0c4620ca5ed5`: 5 warning, 5 info
  - removed the request property `remoteJid`
  - removed the request property `startSession`
  - removed the request property `typebot`
  - removed the request property `url`
  - …6 more

[Operation history](https://skmtc.dev/evolution-foundation/apis/evolution-api-3/changes/typebot/start/:instance/post.md)

---

[API](https://skmtc.dev/evolution-foundation/apis/evolution-api-3.md) - [All operations](https://skmtc.dev/evolution-foundation/apis/evolution-api-3/llms.txt) - [OpenAPI document](https://skmtc.dev/evolution-foundation/apis/evolution-api-3/revisions/153363ee7f38?raw)