Got 5 minutes? Help us improve the Google Chat developer documentation by taking a quick survey.

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 Create a membership. 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 in the CreateMembershipRequest:

  • 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 {person_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 resourceName for is people/123456789, you can add the user to the space by setting the to users/ or users/123456789.

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}

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.