Add a User to Heap Analytics
Use this checklist to invite the collaborator into Heap.
Prerequisites
- Identify the Heap organization URL and list of projects (production, staging, mobile, web) the collaborator should access.
- Confirm whether SSO or SCIM provisioning is enabled; if so, pre-create the user in your IdP.
- Collect the collaborator’s service account email and decide which default project role applies.
- Ensure you have Organization Admin privileges.
Invitation Workflow
- Log into Heap and open Account → Manage from the top navigation.
- Choose Members and click Invite New Members.
- Enter the collaborator’s service account email.
- Select the appropriate Organization Role (Admin if the collaborator will manage governance, Member for standard analysis).
- Assign the projects the account should access and choose the project-level role (Manager, Analyst, Viewer).
- Send the invitation and record the reason in your internal tracker.
After Inviting
- Confirm the account shows under Pending Invites until accepted.
- Share any MFA, VPN, or password requirements with the collaborator’s team.
- Update your IAM records with the invite date, role, and approver.
Troubleshooting
- Invite not delivered: Allowlist
@heap.io
and resend the invitation. - SSO required: Ensure the user is added to the appropriate IdP group before clicking the invite link.
- Need temporary access: Set a reminder to remove or downgrade the user at the agreed sunset date.