Add organization member
Adds a member to a business organization, by email or customerId.
- By
email: invite or add by email address. If the email matches a user who has already signed in through your JWT, they become a member immediately; otherwise a pending invite is created and accepted automatically the first time that email signs in via yourkybJWT. PassemailInviteLinkto have Etherfuse email them an invite URL you control, or omit it to create the invite silently and notify them yourself. Use this when you don’t have the person’scustomerIdyet, or when you want Etherfuse to send the invite. - By
customerId: add an existing customer directly by theirsub; no email is sent. ThecustomerIdonly exists once that person has exchanged a JWT via POST /auth/token (or been launched) at least once: an unknownsubreturns 404, and a business org id (service account) is rejected.
Re-adding someone who was previously removed revives them. The target org must be a business org you own (your own org or a direct child).
The response has the same shape as List organization members: a person added immediately appears under members; an emailed invite appears under invited.
Authorizations
API key sent in the Authorization header.
Path Parameters
The business organization to add the member to (your own org or a direct child).
Body
The member's role in the organization.
admin, member Invite or add a member by email address. If the email matches a user who has already signed in through your JWT, they're added as a member immediately; otherwise a pending invite is created and accepted automatically the first time that email signs in via your kyb JWT. Use email when you don't have the person's customerId yet, or when you want Etherfuse to email them an invite (see emailInviteLink). Provide exactly one of email or customerId.
Add an existing customer directly by their sub (the value you put in the JWT sub when they sign in); no email is sent. The customer must already exist, which happens the first time they exchange a JWT via POST /auth/token (or are launched); an unknown sub returns 404. A business org id (service account) is rejected. Provide exactly one of email or customerId.
Optional. When adding by email and a pending invite is created (the email isn't already a member), Etherfuse emails them this URL as-is (you control the full link, including any query params) as the call to action. Omit it to create the invite silently and notify the user yourself. Ignored when the email already matches a member who is added immediately.