What you need
Revshare needs your Impact Account SID and Auth Token. The Account SID is used in the API path, and the Auth Token is used as the password for Impact Basic Auth.
Account SID: your Impact API username.
Auth Token: your Impact API password. Keep it secret.
Where to find credentials
- 1. Log in to Impact.
- 2. Go to Account → Settings → Setup → Contact Info → Scopes.
- 3. Click Configure API Scopes.
- 4. Select the required Actions, Clicks, and Jobs Management scopes listed below.
- 5. Save the token, then copy the Account SID and Auth Token.
Revshare’s Impact setup form has two credential fields:
- Account SID: paste the Account SID from Impact.
- Auth Token: paste the generated token value.
Required API scopes
When creating or editing the Impact access token, enable these scopes:
Actions: Retrieve actions
Imports approved conversion events, payouts, currencies, advertiser names, and action dates.
/Mediapartners/<AccountSID>/ActionsClicks: Export clicks
Imports click counts by date so clicks can be shown beside conversions and commissions.
/Mediapartners/<AccountSID>/ClickExportJobs Management: Download export jobs
Impact ClickExport returns a queued job for some accounts. Revshare needs job download access to retrieve the completed click export.
/Mediapartners/<AccountSID>/Jobs/<JobID>/DownloadScope details
Actions
Actions represent conversion events that have been credited and are eligible for payout. Revshare uses these endpoints to retrieve conversion and commission information.
| Objective | API Path | Method |
|---|---|---|
| Retrieve actions | /Mediapartners/<AccountSID>/Actions | GET |
| Retrieve action | /Mediapartners/<AccountSID>/Actions/<ActionID> | GET |
| Retrieve action items | /Mediapartners/<AccountSID>/Actions/<ActionID>/Items | GET |
| Retrieve action item | /Mediapartners/<AccountSID>/Actions/<ActionID>/Items/<Sku> | GET |
| Retrieve action updates | /Mediapartners/<AccountSID>/ActionUpdates | GET |
| Retrieve action update | /Mediapartners/<AccountSID>/ActionUpdates/<ID> | GET |
Clicks
Clicks API resource paths. Revshare exports click activity by date and may need individual click access for troubleshooting.
| Objective | API Path | Method |
|---|---|---|
| Export clicks | /Mediapartners/<AccountSID>/ClickExport | GET |
| Retrieve click | /Mediapartners/<AccountSID>/Clicks/<Id> | GET |
Optional scopes
These are not required for the current Revshare sync, but can be useful if you want account or campaign metadata later.
Accounts
Useful for validating account metadata, but not required for daily stats sync.
GET /Mediapartners/<AccountSID>Campaigns
Useful if you later want campaign logos or campaign metadata in Revshare.
GET /Mediapartners/<AccountSID>/CampaignsConnect in Revshare
Open Affiliate Dashboard → Connect, choose Impact, and enter:
- Label: a name for this Impact connection.
- Auth Token: the Impact token password.
- Account SID: the Impact API username.
- Currency: the currency you want stored for this connection.
Troubleshooting
401 Unauthorized
The Account SID or Auth Token is incorrect, expired, or copied from the wrong Impact account.
403 Access denied
The token is missing Actions → Retrieve actions, Clicks → Export clicks, or Jobs Management → Download export jobs. Update the token scopes and try syncing again.
429 Rate limit exceeded
Impact is temporarily rejecting API calls. Revshare retries with backoff, but if the limit is still active, wait a minute before syncing again.
No conversions
Revshare imports approved Impact actions from /Actions. If an action is pending, rejected, or outside the selected sync window, it may not appear yet.