Current section
Files
Jump to
Current section
Files
priv/docs/methods/conversations.create.json
{
"args": {
"is_private": {
"desc": "Create a private channel instead of a public one",
"example": "true",
"required": false,
"type": "boolean"
},
"name": {
"desc": "Name of the public or private channel to create",
"example": "mychannel",
"required": true,
"type": "string"
},
"team_id": {
"desc": "encoded team id to create the channel in, required if org token is used",
"required": false
}
},
"desc": "Initiates a public or private channel-based conversation",
"errors": {
"cannot_create_channel": "This channel is unable to be created.",
"canvas_disabled_user_team": "Canvas is disabled on user's team",
"invalid_name": "Value passed for `name` was invalid.",
"invalid_name_maxlength": "Value passed for `name` exceeded max length.",
"invalid_name_punctuation": "Value passed for `name` contained only punctuation.",
"invalid_name_required": "Value passed for `name` was empty.",
"invalid_name_specials": "Value passed for `name` contained unallowed special characters or upper case characters.",
"missing_argument": "A required argument is missing.",
"name_taken": "A channel cannot be created with the given name.",
"no_channel": "Value passed for `name` was empty.",
"restricted_action": "A team (workspace) preference prevents the authenticated user from creating channels."
},
"rate_limit": {
"label": "Tier 2: 20+ per minute",
"url": "https://docs.slack.dev/apis/web-api/rate-limits"
},
"scopes": {
"bot": [
{
"name": "channels:manage",
"url": "https://docs.slack.dev/reference/scopes/channels.manage"
},
{
"name": "channels:write",
"url": "https://docs.slack.dev/reference/scopes/channels.write"
},
{
"name": "groups:write",
"url": "https://docs.slack.dev/reference/scopes/groups.write"
},
{
"name": "im:write",
"url": "https://docs.slack.dev/reference/scopes/im.write"
},
{
"name": "mpim:write",
"url": "https://docs.slack.dev/reference/scopes/mpim.write"
}
],
"user": [
{
"name": "channels:write",
"url": "https://docs.slack.dev/reference/scopes/channels.write"
},
{
"name": "groups:write",
"url": "https://docs.slack.dev/reference/scopes/groups.write"
},
{
"name": "im:write",
"url": "https://docs.slack.dev/reference/scopes/im.write"
},
{
"name": "mpim:write",
"url": "https://docs.slack.dev/reference/scopes/mpim.write"
}
]
}
}