Skip to main content

create_channel

Facts​

DescriptionCreate a new channel
SchemaSchema.slack.functions.CreateChannel
Schema referenceslack#/functions/create_channel
Required scopes
channels:managegroups:write

Input Parameters​

Required Input Parameters

channel_nameSchema.types.stringRequired

The name of the channel; the function will attempt to create a channel name that follows Slack's channel name guidelines, but the channel's name may end up being different than the exact string provided.

Examples
team-devrel-running-buddies
proj-remove-all-oxford-commas
farewell-jesse

Optional Input Parameters

is_privateSchema.types.booleanOptional

Set to true if the channel should be private, set to false if the channel should be public.

Examples
true
false
manager_idsSchema.types.arrayOptional

Select Channel Manager(s)

Examples
["U111AAA111","U222BBB222"]
team_idSlackTypes.team_idOptional

Select a workspace

Examples
T1234567890

Output Parameters​

Required Output Parameters

channel_idSchema.slack.types.channel_idRequired

The conversation ID for the channel you created

Examples
C123456
D123ABC456

Optional Output Parameters

manager_idsSchema.types.arrayOptional

Person(s) who were made channel manager

Examples
["U111AAA111","U222BBB222"]

Usage info​

Your automations may create channels as part of a workflow using this Slack function.

Consider the channel_name you specify as merely a suggestion. If it's taken, Slack might append characters to it. Or if you provide some kind of characters Slack doesn't use for channel names, they might be munged.

To set the channel managers as part of the newly created channel, specify one or more IDs in an array to manager_ids.

Example workflow step​

const createChannelStep = ExampleWorkflow.addStep(
  Schema.slack.functions.CreateChannel,
  {
    channel_name: "broadcast-jesse-promotion",
    is_private: false,
  },
);