Skip to main content
POST
Save Slack integration

Authorizations

Authorization
string
header
required

OAuth 2.1 authorization code + PKCE (S256). Tokens are tenant-bound (company_id) and scoped. Discover endpoints via /.well-known/oauth-authorization-server.

Body

application/json

Flat Slack integration config to save (or remove). The use-case reads every field flat off the body; unknown/future config fields pass through unchanged. companyId is injected from the token and must NOT be supplied.

remove
boolean

If true, remove the Slack integration instead of saving (all other fields ignored).

webhookUrl
string

Legacy single incoming-webhook URL.

channel
string

Legacy single channel label.

timeZone
string

IANA time zone (validated). Also accepted as 'timezone'. Invalid value => 400.

isActive
boolean

Whether the integration is enabled (defaults true when omitted).

webhooks
object[]

Configured webhook delivery targets.

workflows
object[]

Configured milestone/leaderboard workflows.

workflowMeta
object

Per-workflow runtime metadata keyed by workflow ID.

deliverableMilestones
object

Config for deliverable-milestone notifications (which webhook, on/off).

Response

Slack integration saved or removed.

data
object
required