Create a real lead

Idempotent lead ingestion with optional bounded first-touch attribution. Set emailMarketingConsent=true only after an explicit marketing opt-in; analytics consent is never reused. Never send raw gclid/fbclid values. Demo fixtures are never returned by this API or counted as activation.

post/leads

Request

  • Base URL: https://gringofunnels.com/api/v1
  • URL: https://gringofunnels.com/api/v1/leads
  • Auth: HTTP bearer

Headers

Idempotency-Keystring required

Unique retry key (8–128 safe ASCII characters).

Request body

externalIdstring
funnelIdstring uuid
namestring required
emailstring email required
phonestring
citystring
sourcestring
emailMarketingConsentboolean

Explicit opt-in to marketing e-mail for this capture.

stagestring
scoreinteger

Response

Existing lead returned for an idempotent retry

Changes

No recorded changes to this operation across all 1 revision of this API.