Create Lead or Booking

curl --request POST \
  --url https://v2.flabs.in/client/crm/lead/create \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "branchID": "6530a4a6f1d2c8b7e9a12345",
  "integratorID": "EXT-LEAD-10231",
  "phase": "lead",
  "first_name": "Rahul",
  "last_name": "Sharma",
  "contact": "9876543210",
  "country_code": "91",
  "email": "rahul@example.com",
  "age": 32,
  "age_type": "year",
  "gender": "male",
  "address": "42 Park Street",
  "pincode": "560001",
  "source": "facebook_ads",
  "priority": "high",
  "tests": [
    {
      "test": "6530a4a6f1d2c8b7e9aabcde",
      "cost": 350
    }
  ],
  "packages": [
    {
      "package": "6530a4a6f1d2c8b7e9afedcb",
      "price": 1499
    }
  ],
  "unmappedTests": [
    {
      "name": "Vitamin D3 (custom name)",
      "cost": 800
    }
  ],
  "unmappedPackages": [
    {
      "name": "Bridal Glow Panel",
      "price": 2500
    }
  ],
  "discountAmount": 100,
  "totalAmount": 4549
}
'

{
  "success": true,
  "leadId": "6530a4a6f1d2c8b7e9a54321",
  "phase": "lead",
  "message": "Lead created successfully"
}

{
  "success": false,
  "status": 400,
  "message": "Bad Request",
  "error": {
    "details": "first_name is required"
  }
}

{
  "success": false,
  "status": 403,
  "message": "Forbidden",
  "error": {
    "details": "branchID does not belong to your account"
  }
}

{
  "success": false,
  "status": 409,
  "message": "Conflict",
  "error": {
    "details": "Lead with contact 9876543210 already exists today"
  }
}

{
  "success": false,
  "status": 500,
  "message": "Internal Server Error",
  "error": {
    "details": "An unexpected error occurred"
  }
}

POST

client

crm

lead

create

curl --request POST \
  --url https://v2.flabs.in/client/crm/lead/create \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "branchID": "6530a4a6f1d2c8b7e9a12345",
  "integratorID": "EXT-LEAD-10231",
  "phase": "lead",
  "first_name": "Rahul",
  "last_name": "Sharma",
  "contact": "9876543210",
  "country_code": "91",
  "email": "rahul@example.com",
  "age": 32,
  "age_type": "year",
  "gender": "male",
  "address": "42 Park Street",
  "pincode": "560001",
  "source": "facebook_ads",
  "priority": "high",
  "tests": [
    {
      "test": "6530a4a6f1d2c8b7e9aabcde",
      "cost": 350
    }
  ],
  "packages": [
    {
      "package": "6530a4a6f1d2c8b7e9afedcb",
      "price": 1499
    }
  ],
  "unmappedTests": [
    {
      "name": "Vitamin D3 (custom name)",
      "cost": 800
    }
  ],
  "unmappedPackages": [
    {
      "name": "Bridal Glow Panel",
      "price": 2500
    }
  ],
  "discountAmount": 100,
  "totalAmount": 4549
}
'

{
  "success": true,
  "leadId": "6530a4a6f1d2c8b7e9a54321",
  "phase": "lead",
  "message": "Lead created successfully"
}

{
  "success": false,
  "status": 400,
  "message": "Bad Request",
  "error": {
    "details": "first_name is required"
  }
}

{
  "success": false,
  "status": 403,
  "message": "Forbidden",
  "error": {
    "details": "branchID does not belong to your account"
  }
}

{
  "success": false,
  "status": 409,
  "message": "Conflict",
  "error": {
    "details": "Lead with contact 9876543210 already exists today"
  }
}

{
  "success": false,
  "status": 500,
  "message": "Internal Server Error",
  "error": {
    "details": "An unexpected error occurred"
  }
}

Authorizations

Authorization

string

header

required

JWT obtained from POST /client/auth/token.

Body

application/json

branchID

string

required

Branch identifier returned by GET /client/labs.

integratorID

string

required

Your own unique ID for this lead/booking. Required. It is stored on the entry, carried onto the bill when it converts, and echoed back in webhook payloads so you can correlate events with your records.

first_name

string

required

contact

string

required

Exactly 10 digits, no symbols or spaces.

age

number

required

age_type

enum<string>

required

Available options:

year,

month,

day

corporateUser

string

Corporate this entry belongs to. Party-scoped accounts must attach a party (any one of corporateUser, referredOrganization, referredHospitalOrganization).

referredOrganization

string

Referring doctor (organization) identifier. Party-scoped accounts must attach a party.

referredHospitalOrganization

string

Referring hospital (organization) identifier. Party-scoped accounts must attach a party.

phase

enum<string>

default:lead

lead enters the funnel and is auto-assigned. booking skips the funnel and creates a confirmed booking.

Available options:

lead,

booking

designation

string

Mr / Mrs / Dr / etc.

last_name

string

country_code

string

default:91

string<email>

gender

enum<string>

Available options:

male,

female,

other

weight

number

In kilograms.

height

number

In centimetres.

address

string

pincode

string

googleLocation

string

Free-form location string, e.g. "12.97,77.59" or a Google Maps URL.

aadhaar_number

string

insurance_number

string

uhid

string

passport_number

string

owner_name

string

Veterinary only — pet owner's name.

breed

string

Veterinary only — pet breed.

Response

Lead or booking created

success

boolean

Example:

true

leadId

string

Identifier of the newly created CRM entry.

phase

enum<string>

Available options:

lead,

booking

message

string

Flabs Developer API guide

Authorization

Webhooks

Billing

Patient Reports

CRM

Authorizations

Body

Response