FirstPromoter
Connect FirstPromoter to rank your promoters, review commissions and referrals, manage campaigns and promo codes, and see who is due a payout.
You paste two values into PopMCP: an API key and your Account ID, both from Settings, Integrations, Manage API Keys in FirstPromoter. The Account ID names the one account this connection uses, so there is nothing to choose afterwards.
- Setup time
- 2 min
- Auth
- API credentials
- API base URL
- https://api.firstpromoter.com/api/v2/company
Before you begin
- A FirstPromoter account on any plan: its pricing page lists developer APIs and webhooks on Starter, Business and Enterprise
- Access to Settings in your FirstPromoter dashboard
- Nothing to apply for: the key works straight away
- Embedding the promoter dashboard in your own app needs Business or higher and a custom domain
Get your credentials
Open Manage API Keys
Log in to FirstPromoter at login.firstpromoter.com. Open Settings, then Integrations, then Manage API Keys.
Integrations
Create an API key
Click Add new Key, give it a name such as PopMCP, and click Create. Copy the key right away: FirstPromoter asks you to store it as soon as it is made. It gives full access to your FirstPromoter account, so do not share it anywhere else.
Add new Key
Copy your Account ID
Stay on the same panel and copy your Account ID. FirstPromoter needs it with every request, because it says which account the key is for.
Integrations
Connect in PopMCP
Paste the API key and Account ID into PopMCP's FirstPromoter form and click Connect. PopMCP checks them with FirstPromoter. Leave V1 API key under More options blank unless you need the older V1 tools and FirstPromoter refuses your main key on them.
Check it is connected
The FirstPromoter card in PopMCP reads Connected, with your Account ID. New connections start read-only, so accepting promoters, approving commissions and marking payouts as paid wait until an owner or admin allows write actions in PopMCP.
FirstPromoter
- Status
- Connected
- Account
- FirstPromoter account 123456
- Access
- Read only
Connect in PopMCP
Open your workspace, choose FirstPromoter in the marketplace, and fill in the connect dialog:
| Field | What to enter |
|---|---|
| API keysecret | In FirstPromoter: Settings, Integrations, Manage API Keys, then Add new Key. Copy it right away. Stored encrypted.Encrypted with AES-256-GCM on save and never shown again. |
| Account IDtext | On the same page, in the API integrations panel. |
| V1 API keysecret | Only for the older V1 tools. Most people can leave this blank.Encrypted with AES-256-GCM on save and never shown again. |
PopMCP verifies the credential against FirstPromoter immediately. On success the connection flips to Verified and its MCP tools are provisioned.
Verify it worked
PopMCP shows the FirstPromoter connector as Connected, labelled with your Account ID, after one read of your promoters.
Troubleshooting
FirstPromoter did not accept this API key and Account ID
Why: The key or the Account ID was copied only in part, or the key has been deleted.
Fix: Open Settings, Integrations, Manage API Keys in FirstPromoter. Copy the Account ID again, add a new key if you no longer have the old one, then connect again.
FirstPromoter did not accept the V1 API key
Why: The main key and Account ID work, but the optional V1 key does not.
Fix: Copy the V1 key again from Settings in FirstPromoter, or leave the field blank. Only the older V1 tools use it.
FirstPromoter is limiting requests
Why: FirstPromoter allows 400 requests per minute per account, shared by everything using it.
Fix: Wait a minute and try again. If your own scripts use the same account, space them out.
A bulk action says in_progress
Why: FirstPromoter runs bulk actions on more than 5 records in the background.
Fix: This is normal. The AI can check on it with the wait for batch tool. Do not repeat the action.
Creating a promo code is refused
Why: FirstPromoter can create promo codes through its API for Stripe accounts only.
Fix: Create the code in your billing provider, then add it to the promoter's campaign.
Embedding the promoter dashboard is refused
Why: It needs the Business plan or higher and a custom domain on the account.
Fix: Check your plan and custom domain in FirstPromoter.