For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
DashboardGet an API key
SetupCustomersOnboardingsWorkbenchAsk PiIntegrations
SetupCustomersOnboardingsWorkbenchAsk PiIntegrations
  • Customers
    • Overview
    • Add a customer
    • Edit customer details
    • Health score
    • At risk and churned
    • Add contacts
    • Manage contacts
    • Search customers
    • Tags and metadata
    • Customer history
LogoLogo
DashboardGet an API key
On this page
  • Add one Contact at a time
  • Add many at once
  • Auto-link from your CRM
  • What “primary” means in practice
  • The gotcha: domain mismatch breaks auto-link
  • Related
Customers

Add contacts

Get the humans on the customer side into the record so notifications route correctly.
|View as Markdown|Open in Claude|
Was this page helpful?
Previous

At risk and churned

Next

Manage contacts

Built with

A Contact is a person at a Customer. They have a name, email, title, and optional phone. One Contact per Customer can be marked primary, and that one gets the default Slack DM and email when an onboarding sends a notification. Add Contacts as soon as you know who’s driving the work on their side, because notification routing and the customer portal both depend on them.

Add one Contact at a time

  1. Open the Customer you want to add to.
  2. Click the Contacts tab.
  3. Click + Contact. A small inline form opens.
  4. Type Name and Email. Both required.
  5. Set Title if you have it. Pi uses titles to draft personalized emails and to summarize who’s on the account.
  6. Click Save. The contact appears in the tab list. The first contact you add is auto-promoted to primary; you can change that later.

Add many at once

If you have a list from a kickoff form or a CSV export, paste it in:

  1. Contacts tab > + Contact > Paste a list.
  2. Paste rows in the order name, email, title. One contact per line. Commas inside quoted strings work.
  3. Click Preview. Pivotal shows what it parsed and flags rows with invalid emails or missing names.
  4. Fix any flagged rows in the textarea, then click Add 7 contacts (or however many).

Auto-link from your CRM

When HubSpot is connected, Pivotal pulls any HubSpot contact whose company matches this customer’s domain and links them on every sync. You don’t have to add those contacts by hand. If a HubSpot contact lands here but shouldn’t, you can unlink them from the Contacts tab without deleting the HubSpot record.

What “primary” means in practice

The primary Contact is the default recipient for:

  • Phase-change emails fired by the onboarding
  • Customer-facing task assignments
  • The portal invite, if you send one

If you have not picked a primary, those emails go to the Customer’s owner (a CSM on your side) as a fallback, which is rarely what you want. Set a primary as soon as you’ve added the first contact.

The gotcha: domain mismatch breaks auto-link

CRM auto-link matches on the Customer’s domain exactly. If a HubSpot contact’s email is @acmecorp.io but the Customer’s domain is acme.com, the contact will not auto-link. Fix the domain on the Customer record, then run a manual sync from Integrations > HubSpot > Sync now.

Related

  • Manage contacts
  • Connect HubSpot
  • Notifications

Email help@pivotal.app with a screenshot of where you got stuck and the customer or onboarding id from the URL.