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

# Submit conversions

`POST /whatsapp/1/conversions`

## 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`
- Auth: one of:
  - API key in header `Authorization`
  - API key in header `Authorization`
  - HTTP basic
  - OAuth 2
    - Client credentials
    - Token URL: `https://api.infobip.com/auth/1/oauth2/token`

Submit WhatsApp conversion events. Events are indivisible, either all are submitted or none.

## Request body

- D787c8758e54290e2bc82a005b86f9050517ec4ab2e17f0a4cc0942f51132c33ConversionEventRequest
  - `sourceId` string: Conversion events source identifier. In case of ads that click to WhatsApp, it should be the Facebook Page selected through Ads manager and through Exchange app. Could be omitted if only one page is connected through Exchange app.
  - `conversions` D787c8758e54290e2bc82a005b86f9050517ec4ab2e17f0a4cc0942f51132c33ConversionEventModel[], 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', required: Type of the conversion. Can be `PURCHASE` or `LEAD_SUBMITTED`.
    - `details` object: Details should contain value and currency information indicating exact value of the conversion that happened. Value can be 0. Currency has to be the same as it is set on ad account.
    - `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
- `401`: Unauthorized
- `403`: Forbidden
- `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)