For developers

Send us a lead.

One POST, one header, one required field. Field names match Leadrat's, so anything already pushing there can be re-pointed without rewriting the payload.

The request

Replace your-workspace with your address, and source-name with anything you like — website, 99acres, zapier. The source appears in your CRM by itself the first time it is used.

POST https://api.tavcogrowth.com/ingest/your-workspace/source-name
API-Key: tvc_your_key_here
Content-Type: application/json

{
  "mobile": "9876543210",
  "name": "Aarav Mehta",
  "email": "aarav@example.com",
  "city": "Mumbai",
  "location": "Andheri West",
  "project": "Lakeview Heights",
  "bhkType": "2 BHK"
}

Create a key on the Sources screen inside your workspace. It is shown once, so copy it then.

Fields

Field	Also accepts	What it is
mobilerequired	phone	At least 10 digits after punctuation is stripped. Anything shorter is refused.
name	—	The buyer's name.
email	—	Optional.
city	—	Optional.
location	—	Locality or area within the city.
project	property	The project they enquired about.
bhkType	propertyType	2 BHK, 3 BHK, plot, and so on.
subsource	sub_source	Defaults to the source name in the URL.

Anything else you send is kept with the lead and shown on its page.

What comes back

{ "succeeded": true, "message": null }

If the same person has enquired before, we merge rather than create a second record, and say so — so a portal that resends cannot quietly fill your CRM with duplicates:

{ "succeeded": true, "message": "merged into existing lead" }

When it refuses

400The number has fewer than 10 digits. We would rather refuse than store a lead nobody can ring.
401Missing, wrong, or revoked API key.
404That workspace address does not exist.
429Too many requests on one key. Slow down and retry.

Moving from Leadrat or Zoho? Your existing exports import as they are, including Zoho's Social Lead ID — so leads keep the ID their ad gave them and your Meta attribution survives the move. We'll do the migration with you.