Add a member to an access group

Adds an existing site member to an access group. The member must already exist on the site — create them first with createMember if needed.

Scope-managed groups cannot have members added via API — returns 403 Forbidden. Returns 409 Conflict if the member is already in the group.

POST /api/v1/access-groups/{groupId}/members

Bearer token

curl 'https://api.sotion.so/api/v1/access-groups/123e4567-e89b-42d3-a456-426614174000/members' \
  --request POST \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "memberId": "123e4567-e89b-42d3-a456-426614174000"
}'

{
  "data": {
    "id": "123e4567-e89b-42d3-a456-426614174000",
    "email": "[email protected]",
    "displayName": "example",
    "status": "active",
    "verified": true,
    "paid": true,
    "registeredAt": "2026-01-01T12:00:00Z",
    "lastLoginAt": "2026-01-01T12:00:00Z",
    "createdAt": "2026-01-01T12:00:00Z",
    "updatedAt": "2026-01-01T12:00:00Z",
    "accessGroups": [
      {
        "id": "123e4567-e89b-42d3-a456-426614174000",
        "name": "example"
      }
    ]
  }
}

Member added to group.

Path parameters

· 1

groupId string · uuid required

UUID of the access group. Get group IDs from listAccessGroups or createAccessGroup responses.

Body

· AddGroupMemberRequest

required application/json

memberId string · uuid required

UUID of an existing site member to add to the group. The member must already exist — use createMember first if needed.

Path parameters

Body

Responses