API ReferenceOrganizations

Add member to organization

View as Markdown
Adds an existing user to the organization with the specified role. You can provide either user_id (for existing users) or wallet_address (to invite by wallet). When using wallet_address, if no user exists for that wallet, a placeholder user is created and the wallet is linked. Default role is 'client'. For client/investor users, use role 'client' — these users will not have API access. Requires org membership (JWT) or API key with write:org permission.

Authentication

AuthorizationBearer

JWT access token from POST /auth/login or POST /oauth/token

OR
x-api-keystring

Organization-scoped API key created via POST /orgs/:orgId/api-keys. Carries permission grants.

Path parameters

orgIdstringRequired

Request

This endpoint expects an object.
user_idstringOptional
wallet_addressstringOptional
chain_eiddoubleOptional
emailstringOptional
display_namestringOptional
rolestringOptional

Response

Response
idstring
organization_idstringOptional
user_idstring or nullOptional
roleenum or nullOptional
Member role
statusstring or nullOptional
created_atstring or nullOptional
updated_atstring or nullOptional
userobject or nullOptional

Errors

400
Bad Request Error
403
Forbidden Error
409
Conflict Error