Add a team member with a role
Create a login for a new staff member (or link an existing account) and assign them a role.
Email new to Hyperprop (most common):
- You provide the member’s email, name, and role.
- Hyperprop creates a dedicated login with a strong temporary password.
- The temporary password is returned once in this response (
tempPassword) — copy it and share it with the member through a secure channel. - The member signs in at your dashboard URL and should change the password under Settings → Security.
Email already has a Hyperprop account:
The existing account is converted to a staff login and linked to your team. The response has linkedExisting: true and tempPassword: null — the person signs in with the password they already use. Note: a converted trader account can no longer log in to the trader terminal; removing them from the team converts it back to a regular account.
Important:
- An email that is already a staff login at another organization cannot be added (409 EMAIL_IN_USE).
- The member’s access is defined entirely by their role — see GET /organization/roles for the permission matrix.
- Lost password? Use POST /organization/team//reset-password to generate a new temporary password.
Permissions: requires manage access to “Team & roles” (admins have this by default).
Authentication: Accepts either Authorization: Bearer <jwt> (dashboard) or X-API-Key: hp_live_... (programmatic).
Authorizations
JWT Bearer token for user session auth. Format: "Bearer {token}". Used by User and Organization endpoints.
Body
Work email for the staff member. If the email is new to Hyperprop a dedicated login is created; if it already has a Hyperprop account, that account is linked to your team instead.
"sarah@propfirm.com"
Display name shown in the dashboard and audit log
1 - 120"Sarah Johnson"
Role to assign. Get available roles (system presets + your custom roles) from GET /organization/roles.
"7e0d1c9a-3f2b-4d5e-8a6f-1b2c3d4e5f60"
Related topics
Change a team member's roleGet team members for your organizationRemove a team memberGenerate a new temporary password for a team memberList roles (system presets + your custom roles)