Invite as members

POST {{baseUrl}}/v3/group_channels/:channel_url/invite

Invite as members

Invites one or more users as members into the group channel.

Note: By default, users in your application automatically join a private group channel promptly from an invitation without having to accept it. If you want to give them the option to decide whether to accept or decline an invitation, you should set the value of channel invitation preference to false through the update default channel invitation preference action. Or using the update a user's channel invitation preference action, you can also allow the option individually by user.

https://sendbird.com/docs/chat/v3/platform-api/guides/group-channel#2-invite-as-members

Request Body

{"channel_url"=>"<string>", "user_ids"=>["<string>", "<string>"], "users"=>["<string>", "<string>"], "invitation_status"=>"<object>", "hidden_status"=>"<object>"}

HEADERS

KeyDatatypeRequiredDescription
Api-Tokenstring(Required)
Content-Typestring
Acceptstring

RESPONSES

status: OK

{&quot;channel_url&quot;:&quot;\u003cstring\u003e&quot;,&quot;cover_url&quot;:&quot;\u003cstring\u003e&quot;,&quot;created_at&quot;:&quot;\u003cnumber\u003e&quot;,&quot;created_by&quot;:{&quot;require_auth_for_profile_image&quot;:&quot;\u003cboolean\u003e&quot;,&quot;nickname&quot;:&quot;\u003cstring\u003e&quot;,&quot;user_id&quot;:&quot;\u003cstring\u003e&quot;,&quot;profile_url&quot;:&quot;\u003cstring\u003e&quot;},&quot;creator&quot;:{&quot;require_auth_for_profile_image&quot;:&quot;\u003cboolean\u003e&quot;,&quot;is_online&quot;:&quot;\u003cboolean\u003e&quot;,&quot;user_id&quot;:&quot;\u003cstring\u003e&quot;,&quot;access_token&quot;:&quot;\u003cstring\u003e&quot;,&quot;has_ever_logged_in&quot;:&quot;\u003cboolean\u003e&quot;,&quot;is_active&quot;:&quot;\u003cboolean\u003e&quot;,&quot;last_seen_at&quot;:&quot;\u003cinteger\u003e&quot;,&quot;nickname&quot;:&quot;\u003cstring\u003e&quot;,&quot;discovery_keys&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;],&quot;session_tokens&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;],&quot;preferred_languages&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;],&quot;profile_url&quot;:&quot;\u003cstring\u003e&quot;,&quot;created_at&quot;:&quot;\u003cinteger\u003e&quot;,&quot;phone_number&quot;:&quot;\u003cstring\u003e&quot;,&quot;local&quot;:&quot;\u003cstring\u003e&quot;,&quot;locale&quot;:&quot;\u003cstring\u003e&quot;,&quot;is_hide_me_from_friends&quot;:&quot;\u003cboolean\u003e&quot;,&quot;is_shadow_blocked&quot;:&quot;\u003cboolean\u003e&quot;,&quot;is_created&quot;:&quot;\u003cboolean\u003e&quot;,&quot;metadata&quot;:{&quot;constructor&quot;:{&quot;arguments&quot;:{},&quot;caller&quot;:{&quot;value&quot;:&quot;\u003cCircular reference to #/components/schemas/Function detected\u003e&quot;},&quot;length&quot;:&quot;\u003cnumber\u003e&quot;,&quot;prototype&quot;:{}}},&quot;description&quot;:&quot;\u003cstring\u003e&quot;,&quot;end_at&quot;:&quot;\u003cnumber\u003e&quot;,&quot;start_at&quot;:&quot;\u003cnumber\u003e&quot;},&quot;custom_type&quot;:&quot;\u003cstring\u003e&quot;,&quot;data&quot;:&quot;\u003cstring\u003e&quot;,&quot;disappearing_message&quot;:{&quot;message_survival_seconds&quot;:&quot;\u003cnumber\u003e&quot;,&quot;is_triggered_by_message_read&quot;:&quot;\u003cboolean\u003e&quot;},&quot;freeze&quot;:&quot;\u003cboolean\u003e&quot;,&quot;ignore_profanity_filter&quot;:&quot;\u003cboolean\u003e&quot;,&quot;hidden_state&quot;:&quot;\u003cstring\u003e&quot;,&quot;invited_at&quot;:&quot;\u003cnumber\u003e&quot;,&quot;inviter&quot;:{&quot;require_auth_for_profile_image&quot;:&quot;\u003cboolean\u003e&quot;,&quot;is_online&quot;:&quot;\u003cboolean\u003e&quot;,&quot;user_id&quot;:&quot;\u003cstring\u003e&quot;,&quot;access_token&quot;:&quot;\u003cstring\u003e&quot;,&quot;has_ever_logged_in&quot;:&quot;\u003cboolean\u003e&quot;,&quot;is_active&quot;:&quot;\u003cboolean\u003e&quot;,&quot;last_seen_at&quot;:&quot;\u003cinteger\u003e&quot;,&quot;nickname&quot;:&quot;\u003cstring\u003e&quot;,&quot;discovery_keys&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;],&quot;session_tokens&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;],&quot;preferred_languages&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;],&quot;profile_url&quot;:&quot;\u003cstring\u003e&quot;,&quot;created_at&quot;:&quot;\u003cinteger\u003e&quot;,&quot;phone_number&quot;:&quot;\u003cstring\u003e&quot;,&quot;local&quot;:&quot;\u003cstring\u003e&quot;,&quot;locale&quot;:&quot;\u003cstring\u003e&quot;,&quot;is_hide_me_from_friends&quot;:&quot;\u003cboolean\u003e&quot;,&quot;is_shadow_blocked&quot;:&quot;\u003cboolean\u003e&quot;,&quot;is_created&quot;:&quot;\u003cboolean\u003e&quot;,&quot;metadata&quot;:{&quot;constructor&quot;:{&quot;arguments&quot;:{},&quot;caller&quot;:{&quot;value&quot;:&quot;\u003cCircular reference to #/components/schemas/Function detected\u003e&quot;},&quot;length&quot;:&quot;\u003cnumber\u003e&quot;,&quot;prototype&quot;:{}}},&quot;description&quot;:&quot;\u003cstring\u003e&quot;,&quot;end_at&quot;:&quot;\u003cnumber\u003e&quot;,&quot;start_at&quot;:&quot;\u003cnumber\u003e&quot;},&quot;is_access_code_required&quot;:&quot;\u003cboolean\u003e&quot;,&quot;is_broadcast&quot;:&quot;\u003cboolean\u003e&quot;,&quot;is_created&quot;:&quot;\u003cboolean\u003e&quot;,&quot;is_discoverable&quot;:&quot;\u003cboolean\u003e&quot;,&quot;is_distinct&quot;:&quot;\u003cboolean\u003e&quot;,&quot;is_ephemeral&quot;:&quot;\u003cboolean\u003e&quot;,&quot;is_frozen&quot;:&quot;\u003cboolean\u003e&quot;,&quot;is_hidden&quot;:&quot;\u003cboolean\u003e&quot;,&quot;is_public&quot;:&quot;\u003cboolean\u003e&quot;,&quot;is_push_enabled&quot;:&quot;\u003cboolean\u003e&quot;,&quot;is_super&quot;:&quot;\u003cboolean\u003e&quot;,&quot;joined_at&quot;:&quot;\u003cnumber\u003e&quot;,&quot;joined_member_count&quot;:&quot;\u003cnumber\u003e&quot;,&quot;last_message&quot;:{&quot;require_auth&quot;:&quot;\u003cboolean\u003e&quot;,&quot;message_survival_seconds&quot;:&quot;\u003cnumber\u003e&quot;,&quot;custom_type&quot;:&quot;\u003cstring\u003e&quot;,&quot;mentioned_users&quot;:[{&quot;user_id&quot;:&quot;\u003cstring\u003e&quot;,&quot;nickname&quot;:&quot;\u003cstring\u003e&quot;,&quot;profile_url&quot;:&quot;\u003cstring\u003e&quot;,&quot;metadata&quot;:{&quot;anyOf&quot;:&quot;\u003cstring\u003e&quot;}},{&quot;user_id&quot;:&quot;\u003cstring\u003e&quot;,&quot;nickname&quot;:&quot;\u003cstring\u003e&quot;,&quot;profile_url&quot;:&quot;\u003cstring\u003e&quot;,&quot;metadata&quot;:{&quot;anyOf&quot;:&quot;\u003cstring\u003e&quot;}}],&quot;translations&quot;:&quot;\u003cobject\u003e&quot;,&quot;updated_at&quot;:&quot;\u003cnumber\u003e&quot;,&quot;is_op_msg&quot;:&quot;\u003cboolean\u003e&quot;,&quot;is_removed&quot;:&quot;\u003cboolean\u003e&quot;,&quot;user&quot;:{&quot;require_auth_for_profile_image&quot;:&quot;\u003cboolean\u003e&quot;,&quot;is_active&quot;:&quot;\u003cboolean\u003e&quot;,&quot;role&quot;:&quot;\u003cstring\u003e&quot;,&quot;user_id&quot;:&quot;\u003cstring\u003e&quot;,&quot;nickname&quot;:&quot;\u003cstring\u003e&quot;,&quot;profile_url&quot;:&quot;\u003cstring\u003e&quot;,&quot;metadata&quot;:{&quot;anyOf&quot;:&quot;\u003cstring\u003e&quot;}},&quot;file&quot;:&quot;\u003cobject\u003e&quot;,&quot;message&quot;:&quot;\u003cstring\u003e&quot;,&quot;data&quot;:&quot;\u003cstring\u003e&quot;,&quot;message_retention_hour&quot;:&quot;\u003cnumber\u003e&quot;,&quot;silent&quot;:&quot;\u003cboolean\u003e&quot;,&quot;type&quot;:&quot;\u003cstring\u003e&quot;,&quot;created_at&quot;:&quot;\u003cnumber\u003e&quot;,&quot;channel_type&quot;:&quot;\u003cstring\u003e&quot;,&quot;req_id&quot;:&quot;\u003cstring\u003e&quot;,&quot;mention_type&quot;:&quot;\u003cstring\u003e&quot;,&quot;channel_url&quot;:&quot;\u003cstring\u003e&quot;,&quot;message_id&quot;:&quot;\u003cnumber\u003e&quot;,&quot;size&quot;:&quot;\u003cnumber\u003e&quot;,&quot;sorted_metaarray&quot;:[&quot;\u003cobject\u003e&quot;,&quot;\u003cobject\u003e&quot;],&quot;thread_info&quot;:&quot;\u003cobject\u003e&quot;,&quot;parent_message_id&quot;:&quot;\u003cnumber\u003e&quot;,&quot;parent_message_info&quot;:&quot;\u003cobject\u003e&quot;,&quot;is_reply_to_channel&quot;:&quot;\u003cboolean\u003e&quot;},&quot;max_length_message&quot;:&quot;\u003cnumber\u003e&quot;,&quot;member_count&quot;:&quot;\u003cnumber\u003e&quot;,&quot;members&quot;:[{&quot;connection_status&quot;:&quot;\u003cstring\u003e&quot;,&quot;friend_discovery_key&quot;:&quot;\u003cstring\u003e&quot;,&quot;friend_name&quot;:&quot;\u003cstring\u003e&quot;,&quot;is_active&quot;:&quot;\u003cboolean\u003e&quot;,&quot;is_blocked_by_me&quot;:&quot;\u003cboolean\u003e&quot;,&quot;is_blocking_me&quot;:&quot;\u003cboolean\u003e&quot;,&quot;is_muted&quot;:&quot;\u003cboolean\u003e&quot;,&quot;last_seen_at&quot;:&quot;\u003cinteger\u003e&quot;,&quot;meta_data&quot;:{&quot;constructor&quot;:{&quot;arguments&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;caller&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;length&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;prototype&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;}}},&quot;nickname&quot;:&quot;\u003cstring\u003e&quot;,&quot;plain_profile_url&quot;:&quot;\u003cstring\u003e&quot;,&quot;preferred_languages&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;],&quot;profile_url&quot;:&quot;\u003cstring\u003e&quot;,&quot;require_auth&quot;:&quot;\u003cboolean\u003e&quot;,&quot;restriction_info&quot;:{&quot;description&quot;:&quot;\u003cstring\u003e&quot;,&quot;end_at&quot;:&quot;\u003cnumber\u003e&quot;,&quot;restriction_type&quot;:&quot;\u003cstring\u003e&quot;},&quot;role&quot;:&quot;\u003cstring\u003e&quot;,&quot;state&quot;:&quot;\u003cstring\u003e&quot;,&quot;user_id&quot;:&quot;\u003cstring\u003e&quot;},{&quot;connection_status&quot;:&quot;\u003cstring\u003e&quot;,&quot;friend_discovery_key&quot;:&quot;\u003cstring\u003e&quot;,&quot;friend_name&quot;:&quot;\u003cstring\u003e&quot;,&quot;is_active&quot;:&quot;\u003cboolean\u003e&quot;,&quot;is_blocked_by_me&quot;:&quot;\u003cboolean\u003e&quot;,&quot;is_blocking_me&quot;:&quot;\u003cboolean\u003e&quot;,&quot;is_muted&quot;:&quot;\u003cboolean\u003e&quot;,&quot;last_seen_at&quot;:&quot;\u003cinteger\u003e&quot;,&quot;meta_data&quot;:{&quot;constructor&quot;:{&quot;arguments&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;caller&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;length&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;prototype&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;}}},&quot;nickname&quot;:&quot;\u003cstring\u003e&quot;,&quot;plain_profile_url&quot;:&quot;\u003cstring\u003e&quot;,&quot;preferred_languages&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;],&quot;profile_url&quot;:&quot;\u003cstring\u003e&quot;,&quot;require_auth&quot;:&quot;\u003cboolean\u003e&quot;,&quot;restriction_info&quot;:{&quot;description&quot;:&quot;\u003cstring\u003e&quot;,&quot;end_at&quot;:&quot;\u003cnumber\u003e&quot;,&quot;restriction_type&quot;:&quot;\u003cstring\u003e&quot;},&quot;role&quot;:&quot;\u003cstring\u003e&quot;,&quot;state&quot;:&quot;\u003cstring\u003e&quot;,&quot;user_id&quot;:&quot;\u003cstring\u003e&quot;}],&quot;message_offset_timestamp&quot;:&quot;\u003cnumber\u003e&quot;,&quot;message_survival_seconds&quot;:&quot;\u003cnumber\u003e&quot;,&quot;my_count_preference&quot;:&quot;\u003cstring\u003e&quot;,&quot;my_last_read&quot;:&quot;\u003cnumber\u003e&quot;,&quot;my_member_state&quot;:&quot;\u003cstring\u003e&quot;,&quot;my_muted_state&quot;:&quot;\u003cstring\u003e&quot;,&quot;my_push_trigger_option&quot;:&quot;\u003cstring\u003e&quot;,&quot;my_role&quot;:&quot;\u003cstring\u003e&quot;,&quot;name&quot;:&quot;\u003cstring\u003e&quot;,&quot;operators&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;],&quot;sms_fallback&quot;:{&quot;wait_seconds&quot;:&quot;\u003cnumber\u003e&quot;,&quot;exclude_user_ids&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;]},&quot;unread_mention_count&quot;:&quot;\u003cnumber\u003e&quot;,&quot;unread_message_count&quot;:&quot;\u003cnumber\u003e&quot;}