Delivery · createSlackInstall

Connect Slack

POST /v1/slack/install

Slack's "Add to Slack" page (OAuth v2) with a one-time state, valid 10 minutes: approving it there connects the member's DM with the Logu app, where asks and events then arrive.

Who may call it: any signed-in human
Server: https://api.logu.dev

Example#

curl -s -X POST "https://api.logu.dev/v1/slack/install" \
  -H "Authorization: Bearer $LOGU_SESSION_TOKEN"

Responses#

201

The page to open and when its state expires.

{
  "url": "https://slack.com/oauth/v2/authorize?client_id=1234567890.1234567890&scope=chat%3Awrite%2Cim%3Awrite&redirect_uri=https%3A%2F%2Fapi.logu.dev%2Fslack%2Foauth&state=Zk3mP9qR2sT5vW8yA1bC4dE7",
  "expiresAt": "2026-10-12T14:13:11.000Z"
}

Response fields

Field	Type	Required	Notes
`url`	`string`	required	uri
`expiresAt`	`string`	required	date-time

Errors#

Every error is {"error":{"code","message","hint","docUrl","requestId"}}: branch on code. See Errors.

Status	Code	Meaning
401	`unauthorized`	No credentials, or the API key or session is invalid or revoked.
403	`forbidden`	The caller is authenticated but may not do this (wrong role, or an API key on a human-only endpoint).
500	`internal_error`	Something went wrong on Logu's side.
503	`service_unavailable`	A dependency is down or a feature isn't configured on this server.