Bulk create up to 500 members

Creates multiple members in a single request. Accepts up to 500 members in the members array. If accessGroupIds is provided, all successfully created members are assigned to those groups.

Returns HTTP 207 Multi-Status with per-item results. Each item in the response has a status of 'created' (success with member data), 'conflict' (email already exists), or 'error' (other failure). The summary object shows totals: total attempted, created count, and failed count.

This endpoint does NOT fail atomically — some members may be created while others fail. Always check the per-item results.

POST /api/v1/members/bulk

Bearer token

curl 'https://api.sotion.so/api/v1/members/bulk' \
  --request POST \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "members": [
    {
      "email": "[email protected]",
      "displayName": "example",
      "paid": false
    }
  ],
  "accessGroupIds": [
    "123e4567-e89b-42d3-a456-426614174000"
  ]
}'

{
  "data": [
    {
      "email": "[email protected]",
      "status": "created",
      "member": {
        "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"
      },
      "error": {
        "code": "example",
        "message": "example"
      }
    }
  ],
  "summary": {
    "total": 1,
    "created": 1,
    "failed": 1
  }
}

Multi-status response with per-item results.

Body

· BulkCreateMembersRequest

required application/json

members array of object · min items: 1· max items: 500 required

Array of member objects to create. Minimum 1, maximum 500.

accessGroupIds array of string · max items: 50

UUIDs of custom access groups to assign to ALL created members. Scope groups not allowed.

Body

Responses