Bots

Bot users are non-human senders. Create a bot once, then reference it as the sender when sending a direct message or when creating a direct_message incoming webhook. A bot appears in chat with its own name and avatar, making it clear the message came from an integration rather than a person.

Required scope: read:bots, write:bots

Endpoints

GET
/api/open/v1/bots

List bot users (paginated)

GET
/api/open/v1/bots/{id}

Get a single bot user

POST
/api/open/v1/bots

Create a bot user

PUT
/api/open/v1/bots/{id}

Update a bot user (name, avatar_url)

Create

curl -X POST https://customer.monotree.com/api/open/v1/bots \
  -H "Authorization: Bearer mono_your_token_here" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Notification Bot", "avatar_url": "https://example.com/bot.png" }'
FieldTypeNotes
namestringRequired. The bot's display name.
avatar_urlstringOptional. A public image URL. Defaults to the customer app icon.

Response

{
  "data": {
    "id": 873,
    "name": "Notification Bot",
    "avatar_url": "https://example.com/bot.png",
    "created_at": "2026-06-13T10:00:00+00:00"
  }
}