Skip to main content
POST
Register a Telegram group

Authorizations

Authorization
string
header
required

API key authentication. Pass your key as a Bearer token. Keys use the format hm_live_<32 hex chars>. Generate keys from your Harmonica dashboard settings.

Body

application/json
group_id
string
required

Telegram chat ID

group_name
string

Telegram group title

topic_id
integer

Forum topic ID (if group has topics enabled)

Response

Group registered (or updated)

A Telegram group registered to the user's account.

group_id
string
required

Telegram chat ID

created_at
string<date-time>
required
group_name
string | null

Telegram group title

topic_id
integer | null

Forum topic ID for bot announcements