---
title: "Track Meta Lead"
method: POST
path: "/api/v1/analytics/meta/lead"
tags: ["Analytics"]
---

# Track Meta Lead

`POST /api/v1/analytics/meta/lead`

## Request

- Base URL: `https://foto.damdafa.com/dreamhome`
- URL: `https://foto.damdafa.com/dreamhome/api/v1/analytics/meta/lead`
- Auth: none declared

Track a 'Lead' event (e.g. clicking 'Download' or 'Go to App' from landing page).
Sends the event directly to Meta Conversions API via BackgroundTasks.

## Request body

- TrackLeadRequest: Request payload from the Landing Page when a user clicks 'Download' or 'Go to App'.
  - `action_source` string: Where the action occurred (e.g. 'website')
  - `event_source_url` string, nullable: The URL the user was on
  - `email` string, nullable: Optional email if they provided one
  - `fbc` string, nullable: Facebook Click ID cookie (_fbc)
  - `fbp` string, nullable: Facebook Browser ID cookie (_fbp)
  - `event_id` string, nullable: Event ID generated on frontend for CAPI deduplication
  - `fbclid` string, nullable: Raw Facebook Click ID from URL

## Response `200`

Successful Response

- TrackLeadResponse
  - `success` boolean, required
  - `message` string, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/damdafa/apis/homedecor-api.md) · [All operations](https://skmtc.dev/damdafa/apis/homedecor-api/llms.txt) · [OpenAPI document](https://skmtc.dev/damdafa/apis/homedecor-api/revisions/372f33a6d18e?raw)