> ## Documentation Index
> Fetch the complete documentation index at: https://docs.whathead.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Apple Ads Connection Setup

> Connect Apple Ads to Whathead with your Apple ID, or paste Apple Ads API credentials: client ID, team ID, key ID and private key.

There are two ways to connect Apple Ads. **Connect with Apple ID** is recommended and gives Whathead managed advertiser access. **Paste API credentials** is a manual fallback for a direct, advertiser-owned API connection.

## Before you start

* You are the **owner** of your Whathead workspace. Only the workspace owner can connect platforms.
* Your workspace has an active trial or subscription.
* For the manual option, you have created an API user and key pair in your Apple Ads account settings.

## Option 1: Connect with Apple ID (recommended)

**1. Open Integrations**

In Whathead, go to **Integrations** and find the **Apple Ads** card.

**2. Choose Connect with Apple ID**

Select **Connect with Apple ID** and sign in with the Apple ID that has access to your Apple Ads account.

**3. Check your orgs**

Back in Whathead, the connection's **Orgs** tab lists the Apple Ads orgs Whathead synced.

## Option 2: Paste API credentials

**1. Choose Paste API credentials**

On the Apple Ads card, select **Paste API credentials**.

**2. Fill in the form**

| Field | What to enter |
| - | - |
| Label | A name for this connection |
| Client ID | From your Apple Ads API settings |
| Team ID | From your Apple Ads API settings |
| Key ID | From your Apple Ads API settings |
| Default Org ID | Optional. Orgs are also synced from your access list |
| Private Key PEM | The private key that matches the public key you uploaded to Apple Ads |

Client ID, team ID, key ID and private key are required.

**3. Save and check your orgs**

Save the connection. The **Orgs** tab lists the orgs Whathead can reach.

> [!WARNING]
>
> Treat the private key like a password. Only paste it into the Whathead connection form, never into a chat with your AI assistant.

## Related

> [card] [Apple Ads overview](https://docs.whathead.com/platforms/apple-ads/overview.md)
>
> What you can do with Apple Ads in Whathead.

> [card] [Connection issues](https://docs.whathead.com/troubleshooting/connection-issues.md)
>
> General fixes for platform connections.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.