Integrations

Create integration

post/integrations

Request body

type'telegram' required
namestring required
eventTypesEventType[] required

Array of event types to subscribe to.

Example request

{
  "type": "telegram",
  "name": "My Telegram Bot",
  "config": {
    "chatId": "-1001234567890"
  },
  "eventTypes": [
    "tweet.new",
    "follower.gained"
  ]
}

Response

Integration created

idstring required
type'telegram' required
namestring required
configobject required

Integration config — shape varies by type (JSON)

eventTypesEventType[] required

Array of event types to subscribe to.

isActiveboolean required
silentPushboolean
scopeAllMonitorsboolean
messageTemplatestring
filtersobject

Event filter rules (JSON)

createdAtstring date-time required

Example response

{
  "id": "42",
  "type": "telegram",
  "name": "My Telegram Bot",
  "config": {
    "chatId": "-1001234567890"
  },
  "eventTypes": [
    "tweet.new",
    "follower.gained"
  ],
  "isActive": true,
  "scopeAllMonitors": true,
  "messageTemplate": "New event: {{event.type}}",
  "filters": {
    "minFollowers": 100
  },
  "createdAt": "2025-01-15T12:00:00Z"
}

Changes