Skip to content
Home
ContractorsPlumbing, HVAC, roofing, electrical and every other home serviceRestaurantsRestaurants, cafes and coffee shopsEducationPrivate schools, tutoring centers, preschools and education startupsSalons and barbersHair salons, barbershops, nail and beauty studiosAuto repairRepair shops, tire and brake shops, body shops and mobile mechanicsOther businessesClinics, gyms, studios, shops and any small business people call
A website we build and runLocal Google search setupMissed call text backFollow-up texts for new inquiriesBooking calendarGoogle review requestsText campaignsAll servicesHow-to guides
How it worksPricing
AboutOur workFAQProofSmall business tipsContact
App loginBook a 20 minute call
App login

Who it's for

ContractorsRestaurantsEducationSalons and barbersAuto repairOther businesses

Services

A website we build and runLocal Google search setupMissed call text backFollow-up texts for new inquiriesBooking calendarGoogle review requestsText campaignsHow-to guides

More

HomeHow it worksPricingAboutOur workFAQProofSmall business tipsContact
App loginBook a 20 minute call

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 409 with a retry_after time.
  • 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.

More jobs from the calls you already miss. Missed callers get a text back in seconds, and every call, text and website message lands in one app on your phone. For small businesses in every industry.

Book a 20 minute call

Tools we use: Twilio, WordPress, Cloudflare, Cal.com, Google Business Profile, Search Console, n8n, Canva and Claude.

Who it's for
Contractors

Roofing, Plumbing, Electrical, HVAC, Landscaping

RestaurantsEducationSalons and barbersAuto repairOther businesses
What you get
All seven servicesA website we build and runLocal Google search setupMissed call text backFollow-up texts for new inquiriesBooking calendarGoogle review requestsText campaignsEverything in the price
Company
How it worksPricingQuestions and answersQuestions owners askSmall business tipsMissed call cost calculatorMissed call statisticsMissed call text templatesOur workShort videosProofAboutContactApp login

© 2026 Top Crew Systems, a service of EmpowerU Marketing LLC. [email protected]. Privacy policy, Terms of service, Text message terms, Text message sign-up and API. Your Google Business Profile is free from Google and stays yours. We follow Google's rules for working with a third party.