Skip to content

Test channel connectivity

POST
/api/channels/{channelId}/test

Verify that the channel can send and receive messages. For email channels this sends a test message; for WhatsApp and voice channels this validates the API credentials against the provider.

channelId
required
string format: uuid

The unique identifier of the channel to test.

The test completed. Check the ‘ok’ field for the result.

Simple success acknowledgment returned by action endpoints (reply, resolve, take-over, etc.).

object
ok
required

Always true on success.

boolean
Example
true

No channel exists with the given ID in the authenticated tenant.

Standard error response returned by all endpoints on failure.

object
error
required

A human-readable error message describing what went wrong.

string
Example
Conversation not found