Leads

Create a new lead

Creates a customer and work item (and an address when one is supplied) in one call, linked together automatically. Address is optional: lead sources like Meta/Facebook Lead Ads collect only name/email/phone, so a lead with no street/postalCode/city is created address-less. Photos are optional: pass publicly downloadable https URLs in photoUrls (max 10) and they are downloaded and attached to the lead as assets. Photo ingestion is best-effort — failures never fail the lead and are reported per URL in the photos field of the response. Customers are deduplicated: when a non-archived customer in the brand matches the submitted email (case-insensitive) or phone (last 9 digits), the lead is attached to that customer instead of creating a duplicate. On email matches, a missing phone/address on the existing record is backfilled and noted on the lead; phone-matched records are never modified (the submitted email did not match, so it is not trusted).

POST

api

leads

Create a new lead

curl --request POST \
  --url https://api.flixerpro.io/v1/api/leads \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "customerName": "Jan de Vries",
  "title": "Lekkage badkamer",
  "street": "Keizersgracht",
  "streetNumber": "123",
  "streetNumberAddition": "A",
  "postalCode": "1015 CJ",
  "city": "Amsterdam",
  "country": "Nederland",
  "firstName": "Jan",
  "lastName": "de Vries",
  "email": "[email protected]",
  "phone": "+31612345678",
  "companyName": "Installatiebedrijf De Vries B.V.",
  "description": "Klant meldt waterschade aan het plafond",
  "category": "Loodgieter",
  "priority": "medium",
  "budgetQuote": "€500 - €1000",
  "notes": "Graag zo snel mogelijk contact opnemen",
  "photoUrls": [
    "https://api.widget.flixerpro.io/v1/image/b91aca1e.jpeg"
  ]
}
'

import requests

url = "https://api.flixerpro.io/v1/api/leads"

payload = {
    "customerName": "Jan de Vries",
    "title": "Lekkage badkamer",
    "street": "Keizersgracht",
    "streetNumber": "123",
    "streetNumberAddition": "A",
    "postalCode": "1015 CJ",
    "city": "Amsterdam",
    "country": "Nederland",
    "firstName": "Jan",
    "lastName": "de Vries",
    "email": "[email protected]",
    "phone": "+31612345678",
    "companyName": "Installatiebedrijf De Vries B.V.",
    "description": "Klant meldt waterschade aan het plafond",
    "category": "Loodgieter",
    "priority": "medium",
    "budgetQuote": "€500 - €1000",
    "notes": "Graag zo snel mogelijk contact opnemen",
    "photoUrls": ["https://api.widget.flixerpro.io/v1/image/b91aca1e.jpeg"]
}
headers = {
    "X-API-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    customerName: 'Jan de Vries',
    title: 'Lekkage badkamer',
    street: 'Keizersgracht',
    streetNumber: '123',
    streetNumberAddition: 'A',
    postalCode: '1015 CJ',
    city: 'Amsterdam',
    country: 'Nederland',
    firstName: 'Jan',
    lastName: 'de Vries',
    email: '[email protected]',
    phone: '+31612345678',
    companyName: 'Installatiebedrijf De Vries B.V.',
    description: 'Klant meldt waterschade aan het plafond',
    category: 'Loodgieter',
    priority: 'medium',
    budgetQuote: '€500 - €1000',
    notes: 'Graag zo snel mogelijk contact opnemen',
    photoUrls: ['https://api.widget.flixerpro.io/v1/image/b91aca1e.jpeg']
  })
};

