Skip to main content
POST
/
lead
/
{lead_id}
/
status
Update lead status
curl --request POST \
  --url https://{tenant}.techea.eu/api/v1/lead/{lead_id}/status \
  --header 'Content-Type: application/json' \
  --header 'apikey: <api-key>' \
  --data '
{
  "status": "converted",
  "advertiser_id": "5490c3cc-0d44-4b50-8888-8dd43736052a",
  "metadata": {
    "amount": 8000,
    "term_months": 24
  }
}
'
{
  "lead_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "status": "converted"
}

Authorizations

apikey
string
header
required

API Key provided by TECHEA

Path Parameters

lead_id
string<uuid>
required

Lead ID provided by Leadhub at submission time

Body

application/json
status
enum<string>
required

Status reported by the advertiser.

Available options:
converted,
rejected
advertiser_id
string

Advertiser's reference for this lead

metadata
object

Additional data related to the status update

Response

Status update received and processed

lead_id
string<uuid>
status
enum<string>

Status reported by the advertiser.

Available options:
converted,
rejected