For developers
REST API, scheduled matches, and Zapier — automate the match pipeline.
The Genie exposes every pipeline stage through a REST API, runs matches on a recurring schedule, and plugs into 6,000+ apps via Zapier. Programmatic CRM matching without building your own ETL.
/v1
Versioned REST API
20 / 10s
Rate limit per key
50
Active schedules (Business)
6,000+
Apps via Zapier
What ships today
Three ways to run the Genie without clicking.
Pick one or stack all three. The API is the foundation; schedules and Zapier sit on top of it.
REST API
Every pipeline stage, exposed as JSON.
The Genie ships a versioned REST API at /api/v1. Upload files, queue match jobs, poll status, fetch reports, and pull formatted exports — everything the web app does, the API can do.
- Endpoints: /files, /jobs, /profiles, /reports, /schedules, /whoami
- Bearer-token auth — API keys live under Account → API keys in the app
- Full OpenAPI 3 spec at /api/v1/openapi.json
- Rate limit: 20 requests / 10 seconds per key
- JSON in, JSON out — no SDK required, curl works fine
Scheduled matches
Recurring jobs, timezone-aware.
Tell the Genie to match a source file against a master file on a daily, weekly, biweekly, or monthly cadence. The match runs automatically on your schedule; results land in the app and fire your Zapier trigger when done.
- Cadences: daily, weekly, biweekly, monthly
- Timezone-aware — specify the zone once, the Genie handles DST
- Up to 50 active schedules on the Business tier
- Paired with a stable master file, a schedule keeps your CRM deduped forever
- Create and manage in the app at /schedules; list via GET /api/v1/schedules
Zapier integration
No-code automation into 6,000+ apps.
The Genie is a Zapier app. Hook the 'New Completed Match' trigger into Slack, HubSpot, Salesforce, Airtable, or Google Sheets. Let a Zap queue new matches from a form submission, a new Typeform entry, or a scheduled Google Sheets export.
- Trigger: New Completed Match — counts, rates, narrative summary, report link
- Action: Create Match Job — dynamic dropdowns for source, master, and profile
- Uses the same API key as direct API calls — one integration path, one auth surface
- Private beta today — invite-only until the public marketplace listing
Quick start
Three curls to first match.
Issue a key in the app, then point your shell at app.listmatchgenie.com/api/v1. The Genie does the rest.
Who am I?
bashcurl https://app.listmatchgenie.com/api/v1/whoami \ -H "Authorization: Bearer $LMG_API_KEY"
Queue a match
bashcurl -X POST https://app.listmatchgenie.com/api/v1/jobs \
-H "Authorization: Bearer $LMG_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"sourceFileId": "file_01H...",
"masterFileId": "file_02H...",
"profileId": "profile_01H...",
"matchMode": "best_match"
}'Pull the PDF report
bashcurl "https://app.listmatchgenie.com/api/v1/reports/${REPORT_ID}/export?format=pdf" \
-H "Authorization: Bearer $LMG_API_KEY" \
--output match-report.pdfFull Python and TypeScript examples — see the API reference.
Good fits
Who uses the API.
Ops teams automating CRM hygiene
Nightly schedule matches this morning's HubSpot export against the Salesforce master. Results fire a Zapier trigger that posts the match rate to #rev-ops. No analyst required.
Data engineers in an ETL pipeline
Airflow task uploads the day's delta, queues a match, polls until done, pulls the result CSV, and loads the joined output into the warehouse. The API is designed for this flow.
Consultants automating client deliverables
Script pulls the white-labeled PDF for each client and emails it out on the first of the month. Same matching engine, none of the copy-paste.
API reference
Every endpoint, every field, Python + TypeScript examples, and the full end-to-end flow.
Zapier setup guide
Example Zaps — Slack alerts, HubSpot updates, CRM dedup on a schedule. Private beta access today.
Dedup on a schedule
Walkthrough of the deduplication flow — pair it with a recurring schedule to keep your CRM clean automatically.
API keys & billing
How to issue, rotate, and revoke API keys, plus which tier unlocks which automation features.
FAQ
Developer questions
Let the Genie handle the grunt work.
Free tier is real. No card. No forms. Just upload your first list and see the Genie clean and match it in under a minute.
