Top Crew Systems API
The Top Crew Systems API lets Zapier and your own tools see your new leads, missed calls and customer messages, and send a text to a customer who already texted or called you. Every request uses HTTPS and returns JSON.
Base address: https://app.topcrewsystems.com/api/v1
Get an API key
Sign in to the Top Crew Systems app, open Settings, scroll to API keys and tap Make a new key. Copy the key right away: it starts with tcs_live_ and is shown only once. You can revoke a key there at any time, and it stops working at once.
A key belongs to one business. It can only see and text that business's own customers.
Send the key with every request
Authorization: Bearer tcs_live_your_key_here
A missing, wrong or revoked key gets 401. More than 120 requests a minute on one key gets 429.
Check a key
GET /me returns the business the key belongs to.
curl -H "Authorization: Bearer $KEY" https://app.topcrewsystems.com/api/v1/me
{"account": {"name": "Your Business", "slug": "your-business", "business_number": "+12175550100"},
"key": {"name": "Zapier"}, "user": {"name": "Sam Owner", "email": "[email protected]"}}
New leads
GET /leads lists your newest customers first: everyone who reached you by call, text, website form, chat, email, Facebook or Instagram. Add ?limit= from 1 to 100 (25 by default).
[{"id": "6f1c2a9e-...", "name": "Dana Smith", "phone": "+12175550123", "email": "[email protected]",
"address": "12 Oak St, Springfield, IL 62701", "source": "web-form", "channel": "sms",
"note": "Water heater leaking", "created_at": "2026-11-11T15:04:05.000Z",
"app_url": "https://app.topcrewsystems.com/c/6f1c2a9e-..."}]
phone is empty for someone who only wrote by website chat, email, Facebook or Instagram. channel says which: sms, website, email, facebook or instagram.
New missed calls
GET /calls/missed lists calls to your business number that nobody answered, newest first. outcome is missed, no-answer or voicemail.
[{"id": "2b7e1d3c-...", "contact_id": "6f1c2a9e-...", "name": "Dana Smith", "phone": "+12175550123",
"outcome": "missed", "started_at": "2026-11-11T15:00:00.000Z", "ended_at": "2026-11-11T15:00:24.000Z",
"duration_s": 24, "left_voicemail": false, "app_url": "https://app.topcrewsystems.com/c/6f1c2a9e-..."}]
New customer messages
GET /messages/inbound lists texts and messages customers sent you, newest first.
[{"id": "9a8b7c6d-...", "contact_id": "6f1c2a9e-...", "name": "Dana Smith", "phone": "+12175550123",
"channel": "sms", "body": "Yes, tomorrow morning works.", "has_attachment": false,
"created_at": "2026-11-11T15:10:00.000Z", "app_url": "https://app.topcrewsystems.com/c/6f1c2a9e-..."}]
Send a text
POST /texts texts one of your customers from your business number.
curl -X POST https://app.topcrewsystems.com/api/v1/texts -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
-d '{"phone": "+12175550123", "body": "Thanks Dana, we will be there at 9.", "request_id": "c3d4e5f6-a7b8-4c9d-8e0f-1a2b3c4d5e6f"}'
{"ok": true, "id": "b1c2d3e4-...", "status": "queued", "error": null, "retryable": false,
"contact_id": "6f1c2a9e-...", "request_id": "c3d4e5f6-a7b8-4c9d-8e0f-1a2b3c4d5e6f"}
Send contact_id or phone, and body (up to 1,400 characters). request_id is optional but recommended: a UUID you make, so a retry with the same id never sends twice.
These texts follow the texting rules for you:
- Only customers who already texted, called, booked or sent your website form can be texted. Never a new number.
- Use it for the customer's own job: replies, confirmations, updates. Never for offers or promotions.
- Anyone who replied STOP, and any number you blocked, is never texted.
- No texts from 8pm to 8am, in your time zone or the customer's. The answer is
409with aretry_aftertime. - After two texts sent this way with no reply from the customer, more need their agreement to offers.
- The first text to a customer starts with your business name and ends with "Reply STOP to opt out".
- Links only to your own website. No texts about banned topics, and no ALL CAPITALS.
- At most 3 a day to one customer, 30 an hour and 200 a day for your business.
- Your business number must be approved by the phone carriers first.
Answers and errors
200 sent. 202 handed to the carrier but not confirmed yet: check the conversation before sending again. 400 something in the request is wrong. 401 bad key. 404 no such customer. 409 a texting rule stopped it (the error says which). 429 a limit was reached. 502 the carrier refused it.
Every error is JSON: {"error": "What went wrong, in plain words."}
Zapier
Our Zapier integration uses this API: three triggers (New Lead, New Missed Call, New Incoming Message) and one action (Send Text Message). Connect it with an API key from Settings.
Help
Email [email protected]. A real person answers.