# Conversions

Send conversions to an impact.com program server to server, credited to the partner by the irclickid click id, the customer id or a promo code.

`POST /v1/events` sends your conversions to Impact's Conversions API. The destination is `<program id>:<event type id>`.

## Send a conversion event

Name the Impact account and its destination. Send the `irclickid` from the partner's click so Impact can credit them:

```bash
curl -X POST "https://zernio.com/api/v1/events" \
  -H "Authorization: Bearer $ZERNIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "profileId": "PROFILE_ID",
    "destinations": [{ "accountId": "ACCOUNT_ID", "destinationId": "12345:67890" }],
    "events": [{
      "eventName": "Purchase",
      "eventTime": 1798804800,
      "eventId": "order_12345",
      "value": 25.99,
      "currency": "USD",
      "user": {
        "email": "customer@example.com",
        "externalId": "customer_42",
        "clickIds": { "irclickid": "IRCLICKID_FROM_THE_CLICK" }
      }
    }]
  }'
```

To send every purchase to Impact without naming it each time, create a [forwarding rule](/conversions/create-forwarding-rule) for the account instead.

## Event names

The event type you connected sets what Impact counts and pays, so `eventName` is not sent.

Impact pays partners for every conversion, so these are never sent: `PageView`, `ViewContent`, `Search`, `AddToCart`, `AddToWishlist`, `InitiateCheckout`, `AddPaymentInfo`. A rule turned on in the dashboard sends `Purchase` only.

## Match keys

Each conversion needs at least one of these:

| Field | Sent as |
|-------|---------|
| `user.clickIds.irclickid` | `ClickId`. The best match |
| `user.externalId` | `CustomerId` |
| `platformData.promo_code` | `OrderPromoCode` |

`user.email` goes as `CustomerEmail`, SHA-256 hashed. The [Zernio tag](/products/server-side-tracking/script) keeps `irclickid` from the landing URL. Send the visitor id, or the customer's email, phone or external id, and your backend events get it too.

## What else is sent

- When every item has a `price`, each item is sent as `ItemSku`, `ItemName`, `ItemCategory`, `ItemQuantity` and `ItemSubTotal`. Otherwise `value` is sent as `OrderSubTotalPostDiscount`.
- A conversion with a value needs `currency`.
- `platformData.order_id`, or else `eventId`, is the `OrderId`, up to 64 characters. Impact dedups on it.

## Consent

- With `consent.adUserData` `DENIED`, only the click id and the promo code are sent: the customer id and email are left out.
- On profiles created since 22 November 2026, a conversion from the EEA, UK or Switzerland is sent only with `adUserData` granted and no ad signal denied. In the EEA, UK and Switzerland the tag keeps `irclickid` only after the visitor accepts ad cookies. See [Consent](/products/server-side-tracking/consent).

## How it behaves

- One conversion per request, five at a time.
- Impact has no test mode. A request with `testCode` is refused: credit a test partner on your program and send live events.

## If it fails

| Error | Cause | Fix |
|-------|-------|-----|
| `Impact needs the irclickid click id, the customer id (externalId), or a promo code to credit a partner.` | No way to credit a partner | Send one of the match keys. |
| `Impact pays partners for every conversion it gets, so "…" (a browsing or funnel step) is not sent.` | A funnel event reached Impact | Forward only conversions to Impact. |
| `Impact order ids are at most 64 characters.` | `order_id` or `eventId` is too long | Shorten it. |
| `Impact needs the currency of a conversion with a value.` | `value` or priced items without `currency` | Add `currency`. |
| `Impact has no test mode: …` | The request has a `testCode` | Drop `testCode` and use a test partner. |
| `destinationId must be "<program id>:<event type id>" …` | The destination is not in that form | Use the id from `GET /v1/ads/conversions/destinations`. |
| `401` with `reconnect_required` | Impact refused the saved credentials | [Connect again](/platforms/impact/connect) with a token that can write Conversions. |

## Related

- [Send events](/conversions/send-events)
- [Create a forwarding rule](/conversions/create-forwarding-rule)
- [Consent](/products/server-side-tracking/consent)
- [Limits and errors](/platforms/impact/reference)