To use the AdWords API, you must request and be granted access as described below.
Step 1: Choose or create an AdWords manager account
You must have an AdWords manager account to apply for access to the API: If you don't already have one, you'll need to create one by following these instructions for creating a manager account.
Manager accounts cannot be created using the same email address as an existing AdWords account. You must therefore use an email address that hasn't already been associated with an AdWords account to create your manager account.
Note that the manager account you select has no effect on the set of AdWords accounts that your API token can access. However, linking this manager account to your company's active AdWords accounts will streamline the app review process, and reduce the number of times you need to go through the authentication process to manage your accounts via the API. For details, see these instructions for linking accounts.
Step 2: Apply for access to the AdWords API
Sign up for the AdWords API when you're logged in to AdWords with your manager account.
- Click on the vertical ellipsis icon in the top right corner.
- Select Return to previous AdWords in the drop-down menu.
- In the new window, click the gear icon and select Account settings from the drop-down menu.
- Select AdWords API Center from the left menu and follow the instructions to apply for AdWords API access. You'll only see the AdWords API Center link if you've logged in to a manager account.
All fields in the AdWords API Center form must be completed, and the Terms and Conditions accepted. Make sure your information is correct and your company's website URL is functioning: If the website is not a live page, we won't be able to process your application.
Make sure the API contact email you provide leads to a regularly-monitored inbox. If we cannot contact you via this email address, we won't be able to process your application, and it will be rejected. You can edit your API contact email in the AdWords API Center (gear icon > Account settings > AdWords API Center).
We strongly encourage you to keep this information up to date, even after the application process, so we can send you important service announcements.
Step 3: Continue your application
To ensure the tool or software app you propose to use with the AdWords API is in compliance with our Terms and Conditions and Policies, including Required Minimum Functionality (RMF) (if applicable), click the Apply for Basic Access link in the AdWords API Center, and complete the AdWords API Token Application form.
We typically contact you within two business days of the date you submitted your application, at the email address you provided in step 2: If you no longer have access to this inbox, or if you're not planning to actively monitor this email address, edit your email address in the AdWords API Center by following the instructions above in step 2, so we can contact you.
Token Review team has approved my developer token
Your assigned developer token will be activated once your application for API access is approved. Your token will be available through your AdWords API Center—accessible through the Account settings menu for the manager account from which you applied. You'll be able to access the API by including it in your request headers when interacting with our system.
It's very important that you keep your contact email current, as we send important information regarding changes or disruptions to service to the email address you specify.
If you make any changes to your tool in the future, you must report these changes to Google, per the AdWords API Terms and Conditions, section II-5. You may report these changes by filling out this form.
Token Review team has rejected my application
The Token Review team examines the information you provide when you apply for access to the AdWords API, to make sure your software adheres to the AdWords API Terms and Conditions (T&C) as well as the Required Minimum Functionality (RMF) (if applicable).
Common reasons for rejecting an application include:
- We're unable to reach you at the contact email address you provided.
- You have applied because a tool you use from a third party requires a developer token.
- Your application violates other provisions in the Terms and Conditions.
- Your application does not implement required elements of the Required Minimum Functionality (if applicable).
If you have altered your API tool to adhere to AdWords API policy, or if you believe your application was incorrectly rejected, you can reapply by clicking the Reapply link in the AdWords API Center page of your manager account.
If you haven't received an email from us about your application within the expected time, fill out this form.
There is no charge for AdWords API usage. The AdWords API provides two access levels: Basic and Standard.
- This is the default access level for all approved developer tokens. This access level allows developers to execute up to 10,000 operations and 1,000 report downloads per day.
- This access level is for those needing more than 10,000 operations or 1,000 report downloads per day. To qualify for this access level, developers must provide additional details and keep these details current with Google.
For more details about the access levels, see the rate sheet.
Once you've received a developer token, you can start developing and experimenting with the API immediately, even if your token is still pending approval. See Making Your First API Call to get started.