> ## Documentation Index
> Fetch the complete documentation index at: https://docs.northbeam.io/llms.txt
> Use this file to discover all available pages before exploring further.
# Impact Setup
> Connect Impact with API credentials and add the Northbeam parameter so spend and revenue line up.
When you're done, Northbeam shows your Impact spend, visits, and attributed revenue on the same programs, partners, and ads.
**Before you start**, make sure you have:
* An Impact user with the **Account Administrator** or **Implementation Specialist** role, so you can create API credentials
* Access to Impact **Settings** to edit the program tracking template
Create an Impact API token and paste it into Northbeam.
Add `nbt` once to your program tracking template.
Check that parameters and spend are reaching Northbeam.
Northbeam connects with Impact's **Legacy API Token**. You need your **Account SID** and **Auth Token**.
Only users with the **Account Administrator** or **Implementation Specialist** role in Impact can see API credentials. If you don't see the API section in Settings, ask your Impact admin to give you one of these roles or to get the credentials for you.
**Create the token in Impact**
1. In Impact, go to **\[User profile] → Settings → Technical → API**.
2. Click **Create Access Token**. See [Impact's guide](https://help.impact.com/brand/what-would-you-like-to-learn-about/account-administration/account-settings/api-tokens/create-an-api-access-token-as-a-brand) for details.
3. Complete the **Setup** and **Contact Information** steps.
4. On the **API Scopes** step, select these scopes (all GET):
* `/Advertisers//Campaigns`
* `/Advertisers//Actions`
* `/Advertisers//Ads`
* `/Advertisers//MediaPartners`
* `/Advertisers//ReportExport/{ReportId_or_Handle}`
* `/Advertisers//Reports`
* `/Advertisers//Reports/{ReportId}`
5. Click **Create**.
**Connect in Northbeam**
1. Open [Connections](https://dashboard.northbeam.io/settings/connections) and select **Impact**. If you're still in onboarding, go to **Integrations > Impact** instead.
2. Paste your **Account SID** and **Auth Token**, then click **Connect**.
If you see *"An error occurred: Invalid credentials,"* check both values and try again.
**If you skip this step:** campaign, partner, and ad names are missing, along with spend metrics.
Add this parameter to the click URLs for all new and existing Impact ads:
| Parameter | Value |
| :- | :- |
| `nbt` | `nb:impact::{ircid}:{irpid}:{iradid}` |
1. In Impact, go to **\[User profile] → Settings → Gateway**.
2. Under **Program Tracking Template**, add a new parameter row with **Name** `nbt` and **Value** `nb:impact::{ircid}:{irpid}:{iradid}`.
3. Click **Save**.
**If you skip this step:** Northbeam can't tie visits and orders to your Impact ads, so spend and revenue show up on separate lines.
* **Parameters captured:** follow [Checking UTM tracking](/docs/checking-utm-tracking) to confirm the Northbeam parameters reach your landing pages.
* **Connection syncing:** follow [Checking platform connections](/docs/checking-api-connections) to confirm the account shows as connected and data is arriving.
If a check fails, see [Troubleshooting Northbeam data](/docs/troubleshooting-tracking-issues).
## How Impact data maps to Northbeam
Impact data follows Impact's own hierarchy: programs (campaigns) contain partners, and partners use individual ads.
| Impact level | Northbeam level |
| :- | :- |
| Program (Campaign) | Campaign Level |
| Partner | Adset Level |
| Ad | Ad Level |
## Remove Impact custom spend (optional)
Once connected, Northbeam pulls up to **3 years of historical spend** from Impact. If you already send Impact spend through a Spend Sheet or the Spend API, remove the overlap so it isn't reported twice.
For example, if you connect on `5/10/26`, Northbeam backfills Impact spend to `5/10/23`. If you have Impact spend older than that window and want to keep it, leave those older records in place.
**From a Spend Sheet**
1. Go to [Settings > Data Spreadsheets](https://dashboard.northbeam.io/settings/data-spreadsheets).
2. Find the sheet tied to Impact.
3. **Zero out** the Impact spend that overlaps the backfill period. For example, if you connect on `5/10/26`, zero out Impact spend from `5/10/23` onward.
**Don't delete rows, columns, or cells** from the Spend Sheet. Replace the overlapping Impact spend values with `0` instead. Custom spend sheets vary: some use formulas tied to raw data import tabs, others use manually entered spend.
**From the Spend API**
Delete the existing Impact spend records with the [Delete Spend endpoint](/reference/delete_spend).
If you're not sure which values to remove, [submit a support ticket](https://www.northbeam.io/submit-a-support-ticket) and we'll help.
## Need help?
Common Impact setup and reporting questions.
Start here if a check above fails.