fetch('https://api.flixerpro.io/v1/api/leads', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.flixerpro.io/v1/api/leads",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'customerName' => 'Jan de Vries',
    'title' => 'Lekkage badkamer',
    'street' => 'Keizersgracht',
    'streetNumber' => '123',
    'streetNumberAddition' => 'A',
    'postalCode' => '1015 CJ',
    'city' => 'Amsterdam',
    'country' => 'Nederland',
    'firstName' => 'Jan',
    'lastName' => 'de Vries',
    'email' => '[email protected]',
    'phone' => '+31612345678',
    'companyName' => 'Installatiebedrijf De Vries B.V.',
    'description' => 'Klant meldt waterschade aan het plafond',
    'category' => 'Loodgieter',
    'priority' => 'medium',
    'budgetQuote' => '€500 - €1000',
    'notes' => 'Graag zo snel mogelijk contact opnemen',
    'photoUrls' => [
        'https://api.widget.flixerpro.io/v1/image/b91aca1e.jpeg'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.flixerpro.io/v1/api/leads"

	payload := strings.NewReader("{\n  \"customerName\": \"Jan de Vries\",\n  \"title\": \"Lekkage badkamer\",\n  \"street\": \"Keizersgracht\",\n  \"streetNumber\": \"123\",\n  \"streetNumberAddition\": \"A\",\n  \"postalCode\": \"1015 CJ\",\n  \"city\": \"Amsterdam\",\n  \"country\": \"Nederland\",\n  \"firstName\": \"Jan\",\n  \"lastName\": \"de Vries\",\n  \"email\": \"[email protected]\",\n  \"phone\": \"+31612345678\",\n  \"companyName\": \"Installatiebedrijf De Vries B.V.\",\n  \"description\": \"Klant meldt waterschade aan het plafond\",\n  \"category\": \"Loodgieter\",\n  \"priority\": \"medium\",\n  \"budgetQuote\": \"€500 - €1000\",\n  \"notes\": \"Graag zo snel mogelijk contact opnemen\",\n  \"photoUrls\": [\n    \"https://api.widget.flixerpro.io/v1/image/b91aca1e.jpeg\"\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-API-Key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.flixerpro.io/v1/api/leads")
  .header("X-API-Key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"customerName\": \"Jan de Vries\",\n  \"title\": \"Lekkage badkamer\",\n  \"street\": \"Keizersgracht\",\n  \"streetNumber\": \"123\",\n  \"streetNumberAddition\": \"A\",\n  \"postalCode\": \"1015 CJ\",\n  \"city\": \"Amsterdam\",\n  \"country\": \"Nederland\",\n  \"firstName\": \"Jan\",\n  \"lastName\": \"de Vries\",\n  \"email\": \"[email protected]\",\n  \"phone\": \"+31612345678\",\n  \"companyName\": \"Installatiebedrijf De Vries B.V.\",\n  \"description\": \"Klant meldt waterschade aan het plafond\",\n  \"category\": \"Loodgieter\",\n  \"priority\": \"medium\",\n  \"budgetQuote\": \"€500 - €1000\",\n  \"notes\": \"Graag zo snel mogelijk contact opnemen\",\n  \"photoUrls\": [\n    \"https://api.widget.flixerpro.io/v1/image/b91aca1e.jpeg\"\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.flixerpro.io/v1/api/leads")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"customerName\": \"Jan de Vries\",\n  \"title\": \"Lekkage badkamer\",\n  \"street\": \"Keizersgracht\",\n  \"streetNumber\": \"123\",\n  \"streetNumberAddition\": \"A\",\n  \"postalCode\": \"1015 CJ\",\n  \"city\": \"Amsterdam\",\n  \"country\": \"Nederland\",\n  \"firstName\": \"Jan\",\n  \"lastName\": \"de Vries\",\n  \"email\": \"[email protected]\",\n  \"phone\": \"+31612345678\",\n  \"companyName\": \"Installatiebedrijf De Vries B.V.\",\n  \"description\": \"Klant meldt waterschade aan het plafond\",\n  \"category\": \"Loodgieter\",\n  \"priority\": \"medium\",\n  \"budgetQuote\": \"€500 - €1000\",\n  \"notes\": \"Graag zo snel mogelijk contact opnemen\",\n  \"photoUrls\": [\n    \"https://api.widget.flixerpro.io/v1/image/b91aca1e.jpeg\"\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "createdAt": "2026-06-17T10:30:45.000Z",
  "updatedAt": "2026-06-17T10:30:45.000Z",
  "createdBy": null,
  "updatedBy": null,
  "deletedAt": null,
  "archivedAt": null,
  "id": "WKIabc123def456ghi789jkl",
  "brandId": "BRDabc123def456ghi789jkl",
  "customerId": "CUSabc123def456ghi789jkl",
  "title": "Lekkage badkamer",
  "description": "Klant meldt waterschade aan het plafond",
  "status": "request",
  "priority": "medium",
  "category": "Loodgieter",
  "customerSignature": null,
  "scheduledStart": null,
  "scheduledEnd": null,
  "actualStart": null,
  "actualEnd": null,
  "source": "web",
  "receivedAt": "2026-06-17T10:30:45.000Z",
  "addressId": "ADRabc123def456ghi789jkl",
  "customStatusId": null,
  "estimatedCost": null,
  "finalCost": null,
  "budgetQuote": "€500 - €1000",
  "notes": null,
  "completionNotes": null,
  "tags": null,
  "customer": {
    "createdAt": "2026-06-17T10:30:45.000Z",
    "updatedAt": "2026-06-17T10:30:45.000Z",
    "createdBy": null,
    "updatedBy": null,
    "deletedAt": null,
    "archivedAt": null,
    "id": "CUSabc123def456ghi789jkl",
    "brandId": "BRDabc123def456ghi789jkl",
    "name": "Jan de Vries",
    "firstName": "Jan",
    "lastName": "de Vries",
    "email": "[email protected]",
    "phone": "+31612345678",
    "secondaryPhone": null,
    "companyName": "Installatiebedrijf De Vries B.V.",
    "isCompany": false,
    "status": "active",
    "addressId": "ADRabc123def456ghi789jkl",
    "notes": null,
    "tags": null
  },
  "address": {
    "id": "ADRabc123def456ghi789jkl",
    "brandId": "BRDabc123def456ghi789jkl",
    "country": "Nederland",
    "stateProvince": null,
    "city": "Amsterdam",
    "postalCode": "1015 CJ",
    "street": "Keizersgracht",
    "streetNumber": "123",
    "streetNumberAddition": "A",
    "latitude": 52.3676,
    "longitude": 4.9041,
    "locationNotes": null
  },
  "photos": [
    {
      "url": "https://api.widget.flixerpro.io/v1/image/b91aca1e.jpeg",
      "status": "attached",
      "assetId": "ASTabc123def456ghi789jkl",
      "reason": "Download failed with status 404"
    }
  ]
}

{
  "statusCode": 400,
  "message": "customerName is required",
  "error": "Bad Request"
}

{
  "statusCode": 400,
  "message": "customerName is required",
  "error": "Bad Request"
}

{
  "statusCode": 400,
  "message": "customerName is required",
  "error": "Bad Request"
}

Authorizations

X-API-Key

string

header

required

Body

application/json

customerName

string

required

Full display name

Example:

"Jan de Vries"

title

string

required

Example:

"Lekkage badkamer"

street

string

Example:

"Keizersgracht"

streetNumber

string

Example:

"123"

streetNumberAddition

string

Example:

"A"

postalCode

string

Example:

"1015 CJ"

city

string

Example:

"Amsterdam"

country

string

Example:

"Nederland"

firstName

string

Example:

"Jan"

lastName

string

Example:

"de Vries"

string

Example:

"[email protected]"

phone

string

Example:

"+31612345678"

companyName

string

Example:

"Installatiebedrijf De Vries B.V."

description

string

Example:

"Klant meldt waterschade aan het plafond"

Response

createdAt

string<date-time>

required

Example:

"2026-06-17T10:30:45.000Z"

updatedAt

string<date-time>

required

Example:

"2026-06-17T10:30:45.000Z"

createdBy

string | null

required

Brand member who created the record, or null when created by the system (e.g. a lead created through the public API).

Example:

null

updatedBy

string | null

required

Example:

null

deletedAt

string<date-time> | null

required

Example:

null

archivedAt

string<date-time> | null

required

Example:

null

string

required

Example:

"WKIabc123def456ghi789jkl"

brandId

string

required

Example:

"BRDabc123def456ghi789jkl"

customerId

string

required

Example:

"CUSabc123def456ghi789jkl"

title

string

required

Example:

"Lekkage badkamer"

description

string

required

Example:

"Klant meldt waterschade aan het plafond"

status

enum<string>

required

Lead-phase statuses (request, contacted, quote_sent, inspection, lost) are returned by GET /leads; job-phase statuses (pending, scheduled, in_progress, completed, cancelled) by GET /work-items.

Available options:

request,

contacted,

quote_sent,

inspection,

lost,

pending,

scheduled,

in_progress,

completed,

cancelled

Example:

"request"

priority

enum<string>

required

Available options:

low,

medium,

high,

urgent

Example:

"medium"

tags

string[] | null

required

Example:

null

customer

object

Populated in the list endpoints (GET /leads, GET /work-items).

Show child attributes

address

object | null

Populated in the list endpoints; null when the lead is address-less.

Show child attributes

photos

object[]

Present only when photoUrls were supplied. One entry per URL, in order.

Show child attributes

Create a new lead

curl --request POST \
  --url https://api.flixerpro.io/v1/api/leads \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "customerName": "Jan de Vries",
  "title": "Lekkage badkamer",
  "street": "Keizersgracht",
  "streetNumber": "123",
  "streetNumberAddition": "A",
  "postalCode": "1015 CJ",
  "city": "Amsterdam",
  "country": "Nederland",
  "firstName": "Jan",
  "lastName": "de Vries",
  "email": "[email protected]",
  "phone": "+31612345678",
  "companyName": "Installatiebedrijf De Vries B.V.",
  "description": "Klant meldt waterschade aan het plafond",
  "category": "Loodgieter",
  "priority": "medium",
  "budgetQuote": "€500 - €1000",
  "notes": "Graag zo snel mogelijk contact opnemen",
  "photoUrls": [
    "https://api.widget.flixerpro.io/v1/image/b91aca1e.jpeg"
  ]
}
'

