Skip to main content
GET
/
v1
/
channels
Listar canales activos de la company.
curl --request GET \
  --url https://api.keebai.com/v1/channels \
  --header 'Authorization: Bearer <token>'
{}
Returns the connected channels for the company tied to the PAT. Handy for discovering which channel to use when sending messages or registering webhooks. 
GET /v1/channels
GET /v1/channels?type=whatsapp
Required scope: channels:read

​
Query params

ParamTypeDescription
typeoptional enumFilter by type. Values: whatsapp, whatsapp_qr, instagram, messenger, tiktok, web, playground.

​
Request

curl 'https://api.keebai.com/v1/channels?type=whatsapp' \
  -H "Authorization: Bearer kbai_pk_xxx"

​
Response 200

{
  "data": [
    {
      "id": "ch_01HXYZ...",
      "name": "Soporte Chile",
      "type": "whatsapp",
      "is_active": true,
      "phone_number": "+56987654321",
      "phone_number_id": "1234567890",
      "business_account_id": "9876543210",
      "created_at": "2026-04-15T10:00:00Z"
    }
  ]
}
FieldTypeDescription
idstringChannel ID. Use it in POST /v1/messages (channel_id) and when filtering webhook deliveries.
namestringChannel display name.
typeenumChannel type.
is_activebooleanfalse only for channels that are paused or have credential issues.
phone_number / phone_number_id / business_account_idstringOnly for type: whatsapp.

​
Fetch a channel by id

GET /v1/channels/:id — same shape as a list item, no filters. 
curl https://api.keebai.com/v1/channels/ch_01HXYZ \
  -H "Authorization: Bearer kbai_pk_xxx"
If the id doesn’t exist or belongs to another company, it returns 404 CHANNEL_NOT_FOUND.

Authorizations

​
Authorization
string
header
required

Personal Access Token con prefijo kbai_pk_. Generar desde el portal con permiso developer.manage_tokens.

Query Parameters

​
type
string
required

Response

200 - application/json

The response is of type object.