Integrations API

Connect your REPLRs to Discord, Telegram, and Slack.

GET/v1/integrationsAuth Required

List all integrations for the current user.

Response

{
  "data": [
    {
      "id": "int_d8f2a1b3c4e5",
      "platform": "discord",
      "replr_id": "rp_7k9m2x4v",
      "status": "active",
      "guild_id": "1098765432100001234",
      "channel_ids": [
        "1098765432100005678",
        "1098765432100009012"
      ],
      "message_count": 4821,
      "connected_at": "2026-02-14T09:30:00Z"
    },
    {
      "id": "int_a1b2c3d4e5f6",
      "platform": "telegram",
      "replr_id": "rp_3n8w5q1t",
      "status": "active",
      "message_count": 1537,
      "connected_at": "2026-02-20T14:12:00Z"
    },
    {
      "id": "int_f6e5d4c3b2a1",
      "platform": "slack",
      "replr_id": "rp_6j4p8r2y",
      "status": "inactive",
      "workspace_id": "T04ABCDEF",
      "channel_ids": [
        "C04GHIJKL"
      ],
      "message_count": 0,
      "connected_at": "2026-03-01T11:45:00Z"
    }
  ],
  "total": 3
}

POST/v1/integrations/discordAuth Required

Connect a Discord bot to a REPLR.

Request Body

Name	Type	Required	Description
`replr_id`	string	Required	ID of the REPLR to connect.
`bot_token`	string	Required	Discord bot token from the Developer Portal.
`guild_id`	string	Required	Discord server (guild) ID.
`channel_ids`	string[]	Required	Channel IDs the bot should listen in.

Response

{
  "id": "int_d8f2a1b3c4e5",
  "platform": "discord",
  "replr_id": "rp_7k9m2x4v",
  "status": "active",
  "guild_id": "1098765432100001234",
  "channel_ids": [
    "1098765432100005678",
    "1098765432100009012"
  ],
  "message_count": 0,
  "connected_at": "2026-03-09T18:22:00Z"
}

POST/v1/integrations/telegramAuth Required

Connect a Telegram bot to a REPLR.

Request Body

Name	Type	Required	Description
`replr_id`	string	Required	ID of the REPLR to connect.
`bot_token`	string	Required	Telegram bot token from @BotFather.

Response

{
  "id": "int_a1b2c3d4e5f6",
  "platform": "telegram",
  "replr_id": "rp_3n8w5q1t",
  "status": "active",
  "message_count": 0,
  "connected_at": "2026-03-09T18:25:00Z"
}

POST/v1/integrations/slackAuth Required

Connect a Slack bot to a REPLR.

Request Body

Name	Type	Required	Description
`replr_id`	string	Required	ID of the REPLR to connect.
`bot_token`	string	Required	Slack bot OAuth token (xoxb-...).
`workspace_id`	string	Required	Slack workspace ID.
`channel_ids`	string[]	Required	Slack channel IDs the bot should monitor.

Response

{
  "id": "int_c3d4e5f6a1b2",
  "platform": "slack",
  "replr_id": "rp_6j4p8r2y",
  "status": "active",
  "workspace_id": "T04ABCDEF",
  "channel_ids": [
    "C04GHIJKL",
    "C04MNOPQR"
  ],
  "message_count": 0,
  "connected_at": "2026-03-09T18:30:00Z"
}

GET/v1/integrations/:idAuth Required

Get details for a specific integration.

Path Parameters

Name	Type	Required	Description
`id`	string	Required	The unique identifier of the integration.

Response

{
  "id": "int_d8f2a1b3c4e5",
  "platform": "discord",
  "replr_id": "rp_7k9m2x4v",
  "status": "active",
  "guild_id": "1098765432100001234",
  "channel_ids": [
    "1098765432100005678",
    "1098765432100009012"
  ],
  "auto_respond": true,
  "message_count": 4821,
  "connected_at": "2026-02-14T09:30:00Z",
  "last_message_at": "2026-03-09T17:58:12Z"
}

PUT/v1/integrations/:idAuth Required

Update settings for an existing integration.

Path Parameters

Name	Type	Required	Description
`id`	string	Required	The unique identifier of the integration.

Request Body

Name	Type	Required	Description
`channel_ids`	string[]	Optional	Updated list of channel IDs to listen in.
`active`	boolean	Optional	Enable or disable the integration.
`auto_respond`	boolean	Optional	Automatically reply to every message when true.

Response

{
  "id": "int_d8f2a1b3c4e5",
  "platform": "discord",
  "replr_id": "rp_7k9m2x4v",
  "status": "active",
  "guild_id": "1098765432100001234",
  "channel_ids": [
    "1098765432100005678",
    "1098765432100009012",
    "1098765432100003456"
  ],
  "auto_respond": false,
  "message_count": 4821,
  "connected_at": "2026-02-14T09:30:00Z",
  "last_message_at": "2026-03-09T17:58:12Z"
}

