Approve a lead | JazzHQ AI

{
  "success": true,
  "message": "LEAD_APPROVE_SUCCESSFUL",
  "data": {
    "lead": {
      "id": 300,
      "partnerId": 1001,
      "firstName": "Jane",
      "lastName": "Doe",
      "emailAddress": "jane@acme.com",
      "phoneNumber": "string",
      "linkedInUrl": "string",
      "companyName": "Acme Inc",
      "websiteUrl": "string",
      "companySize": "50-100",
      "industry": "string",
      "jobTitle": "VP Sales",
      "city": "string",
      "state": "string",
      "country": "string",
      "source": 1,
      "status": 1,
      "leadAge": 1,
      "productsInterested": "string",
      "businessImpactMetrics": "string",
      "externalId": "string",
      "approvalStatus": "PENDING",
      "rejectReason": "string",
      "rejectComment": "string",
      "lastActiveAt": "2024-01-15T09:30:00Z",
      "submittedByType": "PARTNER_USER",
      "isDuplicate": true,
      "archived": true,
      "createdAt": "2024-01-15T09:30:00Z",
      "updatedAt": "2024-01-15T09:30:00Z"
    },
    "contactId": 500
  },
  "timestamp": "2024-01-15T09:30:00Z"
}

Approves the lead and converts it into a contact, returning both.

Safe to retry: approving an already-approved lead returns the same contact rather than creating another. A rejected lead cannot be approved.

Authentication

X-API-KEYstring

Your vendor API key. Required on every request under /api/v1/vendors/**.

Path parameters

leadIdlongRequired

ID of the lead.

Response

Lead approved successfully.

successbooleanOptional

messagestringOptional

dataobjectOptional

timestampdatetimeOptional

Errors

401

Unauthorized Error

404

Not Found Error

409

Conflict Error

500

Internal Server Error