Create Channel

slack.create_channel
ActionChat & messagingconnection required

Calls the Slack Web API with the connection's bot token.

Create a public or private channel and return its id.

Connection

Required
Yes — the node will not save without one
Auth type
API key
Providers
Slack
Secret shape
the Slack bot token (xoxb-…), or {"token": "xoxb-…"}
Resolved by
config.connection_id, else node.connection_id

Configuration

3 fields, 1 required. A dotted path is a nested object and name[] an array of objects — the editor renders the same tree.

FieldTypeRequiredDefaultConstraintsExample
name
Channel name: lower case, no spaces or periods, up to 80 characters.
stringYes—≤ 80 characters—
is_private
Create it as a private channel rather than a public one.
booleanNofalse——
team_id
Workspace to create the channel in. Only needed with an org-wide token.
stringNo———

Example configuration

Every value below is the contract’s own example or default — nothing invented.

{
  "is_private": false
}

Output

One shape.

result

FieldTypeExample
id
The channel id (C…, G… or D…).
string—
name
The channel name, without the leading #.
string—
is_private
True for a private channel.
boolean—
is_archived
True when the channel is archived.
boolean—
num_members
How many members Slack reports, when it reports one.
number—
created
When the channel was created (Unix seconds).
number—
{
  "created": 0,
  "id": "",
  "is_archived": false,
  "is_private": false,
  "name": "",
  "num_members": 0
}

Notes

  • The bot must be a member of a private channel before it can act there (Slack answers not_in_channel otherwise).
  • Slack rate-limits each Web API method on its own tier; a throttled call fails with the number of seconds to wait and is safe for the node's retry policy to repeat.
  • Slack lower-cases the name and replaces spaces, so the id is the safe handle.

See Create Channel run in a workflow.

In a technical demo we add the Slack connection, drop the node on the canvas and let Workflow Health pre-flight it before the first real run.