Reddit Ads

There are two separate steps here that are commonly conflated. You need both completed before any API call will work. Step A — Create a Reddit developer app: Go to reddit.com/prefs/apps while logged in to your Reddit account. Click 'Create an app' or 'Create another app'. Give it a name (e.g., 'Bubble Ads Dashboard'). Select the type 'script' — this is for internal server-to-server use where you control both sides. You do not need a redirect URI for the client credentials flow. Click 'Create app'. Note your client_id (shown under the app name, a short alphanumeric string) and generate a client_secret by clicking 'Edit'. Store both securely. Step B — Apply for Reddit Ads API access: Having a developer app is NOT sufficient to call ads-api.reddit.com. You need separate Ads API approval. Go to ads.reddit.com, log in, and look for 'Developer Tools' or 'API Access' in the account settings. Submit an application for API access. Reddit typically approves these in 1-5 business days. Until approval is granted, any call to ads-api.reddit.com returns a 403 with no helpful explanation. Do not proceed with the Bubble configuration until you have received Ads API approval — you cannot test or initialize calls without it.

The Reddit Ads integration requires two separate API Connector entries because the token fetch URL (reddit.com) and the campaign data URL (ads-api.reddit.com) are different domains with different authentication schemes. Entry 1 — 'Reddit Auth': In the API Connector, click 'Add another API'. Name it 'Reddit Auth'. Set Base URL to https://www.reddit.com. Under 'Add a shared header', add: Authorization with value Basic [base64(client_id:client_secret)]. To compute the base64 value, open your browser console and run: btoa('your-client-id:your-client-secret'). Paste the output. The full header value looks like: Basic dXNlcjpwYXNzd29yZA==. Check 'Private' on this header. Add one API call under Reddit Auth named 'get_token': POST /api/v1/access_token. Set 'Use as' to Action. Add a body parameter: grant_type = client_credentials (non-private, static value). Initialize the call after completing Entry 2 setup. Entry 2 — 'Reddit Ads Data': Click 'Add another API'. Name it 'Reddit Ads Data'. Set Base URL to https://ads-api.reddit.com/api/v3. Under 'Add a shared header', add: Authorization with value Bearer [token] — but do NOT mark this Private, because the value is dynamic (it comes from your stored Reddit_Token Data Type at runtime, not a static secret). The client credentials that generate the token are in Entry 1 as Private — the token itself is just a runtime value.

1Entry 1: Reddit Auth
2Base URL: https://www.reddit.com
3Shared Header:
4  Key: Authorization
5  Value: Basic [btoa('client_id:client_secret')]
6  Private: YES
7
8API Call: get_token
9  Method: POST
10  Path: /api/v1/access_token
11  Use as: Action
12  Body param: grant_type = client_credentials
13
14Token response shape:
15{
16  "access_token": "eyJhbGciOi...",
17  "token_type": "bearer",
18  "expires_in": 3600,
19  "scope": "*"
20}
21
22Entry 2: Reddit Ads Data
23Base URL: https://ads-api.reddit.com/api/v3
24Shared Header:
25  Key: Authorization
26  Value: Bearer [dynamic_token_from_data_type]
27  Private: NO (runtime value, not a secret)

The token storage and refresh pattern is the backbone of this integration. Create it before testing any Ads data calls. In Bubble's Data tab, create a new Data Type called 'Reddit_Token' with these fields: - token: Text (the Bearer token string) - expires_at: Date (when the token expires) This Data Type will hold exactly one row — the current active token. You never need more than one. Go to Backend Workflows (left sidebar → Backend Workflows tab). Create a new API Workflow named 'Refresh_Reddit_Token'. This workflow takes no inputs. Step 1: Check if current token is expired. Add a Conditional: 'Only when: Search for Reddit_Token items:first item's expires_at < Current date/time'. This step only runs if the token is expired or missing. Step 2 [Only when expired]: Call API → Reddit Auth - get_token. Result name: new_token. Step 3 [Only when Step 2 ran]: Check if a Reddit_Token record exists. If yes, update it: Make changes to Search for Reddit_Token:first item → set token = Result of Step 2's access_token, expires_at = Current date/time + 3600 seconds. If no, create a new Reddit_Token thing with the same values. In every Bubble Workflow or Backend Workflow that calls Reddit Ads Data, the very first step must be: Schedule API Workflow → Refresh_Reddit_Token → run now (or 'Run directly'). After that step completes, subsequent steps can safely use the stored token.

