Skip to main content
WhiteWhale automatically finds contacts at your tracked accounts based on the job titles you care about. Contacts include verified email addresses and phone numbers so your team can act on signals immediately.
Contacts don’t cost any credits. You get contacts for every account you monitor at no extra cost.

Setting up contact titles

Your contact titles are configured in Settings → Contacts. WhiteWhale generates a default list when you create your account — you can edit it at any time.
Titles are ranked. The first title in your list is the one WhiteWhale looks for first, then the second, and so on. Put your most important buyer persona at the top.
Don’t worry about abbreviations or formatting. WhiteWhale automatically converts shorthand — VP becomes Vice President, CRO becomes Chief Revenue Officer — and checks both versions.

How contact matching works

WhiteWhale finds contacts in this order:
  1. Title match — looks for contacts whose job title matches one of your listed titles, the title does not have to be exact, if you input Director of IT, we will search ‘IT Director’ & ‘Director, IT’ & and other variations of the words.
  2. Headline match — after checking all listed titles, WhiteWhale also matches against LinkedIn headlines. This catches contacts whose headline describes their role differently than their formal title.
A contact is only included if at least one of email or phone is available. No contact data = no contact returned.

CRM Contacts

If you allow WhiteWhale to read contacts from your CRM, those contacts will be included alongside WhiteWhale-found contacts. CRM contacts include:
  • Last touch date from your CRM
  • Contact info already stored in your CRM
This is on by default for any accounts created and synced with a CRM after October 5th, 2026. You can toggle this on or off in Settings once your CRM is integrated.
WhiteWhale reads contact data from your CRM but does not write any contact data back. Your CRM contact records are never modified.

Editing your contact titles

You can add, remove, or reorder titles at any time in Settings → Contacts. When you edit the list:
  • Contacts that no longer match any title are deleted immediately
  • Remaining contacts are updated the next time WhiteWhale re-analyzes the account

Accessing contacts via the API

Contact data is available through the API at:
You must supply the account_id to get contacts back. This endpoint is also exposed via the MCP — so you can ask Claude “Show me the contacts at [company]” and it will pull them directly. See the API Reference for full endpoint details.

Using the Why Now Summary

Understand the signal story that Signal Contacts are connected to.

HubSpot

Connect your CRM to include CRM contacts alongside WhiteWhale contacts.

Salesforce

Connect Salesforce to pull in CRM contact data.

API Reference

Access contacts programmatically via /v1/get_account_contacts.