How to integrate Stripe API
Step 1. Open the Stripe dashboard
- Go to dashboard and navigate to Developers > API Keys.

Step 2. Create restricted key
- In the API Keys section, click Create restricted key

- Select Powering an integration you build

- Choose all the 4 permissions & continue:

- Name the key (we recommend "Campaignswell") and select the following resource types, all with Read access:
- Core
- Billing
- Checkout Sessions
- Reporting

- Save settings and complete email verification - it's a standard Stripe security step
- Copy the restricted key and paste it into Campaignswell Integrations (Stripe) under Add Account

Step 3. Copy the Webhook URL from Campaignswell
Once you've clicked Add account in Campaignswell, the system will generate a unique Webhook URL. Copy it - you'll need it in the next step.
Step 4. Go to Webhooks in Stripe
Open dashboard and navigate to Developers > Webhooks.
Step 5. Add the Endpoint URL
- Click Add endpoint

- Select Your account as the source
- Choose All events to ensure full data coverage > continue


- Paste the Endpoint URL copied from Campaignswell Integrations (Stripe)
- Continue and repeat the step by pasting the Campaignswell endpoint again
Heads up: Stripe usually creates two destinations - one with ~24 events and one with ~200+ events. Delete the smaller one and keep the destination with the larger event count.
Step 6. Copy the Signing Secret
Open the new webhook (the one with all events), scroll down and reveal the Signing Secret on the right side. Copy it and paste it into the Webhook Signed Secret field in Campaignswell.

Step 7. Provide Your Stripe Account ID
Go to Account Settings > Business in Stripe (gear icon in the top right). You'll find your Account ID there (e.g., acct_123ABC...). Copy it and paste it into the Account ID field in Campaignswell.

Step 8. Save 🎉
Save the integration in Campaignswell - data will start flowing on the next sync. If anything looks off, let your CSM know and we'll jump in.
