1
Create your account
Your purchase is tied to the email you used at checkout. Use that same email to create your account.
1
Go to mapyourcontacts.com/app
2
Click Create account — use the email from your purchase
3
Check your inbox for a confirmation email from
luke@mapyourcontacts.com and click the link4
Sign in — you're in your map
⚠ You must use the same email you purchased with. Need to use a different one? Email luke@mapyourcontacts.com and I'll update it.
2
Add contacts manually
Click + Add contact in the top right. Name and city are required — everything else is optional.
| Field | Required | Notes |
|---|---|---|
| Name | Required | Full name of the contact |
| City / Location | Required | Used to place the pin — see formats below |
| Company | Optional | Shows in hover tooltip and contact card |
| Optional | Clickable mailto link in contact card | |
| Phone | Optional | Clickable tel link in contact card |
| Status | Optional | Current client, Contact, or Churned |
| Notes | Optional | Freeform — shows in hover tooltip |
City format tips
Be specific — state or country helps the geocoder place the pin accurately.
Denver, CO
Colorado
Austin TX
TX
Manchester, NH
New Hampshire
London, UK
UK
321 Main St, Saint Paul MN
Toronto, Ontario
Full addresses work too. The geocoder automatically strips street numbers and extracts the city — so "321 Elm St Denver CO 80201" will pin correctly on Denver.
3
Import from CSV
Click Import CSV to upload a spreadsheet export from any CRM. The importer handles HubSpot, Salesforce, LinkedIn, and most other formats automatically.
Supported column names
| Field | Recognized column headers |
|---|---|
| name | Name, Full Name, Contact Name, First Name + Last Name |
| city | City, Location, Market, Territory, Metro, Region, Geography |
| company | Company, Organization, Account, Account Name, Employer |
| Email, Email Address, Primary Email, Work Email | |
| phone | Phone, Mobile, Cell, Work Phone, Direct Phone |
| status | Status, Stage, Lead Status, Lifecycle Stage, Rating |
| notes | Notes, Comments, Description, Summary, Bio |
Status values are normalized automatically
Closed Won / Active / Customer → Current client
Lead / Prospect / Hot / Warm → Contact
Closed Lost / Churned / Inactive → Churned
Large files? The importer handles up to 600+ contacts in a single upload using batch processing. You'll see a preview before anything is committed.
4
Connect Zapier
Zapier lets you automatically push contacts from your CRM into the map without manual CSV exports. Set it up once — it syncs automatically.
Your CRM
HubSpot, Salesforce,
Google Sheets, etc.
HubSpot, Salesforce,
Google Sheets, etc.
→
Zapier
6,000+ apps
6,000+ apps
→
Map Your
Contacts
Contacts
Setting up the Zap
1
Go to zapier.com and create a new Zap
2
Trigger: Choose your CRM → select "New Contact" or "New Row" event
3
Action: Search for Webhooks by Zapier → choose POST
4
URL:
https://mapyourcontacts.com/.netlify/functions/add-contact5
Payload type: JSON
6
Headers: Add
X-API-Key = your personal API key (see below)7
Data: Map name, city, company, email, phone, status, notes from your CRM fields
8
Test and publish — contacts will appear on your map automatically
Free Zapier plans check for new data every 15 minutes. Paid plans check every 1-2 minutes. Either works — set it up and forget it.
Data fields accepted
| Field | Required | Example |
|---|---|---|
| name | Required | Jane Smith |
| city | Required | Denver, CO |
| company | Optional | Acme Fitness |
| Optional | jane@acme.com | |
| phone | Optional | 720-555-0101 |
| status | Optional | client / contact / churned |
| notes | Optional | Met at conference 2025 |
5
Your API key
Your personal API key authenticates your Zapier connection and proves requests are coming from your account. Keep it private — don't share it publicly.
Your API key will look like this
API Key
mmc_live_xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
Your key is emailed to you after purchase. If you can't find it, email luke@mapyourcontacts.com with your purchase email and I'll resend it within a few hours.
Coming soon: API keys will be visible directly inside your account dashboard so you can access them anytime.
📍
Using the map
→
Hover any pin — see name, city, company, email, and notes instantly
→
Scroll to zoom — zoom into any region for a closer look. Counties appear at high zoom on the US map
→
Drag to pan — move around within each region panel
→
Reset zoom — click the ⟳ button on any region panel
→
Filter by status — click any item in the legend to show or hide that group
→
Contacts tab — search, view details, edit, or delete any contact
→
Export CSV — download all your contacts anytime. Your data is always yours
?
Troubleshooting
Contact not showing on the map ▼
The city wasn't recognized. Edit the contact and try a more specific format — "Denver, CO" or "London, UK". Full addresses also work. If the city still doesn't appear, it may be a smaller city that our geocoder doesn't have — it will attempt a live lookup via Nominatim automatically.
Can't create an account ▼
You must use the same email address you used when purchasing. If you need to use a different email, email luke@mapyourcontacts.com and I'll update your approved email within a few hours.
Page looks blank after refreshing ▼
Try opening the app in a private or incognito window. Some browser extensions (ad blockers) can interfere with the connection. If that works, add mapyourcontacts.com to your ad blocker's allowlist.
Zapier isn't syncing contacts ▼
Check that your API key in the Zap's X-API-Key header matches exactly. Free Zapier plans have a 15-minute polling delay — wait and check again. You can also trigger a manual run in Zapier to test immediately.
CSV import shows errors or skipped rows ▼
The importer requires Name and City columns. Rows missing either field are skipped. Check your column headers match the supported names listed above. Tab-separated files and BOM characters (Excel on Windows) are handled automatically.
Something else ▼
Reply to any email from luke@mapyourcontacts.com or email directly — I respond personally to every message, usually within a few hours.