---
title: "Push conversion events to Meta"
method: POST
path: "/app/{appId}/conversions/event"
tags: ["Conversions"]
---

# Push conversion events to Meta

`POST /app/{appId}/conversions/event`

## Request

- Base URL: `https://partner.gupshup.io/partner`
- URL: `https://partner.gupshup.io/partner/app/{appId}/conversions/event`
- Auth: HTTP bearer

Push conversion events for a WhatsApp app via the dataset associated with its WABA.

## Path parameters

- `appId` string, required

## Request body

- ConversionEventRequest
  - `data` ConversionEvent[], required: List of conversion events. Validated upstream.
    - `event_name` string, required: Event name (e.g. Purchase).
    - `event_time` integer, required: Unix timestamp (seconds).
    - `action_source` string, required: Action source.
    - `messaging_channel` string, required: Channel. Must be `whatsapp`.
    - `user_data` ConversionUserData, required: User identifiers. Must include matching WABA id + ctwa_clid.
      - `whatsapp_business_account_id` union, required: WABA id. Must match the WABA associated with the app.
        - string
        - integer
      - `ctwa_clid` string, required: Click-to-WhatsApp click id.
    - `custom_data` object: Optional custom fields (e.g. currency, value).
  - `partner_agent` string, required: Partner / agent name.

## Response `200`

Upstream success

- ConversionEventResponse: Upstream (Meta via WASS) response, passed through as-is.
  - `events_received` integer
  - `fbtrace_id` string
  - `messages` string[]
  - `status` string

## Other responses

- `400`: Validation / business error (portal or WASS)
- `401`: Missing or invalid Partner App token
- `403`: Caller lacks PARTNER_APP
- `429`: Rate limit exceeded
- `500`: Unexpected portal failure
- `default`: Non-success from WASS is passed through as-is

---

[API](https://skmtc.dev/gupshup/apis/partner-conversions-api.md) - [All operations](https://skmtc.dev/gupshup/apis/partner-conversions-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gupshup/apis/partner-conversions-api/revisions/480db5c43caa?raw)