Connecting Apple Search Ads to Whatagraph takes a few more steps than a standard OAuth integration; Apple requires you to set up API access manually and generate a set of credentials before Whatagraph can pull in your data. The whole process takes about 10 minutes. Once it's done, your campaign data will be available to use in reports just like any other source.
Before you start: You'll need Account Administrator access in Apple Search Ads. If you're not an admin, ask whoever manages the account to complete the Apple-side steps (Steps 1–2) and share the three credentials with you.
How to invite an API user in Apple Search Ads
Step 1. Go to Apple Search Ads website and sign in as an Account Administrator.
Step 2. In the top-right corner, open the Users menu and select the account you want to connect to Whatagraph.
Step 3. Go to Account Settings > User Management, then click "Invite Users".
Note: Even if you're already the account admin, you still need to invite yourself (or a dedicated API user) through this flow to generate API credentials. There's no shortcut here - Apple requires it.
Step 4. Fill in the User Details (first name, last name, Apple ID).
Step 5. Under User Access and Role, select API Account Manager.
Important: Do not select API Read Only. That role won't display the public key you need in the next step, and the connection will fail.
Step 6. Click "Send Invite".
Step 7. The invited user (or you, if you invited yourself) will receive an email with a secure activation code. Open the link in the email and enter the code to activate the account.
Tip: Avoid using an incognito window when activating the account or logging in as the API user. Apple's authentication flow can behave unexpectedly in incognito mode.
How to get your API credentials from Apple Search Ads
Step 1. Sign in to Apple Search Ads login page using the API user's credentials.
Step 2. Go to Account Settings > API.
Step 3. In Whatagraph, go to Data Sources, click "+ Connect New Source", and select Apple Search Ads. A setup form will appear with a Public Key - copy it.
Step 4. Back in Apple Search Ads, paste the public key into the Public Key field and click "Save".
Step 5. A block of credentials will appear above the public key field. Copy all three:
clientId
teamId
keyId
How to connect Apple Search Ads in Whatagraph
Step 1. Go back to the Apple Search Ads connector form in Whatagraph's Data Sources section.
Step 2. Enter the clientId, teamId, and keyId you copied from Apple Search Ads.
Step 3. Click "Add an account".
Your Apple Search Ads sources will appear in Data Sources, and data will begin syncing. You can now add them to any report. 🎉