Skip to main content
POST
Create a Slack channel

Authorizations

Authorization
string
header
required

An organization-scoped API key, minted in control under Settings → API keys. Every failure to authenticate answers one identical 401: "Provide a valid organization-scoped API key or an active session." Each operation names the one scope it is filed under, <resource>:<read|write>, where the resource is the first path segment after /api/v1/; a key minted today carries all 22 of them. Scopes are RECORDED — on the key and on every audit row — and are not yet enforced: no request is refused for want of one.

Headers

Idempotency-Key
string

Any unique string.

Body

application/json
name
string
required

The room's name: lower-case letters, numbers, - and _, at most 80. A leading # is dropped and spaces become hyphens.

mapping
object
required

What the room is for: internal, or client with the Client's slug or id.

private
boolean

Defaults to true.

people
string[]

The people to bring in, by Slack user id — the org's own people only.

A Slack user id.

workers
string[]

The Workers to map and bring in.

A Worker id.

Response

Success.

data
object
required