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.
How contact matching works
WhiteWhale finds contacts in this order:- 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.
- 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.
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
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: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.
Related
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.

