Connect your own Whop account
Connect a Whop account you already own with a company API key, pick the ad account Koast launches into, and import more from the brand switcher.
If you already run ads through your own Whop company, connect it with a company API key. Koast then launches, edits and reports on that Whop ad account like any other.
Before you start
Create a company API key in your Whop dashboard, under Developer. Whop starts every new key with no permissions, so tick all 13 of these:
| Permission | What stops working without it |
|---|---|
ad_campaign:basic:read | Reading your campaigns, ad sets, ads and targeting options. |
ad_campaign:create | Creating and duplicating campaigns, ad sets and ads. |
ad_campaign:update | Editing, pausing, resuming and deleting them. |
ad_campaign:stats:read | All spend, impressions and clicks. |
company:basic:read | Identifying your company and reading its settings. |
company:balance:read | Reading the ad account and its balance. |
company:update | Saving account settings. |
social_account:read | The identity your ads run under, its posts and lead forms. |
social_account:create | Connecting a social account. |
social_account:delete | Disconnecting one. |
audience:basic:read | Listing your custom audiences. |
audience:update | Creating, editing and deleting audiences. |
access_pass:basic:read | Listing your Whop products as ad destinations. |
Tick all 13
A key with missing permissions still connects. Whop doesn't tell Koast what a key can do, so Koast only finds out when it tries to use one and the call comes back refused. These are Whop's own permission names and Whop can rename them, so match them by what they do. Without ad_campaign:stats:read, for example, campaigns launch fine but Koast can't read results at all, and spend, impressions and clicks stay empty everywhere.
Connect the key
Open Settings and select Your integrations.
Under All integrations, select Whop in Ad platforms. The key dialog opens.
Paste the key into Company API key and select Connect.
The Whop tab opens on "Choose the Whop ad account you want to integrate with…". Pick the account from Ad account.
Select Confirm Selection. The page refreshes.
If the brand you're in already runs a Meta ad account, Koast puts the Whop account in a new brand of its own and switches you to it. Otherwise it lands on the current brand.
Import more Whop ad accounts
Once a brand holds your Whop key, the brand switcher and Settings, Ad Accounts, Add ad account offer Import from Whop next to Import from Meta. Use it to bring in more ad accounts the same key reaches. Each one becomes its own brand.
Import from Whop doesn't appear until you've connected a key in Settings, so start there.
Replace or disconnect the key
The connected tab shows Currently integrated with your ad account, and two actions:
- Replace API Key swaps in a new key, for example one with more permissions.
- Disconnect deletes the stored key. Your ad accounts stay in Koast, but launching, Agent Tasks and reporting for them stop. Ads already live on Whop keep running, and Koast can't pause them until you reconnect. You'll need a new API key to do that, because the old one is gone.
Good to know
- You pay Whop directly. Ad spend on your own Whop account is billed by Whop. Koast doesn't charge it and doesn't need a card or a signed agreement for it.
- Koast doesn't create new Whop ad accounts. You can only connect one you already own. Create new ad account requests a verified Meta ad account instead. See Get a verified ad account in your Business Manager.
- Server-side conversion keys don't work on your own Whop account. The Koast pixel's server-side keys only work on ad accounts Koast created.
- Owners, Admins and Media Buyers can open the Whop tab, the same people who see the Facebook one.