Skip to main content
POST
/
conversions
Report a conversion (no Stripe)
curl --request POST \
  --url https://api.referralful.com/v1/conversions \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "amount_cents": 123,
  "referral_id": "<string>",
  "email": "<string>",
  "coupon": "<string>",
  "currency": "<string>",
  "external_id": "<string>",
  "customer_name": "<string>",
  "occurred_at": "2023-11-07T05:31:56Z"
}
'
{
  "object": "<string>",
  "duplicate": true,
  "sale_id": "<string>",
  "commission": {
    "id": "<string>",
    "object": "commission",
    "currency": "<string>",
    "amount": 123,
    "due_at": "2023-11-07T05:31:56Z",
    "paid_at": "2023-11-07T05:31:56Z",
    "campaign_id": "<string>",
    "affiliate_id": "<string>"
  }
}

Authorizations

Authorization
string
header
required

Use your API secret as the username, with an empty password.

Body

application/json
amount_cents
integer
required
referral_id
string
email
string
coupon
string
currency
string
external_id
string

Idempotency key (e.g. invoice id).

customer_name
string
occurred_at
string<date-time>

Response

Created

object
string
duplicate
boolean
sale_id
string
commission
object