Conversions

Post back a CPA job-application conversion

Sponsors call this when a click on their CPA job becomes an application. Authenticate with Authorization: Bearer <callback key> (your sponsor callback key, issued in the admin console — distinct from a publisher API key). ONE key covers every feed you run with us. Reference the click via the click_id we appended to your job URL on redirect. Idempotent: retrying the same (click_id, reference) returns the original conversion rather than double-booking. Revenue is computed from our recorded value, not any amount you send.

post/api/v1/conversions

Request

  • Base URL: https://api.juju.com
  • URL: https://api.juju.com/api/v1/conversions
  • Auth: HTTP bearer

Request body

click_idstring uuid required

The opaque click id we appended to your job URL (via your configured click_id_param) on the outbound redirect.

referencestring nullable

Your own application/lead id. Optional but recommended — it is the idempotency key for retries. Omit it and we dedupe one conversion per click_id.

Example request

{
  "click_id": "a1b2c3d4-e5f6-1234-9abc-0123456789ab",
  "reference": "ZR-APP-99817"
}

Response

Idempotent replay — a conversion for this (click_id, reference) already existed; the original is returned and nothing was double-booked.

dataunknown required
metaobject required

Pagination and context metadata. Always present, empty object ({}) when no metadata applies to the response.

errorsstring[] required

Empty array on success. On failure, human-readable error strings suitable for surfacing to end users.

Example response

{
  "errors": []
}

Changes

No recorded changes to this operation across all 1 revision of this API.