Organizations support multiple members, each with a role that controls what they can do.

Inviting a member

Only users with the members.invite permission (super admin and admin) can send invitations.

Dashboard flow:

1. Go to Members in your organization
2. Click Invite member
3. Enter their email address
4. Select a role (developer, viewer, admin, or finance)
5. Click Send invitation

The invitee receives an email with a link to /accept-invite/{token}. The link expires after 7 days.

Invitation states:

Invitees must have a HookDeploy account (or create one) before accepting.

Roles at a glance

See Roles & permissions for the complete 16-permission matrix.

Changing a member’s role

Requires members.change_role (super admin and admin).

1. Go to Members
2. Click the member’s role dropdown
3. Select the new role
4. Confirm

Role changes are audit-logged. A member can hold only one role at a time.

You cannot change your own role. Another admin must do it.

Removing a member

Requires members.remove (super admin and admin).

1. Go to Members
2. Click Remove next to the member
3. Confirm

Removed members immediately lose access to the organization’s endpoints and requests. Their HookDeploy account is unaffected — they can still access other orgs they belong to.

The org owner (super admin) cannot be removed without transferring ownership first.

Member limits by plan

Free plan users cannot invite members. Upgrade to Starter or above to add teammates.

Check current count:

curl -s "https://api.hookdeploy.dev/v1/usage" \
  -H "Authorization: Bearer hd_live_YOUR_KEY" \
  | jq '.data.member_count'

Permissions reference

Actions and the roles that can perform them:

Audit trail

Member additions, removals, and role changes are recorded in the audit log (requires audit.view permission). Each entry includes the actor, action, target, and timestamp.

Next steps

• Roles & permissions — Complete permission matrix
• Organizations — Personal vs team orgs
• Plans — Member limits per plan