Lead Gen

Update a lead's status

Changed on

Sets the status of a Meta lead (and optionally its value) so you can track it from lead to sale.

{id} is the Zernio lead id (id on GET /v1/ads/leads, leadId on GET /v1/ads/lead-forms/{formId}/leads) or the Meta leadgenId together with accountId in the body. Requires the Ads add-on.

patch/v1/ads/leads/{id}

Request

  • Base URL: https://zernio.com/api
  • URL: https://zernio.com/api/v1/ads/leads/{id}
  • Auth: HTTP bearer

Path parameters

idstring required

Zernio lead id, or the Meta leadgenId (then accountId is required).

Request body

status'new' | 'contacted' | 'unreachable' | 'qualified' | 'converted' | 'disqualified' required
valuenumber

Deal value; requires currency.

currencystring

ISO 4217 code.

accountIdstring

Required when {id} is a Meta leadgenId: the facebook or metaads account that received the lead.

Example request

{
  "currency": "EUR"
}

Response

The updated lead.

statusstring

Example response

{
  "status": "success"
}

Changes