Documentation

Connect your first project

Create a project from the owner Telegram chat, issue an environment credential, and send signed events to the ingestion endpoint.

Full event ingestion guide

See every standard event, request format, credential, limit, and retry behavior.

Read the complete guide

1. Create a project

In your private owner chat, use /new my-project My Project. The management API can also create projects with an idempotency key.

2. Issue a credential

Use the management API to issue a staging or production environment key. Store the token in your project secret manager and show it only once.

3. Send an event

POST /v1/events
Authorization: Bearer gm_project_...
Content-Type: application/json

{"id":"order-123","type":"order.paid","severity":"success","data":{"summary":"Order paid"}}

4. Connect Telegram delivery

Send /start in the private bot chat. For a project group or channel, use the verified /connect flow from the owner chat.