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 and the chat.memberships (for human membership) or (for app membership) scope.

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} is either 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 is people/123456789, you can add the user to the space by setting the to 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.