Skip to main content
POST
/
projects
Project Lead Submission
curl --request POST \
  --url https://app.epadossier.nl/api/v1/projects \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "type": "individual",
  "customerName": "Jan Janssen",
  "customerEmail": "jan@example.com",
  "price": 349,
  "source": "website",
  "postalCode": "5541VJ",
  "houseNumber": "3",
  "place": "Reusel",
  "street": "Beukenlaan"
}
'
{
  "success": true,
  "projectId": "nanoid_12345",
  "projectNumber": "PRJ-2025-001"
}

​
Overzicht

Deze endpoint stelt je in staat om nieuwe project leads in te dienen bij EPAdossier. Wanneer een lead succesvol wordt ingediend, wordt automatisch de geconfigureerde flow uitgevoerd (zoals het aanmaken van een dossier of het versturen van een link naar de klant).

​
Authenticatie

Deze endpoint vereist een geldige API-sleutel in de X-API-Key header. 
X-API-Key: epa_jouw_secret_key

​
Voorbeeld Request

curl -X POST https://app.epadossier.nl/api/v1/projects \
  -H "X-API-Key: epa_jouw_secret_key" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "individual",
    "customerName": "Jan Janssen",
    "customerEmail": "jan@example.com",
    "price": 349.00,
    "source": "website",
    "postalCode": "5541VJ",
    "houseNumber": "3",
    "place": "Reusel",
    "street": "Beukenlaan"
  }'

​
Response Format

​
Succes (200)

{
  "success": true,
  "projectId": "nanoid_12345",
  "projectNumber": "PRJ-2025-001"
}

​
Error (400/401/429/500)

{
  "success": false,
  "error": "INVALID_REQUEST",
  "message": "Ongeldig e-mailadres opgegeven"
}

​
Belangrijke Opmerkingen

Automatische Flow Uitvoering: De geconfigureerde “Flow” (zoals automatisch dossier aanmaken of link versturen) wordt direct na een succesvolle API-aanroep op de achtergrond uitgevoerd.
Rate Limiting: Maximaal 100 requests per minuut per API-sleutel.

Authorizations

​
X-API-Key
string
header
required

API sleutel voor authenticatie. Verkrijg deze in je EPAdossier account instellingen.

Body

application/json
​
type
enum<string>
required

Project type

Available options:
individual,
energy_label,
inspection,
consultation
Example:

"individual"

​
customerName
string
required

Volledige naam van de klant

Example:

"Jan Janssen"

​
price
number<float>
required

Totaalbedrag voor de aanvraag

Example:

349

​
source
enum<string>
required

Bron van de lead

Available options:
website,
referral,
direct,
advertisement,
social_media,
partner
Example:

"website"

​
customerEmail
string<email>

E-mailadres van de klant

Example:

"jan@example.com"

​
customerPhone
string

Telefoonnummer van de klant

Example:

"+31 6 12345678"

​
postalCode
string

Postcode (bijv. 1234AB)

Example:

"5541VJ"

​
houseNumber
string

Huisnummer

Example:

"3"

​
addition
string

Toevoeging

Example:

"A"

​
place
string

Woonplaats

Example:

"Reusel"

​
street
string

Straatnaam

Example:

"Beukenlaan"

​
remarks
string

Optionele opmerkingen bij de aanvraag

Example:

"Klant heeft voorkeur voor ochtend afspraken"

Response

Project lead succesvol aangemaakt

​
success
boolean

Geeft aan of de aanvraag succesvol was

Example:

true

​
projectId
string

Unieke identifier van het aangemaakte project

Example:

"nanoid_12345"

​
projectNumber
string

Mensvriendelijke projectnummer

Example:

"PRJ-2025-001"