How to confirm Action offers via API

When you create an Action offer, conversions must be explicitly confirmed after the subscriber completes the desired action on your website (e.g., signs up for a trial, makes a purchase, downloads a resource). ​ This guide explains how to confirm Action conversions using the SparkLoop API. ​ ​How It Works

1. User clicks offer link

2. User is redirected to your website → You capture the tracking parameters

3. User completes the action -> Purchase/Signup/Download/etc..

4. You call the API → Confirm the conversion with SparkLoop

5. Conversion is processed

---

Step 1: Capture the Tracking Parameters

When SparkLoop redirects users to your website, we append two query parameters to your redirect URL:

• submission — The unique ID for this submission

• offer — The unique ID for your offer ​

Example Redirect URL

If your offer redirect URL is https://example.com/signup, the user will be redirected to: ​ ​https://example.com/signup?submission=submission_1234abcd&offer=offer_1234abcd ​ ​Important: You must capture and store the submission parameter when the user lands on your site. You'll need it to confirm the conversion later.

The offer UUID is always the same for the same offer.

In case you don't know your offer's UUID, you can fetch your offers via the API, or you can find the offer's UUID in your dashboard when you open the offer.

​

---

Step 2: Confirm the Conversion

Once the user completes your desired action, use the SparkLoop API to confirm the conversion.

POST https://dash.sparkloop.app/api/v2/offers/:offer_uuid/submissions/:submission_uuid/conversions

Replace :offer_uuid with the offer parameter and :submission_uuid with the submission parameter from Step 1.

Here you can find the API docs for this endpoint.​

---

Important Notes

• Action conversions expire after 45 days if not confirmed

• Make sure to confirm conversions as soon as the user completes your desired action