DELETE/v1/integrations/:idAuth Required

Disconnect and remove an integration.

Path Parameters

Name	Type	Required	Description
`id`	string	Required	The unique identifier of the integration.

Response

{
  "id": "int_d8f2a1b3c4e5",
  "deleted": true
}

POST/v1/integrations/:id/testAuth Required

Send a test message to verify the integration connection.

Path Parameters

Name	Type	Required	Description
`id`	string	Required	The unique identifier of the integration.

Response

{
  "id": "int_d8f2a1b3c4e5",
  "platform": "discord",
  "status": "active",
  "test_result": {
    "success": true,
    "latency_ms": 142,
    "message_id": "1098765432100099887",
    "delivered_at": "2026-03-09T18:35:01Z"
  }
}

{ "data": [ { "id": "int_d8f2a1b3c4e5", "platform": "discord", "replr_id": "rp_7k9m2x4v", "status": "active", "guild_id": "1098765432100001234", "channel_ids": [ "1098765432100005678", "1098765432100009012" ], "message_count": 4821, "connected_at": "2026-02-14T09:30:00Z" }, { "id": "int_a1b2c3d4e5f6", "platform": "telegram", "replr_id": "rp_3n8w5q1t", "status": "active", "message_count": 1537, "connected_at": "2026-02-20T14:12:00Z" }, { "id": "int_f6e5d4c3b2a1", "platform": "slack", "replr_id": "rp_6j4p8r2y", "status": "inactive", "workspace_id": "T04ABCDEF", "channel_ids": [ "C04GHIJKL" ], "message_count": 0, "connected_at": "2026-03-01T11:45:00Z" } ], "total": 3 }

Name

Type

Required

Description

replr_id

string

Required

ID of the REPLR to connect.

bot_token

string

Required

Discord bot token from the Developer Portal.

guild_id

string

Required

Discord server (guild) ID.

channel_ids

string[]

Required

Channel IDs the bot should listen in.

{ "id": "int_d8f2a1b3c4e5", "platform": "discord", "replr_id": "rp_7k9m2x4v", "status": "active", "guild_id": "1098765432100001234", "channel_ids": [ "1098765432100005678", "1098765432100009012" ], "message_count": 0, "connected_at": "2026-03-09T18:22:00Z" }

Name

Type

Required

Description

replr_id

string

Required

ID of the REPLR to connect.

bot_token

string

Required

Telegram bot token from @BotFather.

Name

Type

Required

Description

replr_id

string

Required

ID of the REPLR to connect.

bot_token

string

Required

Slack bot OAuth token (xoxb-...).

workspace_id

string

Required

Slack workspace ID.

channel_ids

string[]

Required

Slack channel IDs the bot should monitor.

{ "id": "int_c3d4e5f6a1b2", "platform": "slack", "replr_id": "rp_6j4p8r2y", "status": "active", "workspace_id": "T04ABCDEF", "channel_ids": [ "C04GHIJKL", "C04MNOPQR" ], "message_count": 0, "connected_at": "2026-03-09T18:30:00Z" }

Name

Type

Required

Description

id

string

Required

The unique identifier of the integration.

{ "id": "int_d8f2a1b3c4e5", "platform": "discord", "replr_id": "rp_7k9m2x4v", "status": "active", "guild_id": "1098765432100001234", "channel_ids": [ "1098765432100005678", "1098765432100009012" ], "auto_respond": true, "message_count": 4821, "connected_at": "2026-02-14T09:30:00Z", "last_message_at": "2026-03-09T17:58:12Z" }

Name

Type

Required

Description

id

string

Required

The unique identifier of the integration.

Name

Type

Required

Description

channel_ids

string[]

Optional

Updated list of channel IDs to listen in.

active

boolean

Optional

Enable or disable the integration.

auto_respond

boolean

Optional

Automatically reply to every message when true.

{ "id": "int_d8f2a1b3c4e5", "platform": "discord", "replr_id": "rp_7k9m2x4v", "status": "active", "guild_id": "1098765432100001234", "channel_ids": [ "1098765432100005678", "1098765432100009012", "1098765432100003456" ], "auto_respond": false, "message_count": 4821, "connected_at": "2026-02-14T09:30:00Z", "last_message_at": "2026-03-09T17:58:12Z" }

Name

Type

Required

Description

id

string

Required

The unique identifier of the integration.

Name

Type

Required

Description

id

string

Required

The unique identifier of the integration.

{ "id": "int_d8f2a1b3c4e5", "platform": "discord", "status": "active", "test_result": { "success": true, "latency_ms": 142, "message_id": "1098765432100099887", "delivered_at": "2026-03-09T18:35:01Z" } }