Activates the invited user's account. No request body is required — the password is managed internally.
Before calling this endpoint, create a session scoped to the invited user using the customerUid returned in step 1, then pass the session headers (X-Session-Id + X-Client-Id) with this request.
On success (200), the account is activated with no further steps required.
On 403, the account is created but additional actions are required (e.g., phone verification, KYC). Continue the onboarding flow using your session headers (X-Session-Id + X-Client-Id) for all subsequent /limited/ endpoints.
403 meta.fields values:
| Value | Meaning |
|---|---|
phoneNumber | User must verify their phone number |
kyc | User must complete KYC (individual signup) |
kyb | User must complete KYB (business onboarding) |
Possible error codes:
| Code | Status | Description |
|---|---|---|
INVITATION_DOES_NOT_EXIST | 400 | Token is invalid or already used |
REQUIRED_DEVICE_ID | 400 | V-Client-Device-Id header is missing |
REQUIRED_INVITATION_TOKEN | 400 | token query parameter is missing |
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Activates the invited user's account. No request body is required — the password is managed internally.
Before calling this endpoint, create a session scoped to the invited user using the customerUid returned from step 1 (Check Invitation Token), then pass X-Session-Id + X-Client-Id with this request.
A 200 means the account is immediately active. A 403 means the account is created but additional onboarding steps (phone verification, KYC) are required — continue with steps 4–9 using your session headers.
Path differs per user type — use the correct URL for your user type:
- Individual:
POST /branches/public/v1/individual/invites/accept- Business Owner:
POST /branches/public/v1/businessowner/invites/accept- Operator:
POST /branches/public/v1/operator/invites/acceptThe headers and response schema are the same for all three.
Account activated successfully. No further onboarding steps needed.