Members

Send a magic login link email

Generates a magic login link and sends it to the member's email address. This sends a real email — it does NOT return the link URL (for security reasons).

Optionally specify a redirectPath in the request body to redirect the member to a specific page after they click the login link (e.g., '/premium-content').

Rate limited to 5 requests per minute per member and 50 requests per minute per site. Returns 429 Too Many Requests if the rate limit is exceeded.

POST /members/{memberId}/login-links

curl --request POST \
  --url 'https://api.sotion.so/api/v1/members/{MEMBERID}/login-links' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "key": "value"
}'

{
  "data": {
    "memberId": "<uuid>",
    "status": "sent"
  }
}

Authorizations

Authorization string required header

Per-site API key (prefix: so_...). Each key is scoped to exactly one Sotion site — the site context is determined entirely by the key. No site ID is needed in any URL. Pass as: Authorization: Bearer so_...

Path Parameters

memberId string (uuid) required

UUID of the member. Get member IDs from listMembers or createMember responses.

Request Body

application/json

redirectPath string

Optional path to redirect the member to after they click the login link and are authenticated. Example: '/premium-content'. If not provided, the member lands on the site's home page.

Response

application/json

Location string response header

URL of the login-links resource.
X-RateLimit-Limit integer response header

Maximum requests allowed in the current window.
X-RateLimit-Remaining integer response header

Requests remaining in the current window.
X-RateLimit-Reset integer response header

Unix timestamp (seconds) when the rate limit window resets.
X-Request-Id string (uuid) response header

Unique request identifier for support and debugging.
data object
+ - Show Child Attributes
- memberId string (uuid)
- status string enum enum
  
  Allowed values: sent.

Send a magic login link email

curl --request POST \
  --url 'https://api.sotion.so/api/v1/members/{MEMBERID}/login-links' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "key": "value"
}'

{
  "data": {
    "memberId": "<uuid>",
    "status": "sent"
  }
}