Skip to content
Go to file
Cannot retrieve contributors at this time
48 lines (43 sloc) 3.43 KB


This method sends invitation to a new user by email. This endpoint uses a legacy token to authenticate. Please make sure you are using this token type and not one of the newer types.


This method has the URL and follows the Slack Web API calling conventions.

Argument Example Required Description
token xxxx-xxxxxxxxx-xxxx Required Authentication token (Requires scope: 'client')
email Required Email address of the new user
channels C1234567890,G12345678 Optional Comma-separated list of IDs (not names!) for channels, which the new user will auto-join. Both channel IDs for public channels and group IDs for private chanels work.
real_name John Doe Optional Prefilled input for the "Full name" field on the "new user registration" page.
resend true Optional Resend the invitation email if the user has already been invited and the email was sent some time ago.
restricted true Optional Invite a guest that can use multiple channels
ultra_restricted true Optional Invite a guest that can use one channel only
expiration_ts 1510863690 Optional Set the expiration timestamp for when the guest account will automatically be disabled


  • Please make sure to use a legacy token with this API method. It will not work with any other token type.
  • Sending an invite to an email address will only work once. Additional requests to the same email address will be ignored. However, if the invite is still pending you can remove it (through the admin interface) and sent another one.


You will receive a standard Slack API response in JSON as described here. For example if successful you get:

"ok": true

Errors & Warnings

Error Description
already_in_team User is already part of the team
already_invited User has already received an email invitation
already_in_team_invited_user User is already part of the team (?? - more info needed on when this error occurs)
channel_not_found Provided channel ID does not match a real channel
expiration_requires_restricted expiration_ts can only be used with guest accounts
invalid_email Invalid email address (e.g. "qwe"). Note that Slack does not recognize some email addresses even though they are technically valid. This is a known issue.
invite_limit_reached The maximum number of invites is reached
missing_scope Using an access_token not authorized for 'client' scope. Note that you need a legacy token for this API method.
not_allowed When SSO is enabled, this method can not be used to invite new users except guests. The SCIM API needs to be used instead to invite new users. For inviting guests the restricted or
not_allowed_token_type Token type is invalid. Workspace tokens do not seem to be compatible with this method
not_authed No authentication token provided.
requires_one_channel When ultra_restricted is true and no channel is provided. A single channel must be provided.
sent_recently When using resend=true, the email has been sent recently already
ultra_restricted property needs to be provided
user_disabled User account has been deactivated
You can’t perform that action at this time.