---
title: "Ingest first-party conversion events"
method: POST
path: "/events"
---

# Ingest first-party conversion events

`POST /events`

## Request

- Base URL: `https://lazyads.ai/api/v1`
- URL: `https://lazyads.ai/api/v1/events`
- Auth: HTTP bearer

Batch of 1 to 100 server-side conversion events forwarded to Meta CAPI (and Google Enhanced Conversions when `googleConversionActionId` is set) with `eventId` deduplication against the browser pixel. Requires the `performance` scope.

## Request body

- object
  - `events` object[], required
    - `eventName` string, required: e.g. Purchase, Lead
    - `eventId` string, required: Shared with the pixel for dedup
    - `eventTime` integer: Unix seconds
    - `eventSourceUrl` string, uri
    - `value` number
    - `currency` string
    - `orderId` string
    - `fbclid` string
    - `fbp` string
    - `gclid` string
    - `ttclid` string
    - `user` object: Hashed server-side before forwarding
      - `email` string, email
      - `phone` string
      - `firstName` string
      - `lastName` string
      - `city` string
      - `state` string
      - `zip` string
      - `country` string
      - `externalId` string
  - `googleConversionActionId` string

## Response `200`

Events accepted

---

[API](https://skmtc.dev/lazyads/apis/lazyads-api.md) · [All operations](https://skmtc.dev/lazyads/apis/lazyads-api/llms.txt) · [OpenAPI document](https://skmtc.dev/lazyads/apis/lazyads-api/revisions/7d5de42538e9?raw)