Channels

A channel account is a connected messaging provider (e.g. your WhatsApp number, a Telegram bot) linked to your Notifo tenant.

Manage accounts

List all connected accounts

GET /v1/channels/accounts
Authorization: Bearer eyJ...

Delete an account

DELETE /v1/channels/accounts/:id
Authorization: Bearer eyJ...

Response: 204 No Content.

Get account status

GET /v1/channels/accounts/:id/status
Authorization: Bearer eyJ...

{
  "id": "acc_01j...",
  "status": "connected",
  "connectedAt": "2025-01-01T10:00:00.000Z"
}

Send a test message

POST /v1/channels/accounts/:id/test
Authorization: Bearer eyJ...
Content-Type: application/json

{
  "to": "+905551234567",
  "text": "Test message from Notifo"
}

Account statuses

Status	Meaning
pending	Session initiated, QR not yet scanned
connected	Active and ready to send
disconnected	Session expired or logged out
error	Persistent error — reconnect required