1Data Type: Reddit_Token
2Fields:
3  - token: Text
4  - expires_at: Date
5
6Backend Workflow: Refresh_Reddit_Token
7Inputs: none
8
9Step 1 [Only when: Search Reddit_Token:first item's expires_at < Current date/time OR Search Reddit_Token count = 0]:
10  Call API → Reddit Auth - get_token
11  Result name: new_token
12
13Step 2 [Only when Step 1 ran, Reddit_Token count > 0]:
14  Make changes to Search Reddit_Token:first item
15    token: new_token's access_token
16    expires_at: Current date/time + 3600 seconds
17
18Step 3 [Only when Step 1 ran, Reddit_Token count = 0]:
19  Create new Reddit_Token
20    token: new_token's access_token
21    expires_at: Current date/time + 3600 seconds

With the token infrastructure in place, add the actual campaign data calls to the 'Reddit Ads Data' API Connector entry. Call 1 — 'get_campaigns': GET /ad_accounts/[account_id]/campaigns Add [account_id] as a dynamic path parameter. In the Authorization header value, type: Bearer followed by a space, then reference the stored token dynamically. In the API Connector, set the Authorization header value to: Bearer [initial_test_token]. For initialization, temporarily use a real access token you generate manually by calling the get_token workflow — copy the returned token and paste it as the header value for initialization only. After initialization, you will update workflows to pull the token from the Reddit_Token Data Type dynamically. Use as: Data. Call 2 — 'get_ad_groups': GET /ad_accounts/[account_id]/ad_groups Same pattern with account_id parameter. Use as: Data. Call 3 — 'get_reports': GET /ad_accounts/[account_id]/reports Add query params: start_time, end_time (ISO 8601 date strings), level (campaign or ad_group), fields (comma-separated metrics: impressions,clicks,spend,cpm,cpc). Use as: Data. Critical note on currency: All spend and bid values in the Reddit Ads API are returned in microdollars (1,000,000 = $1.00). A $5.00 spend appears as 5000000. Always divide these values by 1,000,000 before displaying. In Bubble, use the ':divided by 1000000' operator on the spend field in your text elements and workflows.

1Call 1: GET https://ads-api.reddit.com/api/v3/ad_accounts/[account_id]/campaigns
2Headers: Authorization: Bearer [dynamic: Search Reddit_Token:first item's token]
3Path param: account_id (non-private)
4Use as: Data
5
6Call 2: GET https://ads-api.reddit.com/api/v3/ad_accounts/[account_id]/ad_groups
7Headers: Authorization: Bearer [dynamic: Search Reddit_Token:first item's token]
8Use as: Data
9
10Call 3: GET https://ads-api.reddit.com/api/v3/ad_accounts/[account_id]/reports
11Headers: Authorization: Bearer [dynamic: Search Reddit_Token:first item's token]
12Query params:
13  start_time: 2026-07-01T00:00:00Z (dynamic)
14  end_time: 2026-07-07T23:59:59Z (dynamic)
15  level: campaign
16  fields: impressions,clicks,spend,cpm,cpc
17Use as: Data
18
19Microdollar conversion example:
20  API value: 5000000 → Display: 5000000 / 1000000 = $5.00
21  In Bubble text: Result of Step 1's spend / 1000000 (formatted as $#,##0.00)

Every workflow that calls Reddit Ads data must run the token refresh check first. Here is the complete pattern for a 'Load Campaigns' button: Workflow: 'Load Campaigns' button is clicked Step 1: Schedule API Workflow → Refresh_Reddit_Token, run now. Step 2: Call API → Reddit Ads Data - get_campaigns, account_id = App Constant REDDIT_ADS_ACCOUNT_ID, Authorization header override = 'Bearer ' + Search for Reddit_Token items:first item's token. Step 3: For each campaign in the result, create a 'Campaign' Data Type record (if not already stored) or update the existing one. Fields: campaign_name (text), campaign_id (text), status (text), impressions (number), clicks (number), spend (number — stored as microdollars, converted on display), fetched_date (date). For the Repeating Group displaying campaigns: bind data source to 'Do a search for Campaign items where fetched_date > Current date/time - 1 day, sorted by spend descending'. In the spend text element, add ':divided by 1000000' and format as $#,##0.00. For CTR (click-through rate), compute it dynamically: 'Current cell's Campaign's clicks / Current cell's Campaign's impressions * 100' formatted as a percentage.

1Workflow: Button 'Load Campaigns' clicked
2
3Step 1: Run backend workflow → Refresh_Reddit_Token
4
5Step 2: Call API → Reddit Ads Data - get_campaigns
6  account_id: App Constant 'REDDIT_ADS_ACCOUNT_ID'
7  Authorization: Bearer [Search Reddit_Token:first item's token]
8  Result name: campaigns_result
9
10Step 3 [Repeat for each in campaigns_result's data]:
11  Create or update Campaign record:
12    campaign_id: current item's id
13    campaign_name: current item's name
14    status: current item's status
15    fetched_date: Current date/time
16
17Repeating Group display:
18  Data source: Search Campaign items, sort by spend desc
19  Spend text: Current cell's Campaign's spend / 1000000
20    Format: $#,##0.00
21  CTR text: (Current cell's Campaign's clicks / Current cell's Campaign's impressions) * 100
22    Format: #0.00%

Performance reporting is the most common use case for this integration. The get_reports endpoint returns time-series data for impressions, clicks, spend, CPM, and CPC — all spend values in microdollars. Build a date range selector on your Bubble page using two Date Picker elements: 'Start Date' and 'End Date'. Add a 'Get Report' button with this workflow: Step 1: Refresh_Reddit_Token (same as above). Step 2: Call API → Reddit Ads Data - get_reports, account_id = App Constant, start_time = Start Date Picker's value formatted as ISO 8601, end_time = End Date Picker's value formatted as ISO 8601, level = 'campaign', fields = 'impressions,clicks,spend,cpm,cpc'. Step 3: For each item in the result, create a Report_Snapshot Data Type record: date (text), impressions (number), clicks (number), raw_spend (number in microdollars), cpm (number), cpc (number). In the Repeating Group displaying report data, all spend fields use ':divided by 1000000'. Add summary totals using Bubble's ':sum' operator on the raw_spend field, then divide the sum by 1000000 for the total spend display. A common gotcha: Bubble's Number field type handles up to approximately 15 significant digits. Reddit microdollar values for large campaigns (e.g., $10,000 spend = 10,000,000,000 microdollars) stay within this range safely, but always verify your data type field is set to Number (not Text) to enable arithmetic operations in Bubble.

1Workflow: Button 'Get Report' clicked
2
3Step 1: Run backend workflow → Refresh_Reddit_Token
4
5Step 2: Call API → Reddit Ads Data - get_reports
6  account_id: App Constant 'REDDIT_ADS_ACCOUNT_ID'
7  start_time: StartDatePicker's value (formatted: YYYY-MM-DDTHH:mm:ssZ)
8  end_time: EndDatePicker's value (formatted: YYYY-MM-DDTHH:mm:ssZ)
9  level: campaign
10  fields: impressions,clicks,spend,cpm,cpc
11  Authorization: Bearer [Search Reddit_Token:first item's token]
12
13Step 3: Create Report_Snapshot records from result
14
15Repeating Group totals:
16  Total Spend: Search Report_Snapshot:sum of raw_spend / 1000000
17    Format: $#,##0.00
18  Total Impressions: Search Report_Snapshot:sum of impressions
19  Average CTR: (sum of clicks / sum of impressions) * 100
20    Format: #0.00%