SlackWeb.Conversations.create
You're seeing just the function
create
, go back to SlackWeb.Conversations module for more information.
Initiates a public or private channel-based conversation.
Required Params
name
- Name of the public or private channel to create. ex:mychannel
Optional Params
is_private
- Create a private channel instead of a public one. ex:true
user_ids
- Required for workspace apps. A list of between 1 and 30 human users that will be added to the newly-created conversation. This argument has no effect when used by classic Slack apps. ex:W1234567890,U2345678901,U3456789012
Errors the API can return:
account_inactive
- Authentication token is for a deleted user or workspace.ekm_access_denied
- Administrators have suspended the ability to post a message.fatal_error
- The server could not complete your operation(s) without encountering a catastrophic error. It's possible some aspect of the operation succeeded before the error was raised.internal_error
- The server could not complete your operation(s) without encountering an error, likely due to a transient issue on our end. It's possible some aspect of the operation succeeded before the error was raised.invalid_arg_name
- The method was passed an argument whose name falls outside the bounds of accepted or expected values. This includes very long names and names with non-alphanumeric characters other than _. If you get this error, it is typically an indication that you have made a very malformed API call.invalid_arguments
- The method was called with invalid arguments.invalid_auth
- Some aspect of authentication cannot be validated. Either the provided token is invalid or the request originates from an IP address disallowed from making the request.invalid_charset
- The method was called via aPOST
request, but thecharset
specified in theContent-Type
header was invalid. Valid charset names are:utf-8
iso-8859-1
.invalid_form_data
- The method was called via aPOST
request withContent-Type
application/x-www-form-urlencoded
ormultipart/form-data
, but the form data was either missing or syntactically invalid.invalid_name
- Value passed forname
was invalid.invalid_name_maxlength
- Value passed forname
exceeded max length.invalid_name_punctuation
- Value passed forname
contained only punctuation.invalid_name_required
- Value passed forname
was empty.invalid_name_specials
- Value passed forname
contained unallowed special characters or upper case characters.invalid_post_type
- The method was called via aPOST
request, but the specifiedContent-Type
was invalid. Valid types are:application/json
application/x-www-form-urlencoded
multipart/form-data
text/plain
.invalid_users
- Value passed foruser_ids
was empty or invalid.is_bot
- This method cannot be called by a bot user.missing_post_type
- The method was called via aPOST
request and included a data payload, but the request did not include aContent-Type
header.missing_scope
- The token used is not granted the specific scope permissions required to complete this request.name_taken
- A channel cannot be created with the given name.no_channel
- Value passed forname
was empty.no_permission
- The workspace token used in this request does not have the permissions necessary to complete the request. Make sure your app is a member of the conversation it's attempting to post a message to.not_authed
- No authentication token provided.org_login_required
- The workspace is undergoing an enterprise migration and will not be available until migration is complete.request_timeout
- The method was called via aPOST
request, but thePOST
data was either missing or truncated.restricted_action
- A team preference prevents the authenticated user from creating channels.team_added_to_org
- The workspace associated with your request is currently undergoing migration to an Enterprise Organization. Web API and other platform operations will be intermittently unavailable until the transition is complete.token_revoked
- Authentication token is for a deleted user or workspace or the app has been removed.too_many_convos_for_app_on_team
- This app has exceeded its per-workspace limit of public and private channels.too_many_convos_for_team
- The workspace has exceeded its limit of public and private channels.user_is_ultra_restricted
- This method cannot be called by a single channel guest.user_not_found
- One or more users inuser_ids
was not found.