Add Members (Pre-add)
Pre-add users to a Space as pending-activation members and send them an invitation email. This is used in Designated Space Mode before initiating OAuth authorization.
How it works:
1. Call this endpoint to pre-add the target users (status: pending activation). An invitation email is sent to each user.
2. Initiate OAuth authorization with both space_id and login_hint (see Authorization Endpoint).
3. When the user logs in on the Consent page and clicks Agree, their membership is automatically activated.
If you skip this step: Users cannot enter the designated Space through the OAuth Consent page — authorization will be rejected with access_denied.
Idempotent: If the email is already a pending-activation or active member of the Space, the call succeeds without creating duplicates or re-sending invitation emails.
Required Scope: member:manage
Request Parameters
Response Parameters
Error Codes
| Error Code | Description |
|---|---|
INVALID_REQUEST | Missing or invalid parameters |
UNAUTHORIZED | access_token missing, invalid, or expired |
FORBIDDEN | The app is not installed in the target Space |
INTERNAL_ERROR | Internal server error |