{
  "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"
      }
    ]
  }
}