Install Debrief from the HubSpot marketplace
The step-by-step install flow, from discovery in the marketplace to your first handoff.
Debrief is installed through the HubSpot App Marketplace. The flow takes about two minutes from click to first brief.
Before you install
- You need Super Admin or App Marketplace Access permission in the HubSpot portal.
- Debrief uses HubSpot CRM UI extension cards. HubSpot will confirm your portal is eligible for these at install time.
Install flow
- Find Debrief in the HubSpot App Marketplace. Search for "Debrief" or navigate to the Dunamis Studios publisher page.
- Click Install app.
- Pick the portal you want to install into. If you manage multiple portals, Debrief bills per portal, so pick intentionally.
- Approve the OAuth scopes Debrief requests (see What Debrief reads from HubSpot, and what it doesn't).
- HubSpot redirects you to Dunamis Studios to finalize the install.
Finalizing at Dunamis Studios
After HubSpot approves the install, you land on a Dunamis Studios claim page.
- If you already have a Dunamis Studios account with the same email: sign in. The entitlement links automatically.
- If you do not: create an account on the spot. The entitlement attaches the moment you verify your email.
The Dunamis Studios account is separate from your HubSpot account. One Dunamis account can hold entitlements for multiple portals and multiple products.
Add the Debrief card to your record layouts
Once the entitlement is linked, return to HubSpot. Installing the app registers the Debrief card with your portal, but HubSpot does not automatically place CRM cards onto record pages. You pick which object types show the card and where on the layout it sits. Do this for each object type Debrief should appear on (Deals, Contacts, Companies, Tickets, custom objects).
Add it to the Deals record page
Deals is the most common first-use surface. Repeat this flow for every other object type you want Debrief on.
- Click the Settings gear icon in the top-right nav.
- In the left sidebar, go to Data Management → Objects → Deals.
- Click the Record customization tab at the top of the Deals settings.
- Pick the record view you want to edit, either the default view for all users or a team-specific view. You can also create a new view for a specific team.
- In the layout editor, click + Add a tab to create a new tab, or select an existing tab to modify.
- In the target section, click + Add cards.
- In the card picker, find Debrief (cards from installed apps appear in this list).
- Add the card and drag it into the position you want.
- Click Save at the top of the layout editor.
The card now appears on every Deal record that uses this layout.
The same flow works for every object type
Repeat the steps above under Data Management → Objects → [Contacts | Companies | Tickets | your custom object]. Each object type has its own record customization tab; card placements are not shared across types.
Two gates: enabled in Debrief, added in HubSpot
Before the card actually renders on a record, both conditions must be true:
- The object type is enabled in Debrief, in Connected Apps → Debrief → Settings → Enabled object types. Standard types (Deal, Contact, Company, Ticket) are enabled by default; custom objects need explicit opt-in.
- The Debrief card has been added to the record layout for that object type (the flow above).
If the card isn't showing up, check both gates.
Your first handoff
Open any record that now has the Debrief card and click Draft Brief. You'll see a preview generated against the real record's data. From the preview you can confirm, adjust context, or run Handoff to atomically reassign ownership.
The first month of a new subscription includes a 2× credit bonus. Use it to stress-test Debrief against real handoffs before you commit to ongoing spend.
Was this article helpful?
Related articles
- DebriefHow a Debrief handoff worksStep by step, from opening a record to the log entry, what happens when you run Draft Brief or Handoff on a HubSpot CRM record.Read
- DebriefWhat is Debrief?Debrief writes a structured brief and a handoff message when a HubSpot CRM record changes owners, so the incoming rep inherits context, not just the record.Read