Send an event (sale)

post

https://api.withfuul.com/ingest/v1/events

Send a sale to Fuul. The customer is their email; the sale is credited to the affiliate the customer is bound to when Fuul processes it. amount and currency go together — send both or neither. A sale with a ref_code must carry an amount above 0. The code goes in ref_code; the X-Referral-Code header is refused. The old field names event_id, volume, ref and user_id are refused.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

name

string

enum

required

length ≤ 100

The event. Only "sale" is taken; any other name is refused.

Allowed:

dedupe_id

string

required

length between 1 and 200

Your id for the sale. The same one sent again is the same sale: a retry is safe.

string

required

length ≤ 254

The customer's email. Case and spaces don't matter.

amount

string

^\d+(?:\.\d+)?$

A decimal string, e.g. "29.00", with no more decimals than the currency takes. Sent together with currency. Required and above 0 when ref_code is present; "0.00" is taken and ignored.

currency

string

enum

USD only, for now: another currency is refused. Sent together with amount.

Allowed:

occurred_at

date-time

ISO 8601 with its offset, e.g. 2026-10-06T12:00:00Z. Now when absent; at most five minutes ahead.

ref_code

string

length between 1 and 64

The affiliate's referral code. In the body only; the X-Referral-Code header is refused. When present, amount is required and above 0.

Responses

202The sale was recorded. A 202 is not always a counted sale: a sale of "0.00", or one with no amount and no code, is recorded and ignored.

400One or more fields are wrong; the error names each one in details.fields.

401The API key is not valid.

409The API conversion source isn't connected. Connect it in Settings → Conversion sources first.