---
title: "Submit WABA conversions"
method: POST
path: "/whatsapp/1/conversions/waba"
tags: ["channels", "whatsapp", "whatsapp-ad-conversions"]
---

# Submit WABA conversions

`POST /whatsapp/1/conversions/waba`

## Request

- Base URL: `https://api.infobip.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.infobip.com/whatsapp/1/conversions/waba`
- Auth: one of:
  - OAuth 2
    - Client credentials
    - Token URL: `https://api.infobip.com/auth/1/oauth2/token`
  - API key in header `Authorization`
  - API key in header `Authorization`
  - HTTP basic

Submit WhatsApp conversion events using your WhatsApp Business Account (WABA) phone number as the source. Each conversion event is linked to an ad click via ctwaClickId — a unique identifier contained within the inbound WhatsApp message originating from the ad. You can optionally include conversion details such as value and currency, and a conversion timestamp (up to 7 days in the past). Events are submitted in batches of up to 1,000 and are indivisible — either all are submitted or none.

## Request body

- 52c80a2bd29a734b52d9eb3ddb9b5d8ef0cb7c55640245f275763458f4c36a60WABAConversionEventRequest
  - `sourceId` string, required: Sender as source identifier. This is the phone number registered via the embedded signup flow available in Exchange app.
  - `conversions` 52c80a2bd29a734b52d9eb3ddb9b5d8ef0cb7c55640245f275763458f4c36a60MetaConversionModel[], required: Conversion events collection.
    - `ctwaClickId` string, required: ctwaClickId is unique identifier of each click on the ad that clicks to WhatsApp. ctwaClickId is contained within the inbound message originating from the ad within the referral object. Check payload [here](https://www.infobip.com/docs/api/channels/whatsapp/whatsapp-inbound-messages/receive-whatsapp-inbound-messages).
    - `type` 'PURCHASE' | 'LEAD_SUBMITTED' | 'INITIATE_CHECKOUT' | 'ADD_TO_CART' | 'VIEW_CONTENT' | 'ORDER_CREATED' | 'ORDER_SHIPPED' | 'ORDER_DELIVERED' | 'ORDER_CANCELED' | 'ORDER_RETURNED' | 'CART_ABANDONED' | 'QUALIFIED_LEAD' | 'RATING_PROVIDED' | 'REVIEW_PROVIDED', required: Type of the conversion. Can be `PURCHASE` or `LEAD_SUBMITTED`.
    - `details` 52c80a2bd29a734b52d9eb3ddb9b5d8ef0cb7c55640245f275763458f4c36a60ConversionDetails: Details should contain value and currency information indicating exact value of the conversion that happened.
      - `currency` string, required: Currency of the conversion. Has to be the same as it is set on ad account.
      - `value` number, required: Value of the conversion. Can be 0.
    - `conversionTime` string, date-time: Time when the conversion happened. Must be in the format `yyyy-MM-dd'T'HH:mm:ss.SSSZ`. Date must not be older than 7 days. If omitted then current time of submission is used.

## Response `204`

Conversions were submitted

## Other responses

- `400`: Bad request or missing required fields
- `401`: Unauthorized
- `403`: Forbidden
- `404`: WABA not found or no dataset configured
- `429`: Too Many Requests
- `500`: Internal Server Error

---

[API](https://skmtc.dev/infobip/apis/infobip-openapi-specification.md) - [All operations](https://skmtc.dev/infobip/apis/infobip-openapi-specification/llms.txt) - [OpenAPI document](https://skmtc.dev/infobip/apis/infobip-openapi-specification/revisions/9dcbbaf902de?raw)