import requests

url = "https://api.flixerpro.io/v1/api/leads"

payload = {
    "customerName": "Jan de Vries",
    "title": "Lekkage badkamer",
    "street": "Keizersgracht",
    "streetNumber": "123",
    "streetNumberAddition": "A",
    "postalCode": "1015 CJ",
    "city": "Amsterdam",
    "country": "Nederland",
    "firstName": "Jan",
    "lastName": "de Vries",
    "email": "[email protected]",
    "phone": "+31612345678",
    "companyName": "Installatiebedrijf De Vries B.V.",
    "description": "Klant meldt waterschade aan het plafond",
    "category": "Loodgieter",
    "priority": "medium",
    "budgetQuote": "€500 - €1000",
    "notes": "Graag zo snel mogelijk contact opnemen",
    "photoUrls": ["https://api.widget.flixerpro.io/v1/image/b91aca1e.jpeg"]
}
headers = {
    "X-API-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    customerName: 'Jan de Vries',
    title: 'Lekkage badkamer',
    street: 'Keizersgracht',
    streetNumber: '123',
    streetNumberAddition: 'A',
    postalCode: '1015 CJ',
    city: 'Amsterdam',
    country: 'Nederland',
    firstName: 'Jan',
    lastName: 'de Vries',
    email: '[email protected]',
    phone: '+31612345678',
    companyName: 'Installatiebedrijf De Vries B.V.',
    description: 'Klant meldt waterschade aan het plafond',
    category: 'Loodgieter',
    priority: 'medium',
    budgetQuote: '€500 - €1000',
    notes: 'Graag zo snel mogelijk contact opnemen',
    photoUrls: ['https://api.widget.flixerpro.io/v1/image/b91aca1e.jpeg']
  })
};

