FlowMeet API Documentation

Welcome to the FlowMeet API. This API allows you to programmatically submit leads from your own applications, websites, or CRMs directly into your FlowMeet workspace. It supports auto-enrichment, AI scoring, and automatic routing.

1Authentication

All API requests must be authenticated using your workspace API Key. You can find this key in your Dashboard Settings.

Header

x-api-key: YOUR_API_KEY

2Endpoints

POST/api/leads

Creates a new lead in your workspace. The lead will be automatically scored by AI and enriched if enabled.

Request Body

{
  "name": "John Doe",           // Required
  "email": "john@example.com",  // Required
  "company": "Tech Corp",       // Optional (Recommended for enrichment)
  "role": "CTO",                // Optional (Used for scoring)
  "region": "NA"                // Optional (NA, EMEA, APAC, LATAM)
}

Success Response (200 OK)

{
  "success": true,
  "qualified": true,
  "bookingUrl": "https://calendly.com/your-link",
  "lead": {
    "id": "lead_12345",
    "ai_score": 0.95,
    "status": "Qualified",
    ...
  }
}

3Errors

StatusDescription
400 Bad RequestMissing required fields (name or email).
401 UnauthorizedMissing or invalid API Key.
500 Server ErrorInternal system error.