Email Marketing

Conversions

Report revenue from your store or product. A stable external id makes a retried call safe.

Record

POST/api/v1/email/conversionsconversions:write

email	Required. The buyer’s address, used for attribution.
amount	Required.
currency	Required.
externalId	Optional order id. Send the same value on a retry.
quantity	Optional number.
occurredAt	Optional ISO 8601 timestamp. A value that does not parse is rejected.
metadata	Optional object.

curl

curl -sS https://api.thealtermeai.com/api/v1/email/conversions \
  -H "Authorization: Bearer emk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "[email protected]",
    "amount": "49.00",
    "currency": "USD",
    "externalId": "order_1001"
  }'

A new conversion returns 201. The same externalId again returns 200 with created: false. A conversion we cannot match to email inside the organization is still stored.

List

GET/api/v1/email/conversionsconversions:read

Newest first. Filter with campaignId, journeyId, email, status (ATTRIBUTED or UNATTRIBUTED), and since. limit defaults to 50.