Create a new member

Creates a new member on the site. Only email is required — all other fields are optional.

The email is normalized to lowercase and trimmed. New members are created with status 'active' and verified 'false'. If accessGroupIds is provided, the member is atomically assigned to those access groups during creation. Scope-managed groups cannot be specified and will return 403.

Returns the created member with their full profile including access group memberships. Returns 409 Conflict if a member with the same email already exists on this site.

POST /api/v1/members

Bearer token

curl 'https://api.sotion.so/api/v1/members' \
  --request POST \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "email": "[email protected]",
  "displayName": "example",
  "paid": false,
  "accessGroupIds": [
    "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 created.

Body

· CreateMemberRequest

required application/json

email string · email· max length: 320 required

Email address for the new member. Will be normalized to lowercase and trimmed. Must be unique per site.

displayName string · max length: 200· nullable

Optional display name for the member.

paid boolean · default: false

Whether to mark the member as a paying customer. Defaults to false.

accessGroupIds array of string · max items: 50

UUIDs of custom access groups to assign the member to during creation. Groups are assigned atomically. Scope-managed groups are not allowed and will return 403.

Body

Responses