# Integrate X (Twitter) Ads with Databox

X Ads (formerly Twitter Ads) is the paid advertising platform on X, enabling businesses to promote content across the X feed to targeted audiences based on interests, keywords, follower lookalikes, and demographics. Campaigns span awareness, engagement, and conversion objectives, with performance tracked at the campaign, ad group, and creative level. Connecting X Ads to Databox lets you pull that performance data into dashboards and reports alongside your other paid channels, so you can monitor spend efficiency, compare channel results, and share insights with stakeholders without logging into the platform.

## Connection

### Before you begin

### Step 1: Authorize Databox

To connect X Ads to your Databox account for the [first time](/add-a-connection), you'll be redirected to X to authorize access.

If you've already established a connection, you can [reuse](/add-a-data-source) it to add new accounts, as long as those accounts are accessible with the existing connection's credentials.

On the authorization screen, review the requested permissions and click **Sign In** to grant Databox access to your X Ads data.

x-twitter-ads-oauth-authorization
### Step 2: Select the account

Choose the X Ads account you want to report on. If you manage multiple ad accounts, you'll be prompted to select the specific account you want to connect to Databox.

## ![lock](/assets/lock.2fb1bbc208afcc03d15a0a45f22bdf7f830322016e038e5721965851130807af.419bb737.svg) Datasets

The X (Twitter) Ads integration supports the creation of [datasets](/understanding-datasets), which allow you to structure and format your X (Twitter) Ads data for more flexible reporting in Databox. By organizing your data into a tabular format, datasets make it easier to filter, segment, and visualize key metrics across projects, clients, and team members.

The entity relationship diagram (ERD) below illustrates how data is organized within the X (Twitter) Ads integration, displaying the available **views** and **columns**, as well as the relationships between them (primary and foreign keys). This diagram represents the **schema**, or structure, of the data and helps you understand the underlying data model. With this context, you can create datasets using the relevant views and columns to build custom metrics tailored to your reporting needs.

## Resources

For comprehensive details on metrics, data availability, templates, specifications, usage guidelines, and other key information, refer to the resources listed below.

Databox requests read-only access to your advertising data, including campaigns, audiences, ad account information, and creatives. No changes are made to your campaigns or account settings, and you can revoke access at any time from the **Apps and sessions** section of your X account settings.

 

Ask Genie
Get instant answers or help with your data using the in-app AI assistant.

Talk to an expert
For customers: Get help with your setup, strategy, or making the most of Databox.

Book a demo
New to Databox? See how it works and get guidance on getting started.

Send an email
Reach out to support for help with your account, data, or technical issues.