Method: spaces.members.create

Creates a human membership or app membership for the calling app. Creating memberships for other apps isn't supported. For an example, see Invite or add a user or a Google Chat app to a space. When creating a membership, if the specified member has their auto-accept policy turned off, then they're invited, and must accept the space invitation before joining. Otherwise, creating a membership adds the member directly to the specified space. Requires user authentication.

To specify the member to add, set the for the human or app member, or set the for the group member.

  • To add the calling app to a space or a direct message between two human users, use users/app. Unable to add other apps to the space.

  • To add a human user, use users/{user}, where {user} can be the email address for the user. For users in the same Workspace organization {user} can also be the id for the person from the People API, or the id for the user in the Directory API. For example, if the People API Person profile ID for is 123456789, you can add the user to the space by setting the to users/ or users/123456789.

  • To add or invite a Google group in a named space, use groups/{group}, where {group} is the id for the group from the Cloud Identity Groups API. For example, you can use Cloud Identity Groups lookup API to retrieve the ID 123456789 for group email, then you can add or invite the group to a named space by setting the to groups/123456789. Group email isn't supported, and Google groups can only be added as members in named spaces.

HTTP request


The URL uses gRPC Transcoding syntax.

Path parameters



Required. The resource name of the space for which to create the membership.

Format: spaces/{space}

Query parameters



When true, the method runs using the user's Google Workspace administrator privileges.

The calling user must be a Google Workspace administrator with the manage chat and spaces conversations privilege.

Requires the chat.admin.memberships OAuth 2.0 scope.

Creating app memberships or creating memberships for users outside the administrator's Google Workspace organization isn't supported using admin access.

Request body

The request body contains an instance of Membership.

Response body

If successful, the response body contains a newly created instance of Membership.

Authorization scopes

Requires one of the following OAuth scopes:


For more information, see the Authorization guide.