Skip to main content
5 minIntegrationBeta
Slack

Slack

Install the ABM.dev Slack app in your workspace. One-click OAuth provisions a bot token so you can post enrichment notifications, approvals, and webhooks into any channel.

What the app does today

  • Slack OAuth 2 install flow with secure state parameter
  • Bot token scoped to chat:write, commands, and incoming-webhook
  • One workspace per org, stored encrypted at rest
  • Installations list + disconnect from your dashboard

Still in beta

Slash commands, App Home, and Block Kit approval flows are on the roadmap — not shipped yet. This guide only documents the OAuth install and the REST endpoints that are live today.
1

Install the app

Kick off the Slack OAuth flow by hitting /api/v1/slack/install. You'll be redirected to Slack to pick a workspace and authorise the ABM.dev app.

Add ABM.dev to Slack

After approval Slack sends you back to /settings/integrations?slack=success and the bot token is stored (encrypted) against your organisation.

2

List installations

Confirm the install landed by calling the installations endpoint. Tokens are never returned — you'll see the team, bot user, and install timestamp.

List connected workspaces
curl -s https://api.abm.dev/v1/slack/installations \
  -H "x-api-key: YOUR_API_KEY" | jq .
3

Disconnect a workspace

Revoke the installation by DELETE-ing the team from the same endpoint. This removes the stored bot token.

Remove an installation
curl -X DELETE \
  https://api.abm.dev/v1/slack/installations/TEAM_ID \
  -H "x-api-key: YOUR_API_KEY"

Token rotation

If a Slack workspace rotates its signing secret or a team admin revokes the app from the Slack side, re-run the install flow from step 1 — the old token will start returning 401s.

Self-hosting configuration

If you're running your own ABM.dev deployment, set these app settings so the OAuth flow can complete:

SettingDescription
Slack:ClientIdOAuth client ID from your Slack app config.
Slack:ClientSecretOAuth client secret from your Slack app.
Slack:RedirectBaseUrlPublic URL of your API (e.g. https://api.abm.dev). The callback path /api/v1/slack/oauth/callback is appended automatically.

Next steps