API Documentation

Complete guide to LeadFlow Manager's Zapier integration endpoints. Connect your lead management workflow with thousands of apps.

Pro Plan Required

These APIs are public but can only be accessed by users subscribed to our Professional plan.

Base URL

https://leadflowmanager.com/api

Authentication

Bearer Token

Authorization: Bearer ACCESS_TOKEN

GET

/zapier/new-leads

Retrieve new leads for Zapier integration with polling support

Description

This endpoint returns leads based on the user's access level and supports polling for new leads.

Query Parameters

limit

optional

integer

Maximum number of leads to return (default: 100, max: 100)

since

optional

ISO date string

Only return leads created after this timestamp (for polling)

Response Format

[
  {
    "id": "abc1234",
    "firstName": "John",
    "lastName": "Doe",
    "fullName": "John Doe",
    "phone1": "(234) 567-890",
    "phone2": "(098) 765-4321",
    "email": "[email protected]",
    "address": "123 Main St, City, State",
    "postalCode": "12345",
    "addressNotes": "Ring doorbell twice",
    "appointmentDateTime": "2024-12-15T14:00:00.000Z",
    "timeslot": "14:00",
    "statusValue": "APPOINTMENT",
    "status": {},
    "customFields": {},
    "images": ["https://example.com/image1.jpg"],
    "sameDay": false,
    "createdAt": "2024-12-15T10:30:00.000Z",
    "updatedAt": "2024-12-15T10:30:00.000Z",
    "companyName": "Solar Solutions Inc",
    "branchName": "Downtown Branch",
    "departmentName": "Sales Department",
    "zapier_trigger_id": "507f1f77bcf86cd799439011",
    "zapier_created_at": "2024-12-15T10:30:00.000Z"
  }
]

Response Codes

200Success - Returns array of leads

401Unauthorized - Invalid or missing access token

403Forbidden - Pro plan required

404Not Found - User not found in database

500Internal Server Error

Example Request

curl -X GET "https://leadflow.manager/api/zapier/new-leads?limit=50&since=2024-12-15T00:00:00.000Z" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json"

Rate Limits

• 100 requests per minute per user
• 1000 requests per hour per user
• Maximum 100 leads per request
• Recommended to poll every 2 minutes

Best Practices

• Use the since parameter for polling
• Store zapier_trigger_id for deduplication
• Handle rate limit responses gracefully
• Validate Pro plan access before integration