# Reddit Ads API Documentation

This is the complete API documentation for connecting to the Reddit Ads API using MindCloud's Universal API.

MindCloud offers one normalized API to access 3,400+ apps from a single place. It centralizes authentication and normalizes app APIs so they are easier and more consistent to use.

## Quickstart

1. A **MindCloud account** — sign in or create an account at [MindCloud](https://app.mindcloud.co).
2. A **MindCloud API Key** — create one in [API Keys](https://app.mindcloud.co/user/api-keys). Keep it on your server.
3. At least one **Reddit Ads connection** — create or choose one in [Connections](https://app.mindcloud.co/credentials). Note its `connectionId`.

```text
POST https://connect.mindcloud.co/v2/universal/apps/redditAds/actions/{actionSlug}/run
```

## Reddit Ads actions

- POST `create-ad` Create Ad
- POST `create-ad-group` Create Ad Group
- POST `create-campaign` Create Campaign
- POST `create-custom-audience` Create Custom Audience
- POST `create-lead-gen-form` Create Lead Gen Form
- POST `create-saved-audience` Create Saved Audience
- GET `get-a-report` Get A Report
- GET `get-ad` Get Ad
- GET `get-ad-account` Get Ad Account
- GET `get-ad-account-history` Get Ad Account History
- GET `get-ad-group` Get Ad Group
- GET `get-business` Get Business
- GET `get-campaign` Get Campaign
- GET `get-custom-audience` Get Custom Audience
- GET `get-last-fired-at` Get Last Fired At
- GET `get-lead-gen-form` Get Lead Gen Form
- GET `get-me` Get Me
- GET `get-saved-audience` Get Saved Audience
- GET `list-ad-accounts-by-business` List Ad Accounts By Business
- GET `list-ad-groups` List Ad Groups
- GET `list-ads` List Ads
- GET `list-campaigns` List Campaigns
- GET `list-devices` List Devices
- GET `list-geolocations` List Geolocations
- GET `list-interests` List Interests
- GET `list-keyword-suggestions` List Keyword Suggestions
- GET `list-lead-gen-forms` List Lead Gen Forms
- GET `list-my-businesses` List My Businesses
- GET `list-pixels-by-ad-account` List Pixels By Ad Account
- GET `list-pixels-by-business` List Pixels By Business
- GET `list-saved-audiences` List Saved Audiences
- GET `list-user-custom-audiences` List User Custom Audiences
- POST `post-conversion-events` Post Conversion Events
- GET `query-ad-accounts` Query Ad Accounts
- GET `search-communities` Search Communities
- PUT `update-ad` Update Ad
- PUT `update-ad-group` Update Ad Group
- PUT `update-campaign` Update Campaign
- PUT `update-custom-audience-users` Update Custom Audience Users
- PUT `update-saved-audience` Update Saved Audience