fetch('https://api.flixerpro.io/v1/api/leads', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.flixerpro.io/v1/api/leads",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'customerName' => 'Jan de Vries',
    'title' => 'Lekkage badkamer',
    'street' => 'Keizersgracht',
    'streetNumber' => '123',
    'streetNumberAddition' => 'A',
    'postalCode' => '1015 CJ',
    'city' => 'Amsterdam',
    'country' => 'Nederland',
    'firstName' => 'Jan',
    'lastName' => 'de Vries',
    'email' => '[email protected]',
    'phone' => '+31612345678',
    'companyName' => 'Installatiebedrijf De Vries B.V.',
    'description' => 'Klant meldt waterschade aan het plafond',
    'category' => 'Loodgieter',
    'priority' => 'medium',
    'budgetQuote' => '€500 - €1000',
    'notes' => 'Graag zo snel mogelijk contact opnemen',
    'photoUrls' => [
        'https://api.widget.flixerpro.io/v1/image/b91aca1e.jpeg'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.flixerpro.io/v1/api/leads"

	payload := strings.NewReader("{\n  \"customerName\": \"Jan de Vries\",\n  \"title\": \"Lekkage badkamer\",\n  \"street\": \"Keizersgracht\",\n  \"streetNumber\": \"123\",\n  \"streetNumberAddition\": \"A\",\n  \"postalCode\": \"1015 CJ\",\n  \"city\": \"Amsterdam\",\n  \"country\": \"Nederland\",\n  \"firstName\": \"Jan\",\n  \"lastName\": \"de Vries\",\n  \"email\": \"[email protected]\",\n  \"phone\": \"+31612345678\",\n  \"companyName\": \"Installatiebedrijf De Vries B.V.\",\n  \"description\": \"Klant meldt waterschade aan het plafond\",\n  \"category\": \"Loodgieter\",\n  \"priority\": \"medium\",\n  \"budgetQuote\": \"€500 - €1000\",\n  \"notes\": \"Graag zo snel mogelijk contact opnemen\",\n  \"photoUrls\": [\n    \"https://api.widget.flixerpro.io/v1/image/b91aca1e.jpeg\"\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-API-Key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.flixerpro.io/v1/api/leads")
  .header("X-API-Key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"customerName\": \"Jan de Vries\",\n  \"title\": \"Lekkage badkamer\",\n  \"street\": \"Keizersgracht\",\n  \"streetNumber\": \"123\",\n  \"streetNumberAddition\": \"A\",\n  \"postalCode\": \"1015 CJ\",\n  \"city\": \"Amsterdam\",\n  \"country\": \"Nederland\",\n  \"firstName\": \"Jan\",\n  \"lastName\": \"de Vries\",\n  \"email\": \"[email protected]\",\n  \"phone\": \"+31612345678\",\n  \"companyName\": \"Installatiebedrijf De Vries B.V.\",\n  \"description\": \"Klant meldt waterschade aan het plafond\",\n  \"category\": \"Loodgieter\",\n  \"priority\": \"medium\",\n  \"budgetQuote\": \"€500 - €1000\",\n  \"notes\": \"Graag zo snel mogelijk contact opnemen\",\n  \"photoUrls\": [\n    \"https://api.widget.flixerpro.io/v1/image/b91aca1e.jpeg\"\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.flixerpro.io/v1/api/leads")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"customerName\": \"Jan de Vries\",\n  \"title\": \"Lekkage badkamer\",\n  \"street\": \"Keizersgracht\",\n  \"streetNumber\": \"123\",\n  \"streetNumberAddition\": \"A\",\n  \"postalCode\": \"1015 CJ\",\n  \"city\": \"Amsterdam\",\n  \"country\": \"Nederland\",\n  \"firstName\": \"Jan\",\n  \"lastName\": \"de Vries\",\n  \"email\": \"[email protected]\",\n  \"phone\": \"+31612345678\",\n  \"companyName\": \"Installatiebedrijf De Vries B.V.\",\n  \"description\": \"Klant meldt waterschade aan het plafond\",\n  \"category\": \"Loodgieter\",\n  \"priority\": \"medium\",\n  \"budgetQuote\": \"€500 - €1000\",\n  \"notes\": \"Graag zo snel mogelijk contact opnemen\",\n  \"photoUrls\": [\n    \"https://api.widget.flixerpro.io/v1/image/b91aca1e.jpeg\"\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "createdAt": "2026-06-17T10:30:45.000Z",
  "updatedAt": "2026-06-17T10:30:45.000Z",
  "createdBy": null,
  "updatedBy": null,
  "deletedAt": null,
  "archivedAt": null,
  "id": "WKIabc123def456ghi789jkl",
  "brandId": "BRDabc123def456ghi789jkl",
  "customerId": "CUSabc123def456ghi789jkl",
  "title": "Lekkage badkamer",
  "description": "Klant meldt waterschade aan het plafond",
  "status": "request",
  "priority": "medium",
  "category": "Loodgieter",
  "customerSignature": null,
  "scheduledStart": null,
  "scheduledEnd": null,
  "actualStart": null,
  "actualEnd": null,
  "source": "web",
  "receivedAt": "2026-06-17T10:30:45.000Z",
  "addressId": "ADRabc123def456ghi789jkl",
  "customStatusId": null,
  "estimatedCost": null,
  "finalCost": null,
  "budgetQuote": "€500 - €1000",
  "notes": null,
  "completionNotes": null,
  "tags": null,
  "customer": {
    "createdAt": "2026-06-17T10:30:45.000Z",
    "updatedAt": "2026-06-17T10:30:45.000Z",
    "createdBy": null,
    "updatedBy": null,
    "deletedAt": null,
    "archivedAt": null,
    "id": "CUSabc123def456ghi789jkl",
    "brandId": "BRDabc123def456ghi789jkl",
    "name": "Jan de Vries",
    "firstName": "Jan",
    "lastName": "de Vries",
    "email": "[email protected]",
    "phone": "+31612345678",
    "secondaryPhone": null,
    "companyName": "Installatiebedrijf De Vries B.V.",
    "isCompany": false,
    "status": "active",
    "addressId": "ADRabc123def456ghi789jkl",
    "notes": null,
    "tags": null
  },
  "address": {
    "id": "ADRabc123def456ghi789jkl",
    "brandId": "BRDabc123def456ghi789jkl",
    "country": "Nederland",
    "stateProvince": null,
    "city": "Amsterdam",
    "postalCode": "1015 CJ",
    "street": "Keizersgracht",
    "streetNumber": "123",
    "streetNumberAddition": "A",
    "latitude": 52.3676,
    "longitude": 4.9041,
    "locationNotes": null
  },
  "photos": [
    {
      "url": "https://api.widget.flixerpro.io/v1/image/b91aca1e.jpeg",
      "status": "attached",
      "assetId": "ASTabc123def456ghi789jkl",
      "reason": "Download failed with status 404"
    }
  ]
}

{
  "statusCode": 400,
  "message": "customerName is required",
  "error": "Bad Request"
}

{
  "statusCode": 400,
  "message": "customerName is required",
  "error": "Bad Request"
}

{
  "statusCode": 400,
  "message": "customerName is required",
  "error": "Bad Request"
}

API Reference

Leads

Work Items

Addresses

Create a new lead

Authorizations

Body

Response