Skip to content
Changelog

Report a bug

Reddit Ads integration: operations for AI agents

Reddit Ads connects to Type.com as an integration. This page lists the 105 operations documented for Claude and Codex in Type.com: 67 read, 33 write, 5 destructive.

About Reddit Ads

Reddit Ads API for managing advertising campaigns, conversions, and account data on Reddit.

Categories: Marketing & Social

How to connect Reddit Ads to Type.com

Access
Organization connection: one shared account for the workspace.

To add the connection, follow the steps in Space connections.

Documented operations

105 operations. Your connection's permissions determine which operations are available. API references describe the vendor surface; they do not expand your connection's credentials or access.

105 operations listed.

Ad Accounts

  • Read

    Get Ad Account

    Retrieve ad account by ID. Rate Limit See the rate limits for Campaign Management Read Policy Slug: ads-campaign-management-read Window: 60 seconds Quota: 400 requests

  • Read

    List Ad Accounts By Business

    Retrieve the ad accounts in a business. Note: Ad accounts shared with the business won't be returned. Rate Limit See the rate limits for Campaign Management Read Policy Slug: ads-campaign-management-read Window: 60 seconds Quota: 400 requests

  • Read

    Query Ad Accounts

    Find ad accounts in a business. Rate Limit See the rate limits for Business Manager Policy Slug: ads-business-manager Window: 60 seconds Quota: 100 requests

  • Write

    Update Ad Account

    Update an ad account. Rate Limit See the rate limits for Campaign Management Write Policy Slug: ads-campaign-management-write Window: 60 seconds Quota: 200 requests

Ad Groups

  • Read

    List Ad Groups

    Retrieve ad groups by ad account. Rate Limit See the rate limits for Campaign Management Read Policy Slug: ads-campaign-management-read Window: 60 seconds Quota: 400 requests

  • Read

    Get Ad Group

    Retrieve an ad group. Rate Limit See the rate limits for Campaign Management Read Policy Slug: ads-campaign-management-read Window: 60 seconds Quota: 400 requests

  • Write

    Create Ad Group

    Create an ad group. For an AUTOMATED Reddit Max ad group, follow the Max campaign setup guide. Important: Starting July 13th, 2026, conversionpixelid is required for all ad groups. Retrieve your Pixel with List Pixels by Ad Account.

  • Write

    Update Ad Group

    Update an ad group. When shoppingtype is DYNAMIC, see the targeting field description for which fields are applied. Rate Limit See the rate limits for Campaign Management Write Policy Slug: ads-campaign-management-write Window: 60 seconds Quota: 200 requests

Ads

  • Read

    List Ads

    Retrieve ads by ad account. Filters combine with logical AND across different query parameters. For multi-value filters, comma-separated values within the same query parameter use logical OR.

  • Read

    Get Ad

    Retrieve an ad. Rate Limit See the rate limits for Campaign Management Read Policy Slug: ads-campaign-management-read Window: 60 seconds Quota: 400 requests

  • Read

    Get Third Party Trackers

    Retrieve domains recognized for click and impression tracking before creating or updating ads. Note: A listed domain does not guarantee that every tracker URL using it is valid.

  • Write

    Create Ad

    Create an ad. For a Reddit Max campaign, create a DYNAMICCREATIVEADTEMPLATE ad as described in the Max campaign setup guide. For catalog sales ads using shoppingcreative, see clickurl for how it is handled.

  • Write

    Update Ad

    Update an ad. For catalog sales ads using shoppingcreative, see clickurl for how it is handled. Rate Limit See the rate limits for Campaign Management Write Policy Slug: ads-campaign-management-write Window: 60 seconds Quota: 200 requests

App

  • Read

    List Apps By Ad Account

    Retrieve mobile app identifiers previously used in app install campaigns. Each returned item includes only the id field (App Store or Google Play identifier).

  • Read

    Get App Last Fired At

    Retrieve the last time App Install events fired for a specific app ID. Rate Limit See the rate limits for Conversion Signals Policy Slug: ads-conversion-signals Window: 60 seconds Quota: 30 requests

Forecasting

  • Read

    Get Channel Planning Reach

    Retrieve a 10-point reach curve at different impression levels based on targeting. Rate Limit See the rate limits for Forecasting Policy Slug: ads-forecasting Window: 60 seconds Quota: 30 requests

  • Write

    Plan Forecasts

    Retrieve audience and delivery forecasts for a campaign plan configuration. Learn about the Campaign Planner. Rate Limit See the rate limits for Forecasting Policy Slug: ads-forecasting Window: 60 seconds Quota: 30 requests

  • Write

    Estimate Audience and Delivery

    Estimate audience size and weekly delivery outcomes for the provided campaign and ad group configurations. Outcomes that don't apply with the selected objective and optimization goal are omitted.

Campaigns

  • Read

    List Campaigns

    Retrieve campaigns by ad account. Rate Limit See the rate limits for Campaign Management Read Policy Slug: ads-campaign-management-read Window: 60 seconds Quota: 400 requests

  • Read

    Get Campaign

    Retrieve a campaign. Rate Limit See the rate limits for Campaign Management Read Policy Slug: ads-campaign-management-read Window: 60 seconds Quota: 400 requests

  • Write

    Create Campaign

    Create a campaign. To create an AUTOMATED Reddit Max campaign, follow the Max campaign setup guide. Important: Starting July 13th, 2026, conversionpixelid is required for all campaign budget optimization campaigns. Retrieve your Pixel with List Pixels by Ad Account.

  • Write

    Update Campaign

    Update a campaign. Rate Limit See the rate limits for Campaign Management Write Policy Slug: ads-campaign-management-write Window: 60 seconds Quota: 200 requests

Custom Audiences

  • Read

    List User Custom Audiences

    Retrieve custom audiences associated with an ad account. Rate Limit See the rate limits for Targeting Taxonomy Policy Slug: ads-targeting-taxonomy Window: 60 seconds Quota: 100 requests

  • Read

    Get Custom Audience

    Retrieve a custom audience. Rate Limit See the rate limits for Targeting Taxonomy Policy Slug: ads-targeting-taxonomy Window: 60 seconds Quota: 100 requests

  • Write

    Create Custom Audience

    Create a custom audience. Learn more about managing custom audiences.

  • Write

    Update Custom Audience Users

    Update users in a custom audience. Limited to 2,500 userdata entries per request. Learn more about managing custom audiences.

  • Destructive

    Delete Custom Audience

    Delete a custom audience. Rate Limit See the rate limits for Custom Audiences Ingestion Policy Slug: ads-custom-audience-ingestion Window: 900 seconds Quota: 3000 requests Policy Slug: ads-custom-audience-ingestion-burst Window: 60 seconds Quota: 500 requests

Data Deletion

  • Read

    Get Data Deletion Job Status

    Retrieve the current status of a data deletion job. Deletions are processed daily, so poll once per day until the job reaches COMPLETED or FAILED. View the polling guidance.

  • Write

    Create Data Deletion Job

    Create an asynchronous job to delete ads-related data for supported user identifiers. Prefer pre-hashed identifiers when supported. Learn more about deleting user data . Rate Limit See the rate limits for Ads Privacy Policy Slug: ads-privacy Window: 60 seconds Quota: 60 requests

  • Write

    Create Pixel Data Deletion Job

    Create an asynchronous data deletion job for a Pixel. Requires business admin access to the Pixel’s owning business. Prefer pre-hashed identifiers when supported. Learn more about deleting user data .

Funding Instruments

  • Read

    List Funding Instruments

    Retrieve funding instruments used by an ad account. Rate Limit See the rate limits for Billing Policy Slug: ads-funding-instruments Window: 60 seconds Quota: 30 requests

  • Read

    Query Funding Instruments by Business

    Find funding instruments in a business. Rate Limit See the rate limits for Billing Policy Slug: ads-funding-instruments Window: 60 seconds Quota: 30 requests

  • Read

    Get Child Funding Instruments

    Retrieve funding instrument allocations. Rate Limit See the rate limits for Billing Policy Slug: ads-funding-instruments Window: 60 seconds Quota: 30 requests

Ad Account History

  • Read

    Get Ad Account History

    Retrieve the changelog for an ad account. Tip: Send an empty JSON object ({}) to return all changes made to the ad account. Rate Limit See the rate limits for Business Manager Policy Slug: ads-business-manager Window: 60 seconds Quota: 100 requests

Lead Generation Forms

  • Read

    List Lead Generation Forms

    Retrieve the lead generation forms in an ad account. Rate Limit See the rate limits for Leads Policy Slug: ads-leads Window: 60 seconds Quota: 20 requests

  • Read

    Get Lead Generation Form

    Retrieve a lead generation form. Rate Limit See the rate limits for Leads Policy Slug: ads-leads Window: 60 seconds Quota: 20 requests

Pixels

  • Read

    List Pixels By Ad Account

    Retrieve Pixels associated with an ad account. Important: Starting July 13th, 2026, a Pixel is required for all ad groups and CBO campaigns. If no Pixels are currently associated with your ad account, set up your Pixel in the Events Manager.

  • Read

    List Pixels By Business

    Retrieve Pixels associated with a business. Rate Limit See the rate limits for Conversion Signals Policy Slug: ads-conversion-signals Window: 60 seconds Quota: 30 requests

  • Read

    Get Last Fired At

    Retrieve the last time a Pixel was fired for conversion events (ISO 8601). Rate Limit See the rate limits for Conversion Signals Policy Slug: ads-conversion-signals Window: 60 seconds Quota: 30 requests

  • Write

    Post Conversion Events

    Post conversion events from a specific action source. Event deduplication applies only for events in the same channel. Learn more about setting up CAPI events. Important: The values for several fields—such as trackingtype—are different in CAPI v3. Learn how to migrate from v2.

Profiles

  • Read

    List Profiles By Ad Account

    Retrieve profiles associated with an ad account. Rate Limit See the rate limits for Business Manager Policy Slug: ads-business-manager Window: 60 seconds Quota: 100 requests

  • Read

    List Profiles By Business

    Retrieve profiles associated with a business. Rate Limit See the rate limits for Business Manager Policy Slug: ads-business-manager Window: 60 seconds Quota: 100 requests

  • Read

    Get Profile

    Retrieve profile by ID. Rate Limit See the rate limits for Business Manager Policy Slug: ads-business-manager Window: 60 seconds Quota: 100 requests

Reports

  • Read

    Get A Report

    Generate a metrics report for up to 3 breakdowns (4 with country and region) based on the fields you provide. Reports provide detailed insights and analytics on ad performance, audience engagement, and other relevant metrics. Note: Top combinations aren't currently supported.

Saved Audiences

  • Read

    List Saved Audiences

    List saved audiences. Rate Limit See the rate limits for Campaign Management Read Policy Slug: ads-campaign-management-read Window: 60 seconds Quota: 400 requests

  • Read

    Get Saved Audience

    Retrieve a saved audience. Rate Limit See the rate limits for Campaign Management Read Policy Slug: ads-campaign-management-read Window: 60 seconds Quota: 400 requests

  • Write

    Create Saved Audience

    Create a saved audience in an ad account. Rate Limit See the rate limits for Campaign Management Write Policy Slug: ads-campaign-management-write Window: 60 seconds Quota: 200 requests

  • Write

    Update Saved Audience

    Update a saved audience. Rate Limit See the rate limits for Campaign Management Write Policy Slug: ads-campaign-management-write Window: 60 seconds Quota: 200 requests

SKAd Network

  • Read

    Get SKAdNetwork Availability

    Retrieve the SKAdNetwork (SKAD) IDs availability quota for an app. Learn more about SKAD IDs. iOS App Install active limits 10 campaigns per app ID (shared across all ad accounts) 5 ad groups per campaign 10 ads per ad group

Businesses

  • Read

    Get Business

    Retrieve business by ID. Rate Limit See the rate limits for Business Manager Policy Slug: ads-business-manager Window: 60 seconds Quota: 100 requests

  • Read

    List Industries

    List supported industries. Rate Limit See the rate limits for Business Manager Policy Slug: ads-business-manager Window: 60 seconds Quota: 100 requests

  • Read

    List My Businesses

    Retrieve all businesses associated with the authenticated user. Apply filters to narrow results by the user's access. Rate Limit See the rate limits for Business Manager Policy Slug: ads-business-manager Window: 60 seconds Quota: 100 requests

  • Write

    Update Business

    Update business by ID. Rate Limit See the rate limits for Business Manager Policy Slug: ads-business-manager Window: 60 seconds Quota: 100 requests

Product Catalogs

  • Read

    List Product Catalogs

    Retrieve details for all catalogs for your business. Rate Limit See the rate limits for Product Catalog Policy Slug: ads-product-catalog Window: 300 seconds Quota: 7000 requests Policy Slug: ads-product-catalog-burst Window: 60 seconds Quota: 3000 requests

  • Read

    List Catalog Import Issues

    Retrieve a list of the catalog's import issues. See troubleshooting and catalog requirements for more details.

  • Read

    Get Catalog Import Report

    Retrieve metadata for a specific catalog import. Access the URL to download details on product processing statuses and issues.

  • Read

    Get Product Catalog

    Retrieve a catalog. Rate Limit See the rate limits for Product Catalog Policy Slug: ads-product-catalog Window: 300 seconds Quota: 7000 requests Policy Slug: ads-product-catalog-burst Window: 60 seconds Quota: 3000 requests

  • Read

    List Catalog Imports

    Retrieve all imports for a catalog. Rate Limit See the rate limits for Product Catalog Policy Slug: ads-product-catalog Window: 300 seconds Quota: 7000 requests Policy Slug: ads-product-catalog-burst Window: 60 seconds Quota: 3000 requests

  • Read

    List Product Feeds

    Retrieve metadata for all feeds in a catalog. Rate Limit See the rate limits for Product Catalog Policy Slug: ads-product-catalog Window: 300 seconds Quota: 7000 requests Policy Slug: ads-product-catalog-burst Window: 60 seconds Quota: 3000 requests

  • Read

    List Product Sets

    Retrieve all product sets in a catalog. Rate Limit See the rate limits for Product Catalog Policy Slug: ads-product-catalog Window: 300 seconds Quota: 7000 requests Policy Slug: ads-product-catalog-burst Window: 60 seconds Quota: 3000 requests

  • Read

    List Products In Product Catalog

    Retrieve all products in a catalog. Rate Limit See the rate limits for Product Catalog Policy Slug: ads-product-catalog Window: 300 seconds Quota: 7000 requests Policy Slug: ads-product-catalog-burst Window: 60 seconds Quota: 3000 requests

  • Read

    Get Product Feed

    Retrieve metadata for a specific feed. Rate Limit See the rate limits for Product Catalog Policy Slug: ads-product-catalog Window: 300 seconds Quota: 7000 requests Policy Slug: ads-product-catalog-burst Window: 60 seconds Quota: 3000 requests

  • Read

    Get Product Set

    Retrieve metadata for a specific product set. Rate Limit See the rate limits for Product Catalog Policy Slug: ads-product-catalog Window: 300 seconds Quota: 7000 requests Policy Slug: ads-product-catalog-burst Window: 60 seconds Quota: 3000 requests

  • Read

    List Products In Product Set

    Retrieve all products in a product set. Rate Limit See the rate limits for Product Catalog Policy Slug: ads-product-catalog Window: 300 seconds Quota: 7000 requests Policy Slug: ads-product-catalog-burst Window: 60 seconds Quota: 3000 requests

  • Write

    Create Product Catalog

    Create a new product catalog. Finish setup by manually creating products or linking a product feed.

  • Write

    Update Product Catalog

    Change a catalog's name or attached Pixel ID. Rate Limit See the rate limits for Product Catalog Policy Slug: ads-product-catalog Window: 300 seconds Quota: 7000 requests Policy Slug: ads-product-catalog-burst Window: 60 seconds Quota: 3000 requests

  • Write

    Create Product Feed

    Set up a new feed for a catalog. Each catalog can contain up to 2 feeds, but they must be of different types.

  • Write

    Create Product Set

    Create a new product set in a catalog. Rate Limit See the rate limits for Product Catalog Policy Slug: ads-product-catalog Window: 300 seconds Quota: 7000 requests Policy Slug: ads-product-catalog-burst Window: 60 seconds Quota: 3000 requests

  • Write

    Batch Delete Products

    Delete multiple products in a catalog. Important: This action can't be undone. Note: If using a schedule feed, update your feed to ensure your catalog is up to date.

  • Write

    Batch Create Products

    Create multiple products in a catalog. View our catalog requirements. Note: If using a schedule feed, update your feed to ensure your catalog is up to date.

  • Write

    Update Product Feed

    Change a feed's metadata. Rate Limit See the rate limits for Product Catalog Policy Slug: ads-product-catalog Window: 300 seconds Quota: 7000 requests Policy Slug: ads-product-catalog-burst Window: 60 seconds Quota: 3000 requests

  • Write

    Update Product Set

    Change a specific product set's name and filters. Rate Limit See the rate limits for Product Catalog Policy Slug: ads-product-catalog Window: 300 seconds Quota: 7000 requests Policy Slug: ads-product-catalog-burst Window: 60 seconds Quota: 3000 requests

  • Destructive

    Delete Product Catalog

    Delete a catalog. Important: This action can't be undone. Rate Limit See the rate limits for Product Catalog Policy Slug: ads-product-catalog Window: 300 seconds Quota: 7000 requests Policy Slug: ads-product-catalog-burst Window: 60 seconds Quota: 3000 requests

  • Destructive

    Delete Product Feed

    Delete a feed in a catalog. Important: This action can't be undone. Rate Limit See the rate limits for Product Catalog Policy Slug: ads-product-catalog Window: 300 seconds Quota: 7000 requests Policy Slug: ads-product-catalog-burst Window: 60 seconds Quota: 3000 requests

  • Destructive

    Delete Product Set

    Delete your product set. Important: This action can't be undone. Rate Limit See the rate limits for Product Catalog Policy Slug: ads-product-catalog Window: 300 seconds Quota: 7000 requests Policy Slug: ads-product-catalog-burst Window: 60 seconds Quota: 3000 requests

Creative Assets

  • Read

    Get Creative Asset Upload

    Retrieve the processing status of 1 creative asset upload. The response includes the resulting asset after processing completes. Use List Creative Asset Uploads to monitor multiple uploads. Returns 404 Not Found when the upload ID is unavailable, deleted, or not pollable.

  • Read

    Get Creative Asset

    Fetch metadata for your creative asset. Learn about the asset library. Rate Limit See the rate limits for Creative Management Policy Slug: ads-creative-management Window: 60 seconds Quota: 200 requests

  • Read

    List Creative Assets

    Retrieve all creative assets associated with your profile. Learn how to use the asset library. Rate Limit See the rate limits for Creative Management Policy Slug: ads-creative-management Window: 60 seconds Quota: 200 requests

  • Read

    List Creative Asset Uploads

    Poll the processing status of one or more creative asset uploads. Nonexistent or deleted upload IDs are omitted from the response. Rate Limit See the rate limits for Creative Management Policy Slug: ads-creative-management Window: 60 seconds Quota: 200 requests

  • Write

    Update Creative Asset

    Update the creative asset's name in the asset library. Rate Limit See the rate limits for Creative Management Policy Slug: ads-creative-management Window: 60 seconds Quota: 200 requests

  • Write

    Create Creative Asset Uploads

    Start processing 1 or more creative assets for storage in the asset library. The response provides an upload ID for each accepted asset. Use List Creative Asset Uploads to monitor multiple uploads, or Get Creative Asset Upload to monitor 1 upload and retrieve the completed asset.

  • Destructive

    Delete Creative Asset

    Delete a creative asset from the asset library. Rate Limit See the rate limits for Creative Management Policy Slug: ads-creative-management Window: 60 seconds Quota: 200 requests

Bid Suggestions

  • Write

    Generate Bid Suggestion

    Retrieve bid suggestions based on recent auction outcomes for a given set of targeting, budget, and bidding parameters. Use the suggested range to choose a competitive bid.

Creative Generator

  • Read

    Get Generated Posters Job

    Retrieve the status and results of a poster generation job made with Create Generated Posters Job. Poll while status is PROCESSING. Poster outputs are available when status is SUCCESS; failures are reported as FAILED.

  • Write

    Create Generated Posters Job

    Start an asynchronous poster generation job from an externally hosted video URL. Poll Get Generated Posters Job for the status and results. Note: Create is not idempotent—retries after ambiguous client timeouts may create additional jobs.

Members

  • Read

    Get Me

    Retrieve the authenticated actor. Rate Limit See the rate limits for Business Manager Policy Slug: ads-business-manager Window: 60 seconds Quota: 100 requests

Posts

  • Read

    List Post Creative Assets

    List creative assets associated with a post. Use the returned asset IDs for asset-level reporting. Results can include repeated asset relationships. Rate Limit See the rate limits for Creative Management Policy Slug: ads-creative-management Window: 60 seconds Quota: 200 requests

Structured Posts

  • Read

    List Structured Posts

    Retrieve structured posts by profile. Rate Limit See the rate limits for Creative Management Policy Slug: ads-creative-management Window: 60 seconds Quota: 200 requests

  • Read

    Get Structured Post Creation Job

    Retrieve a structured post creation job. Rate Limit See the rate limits for Creative Management Policy Slug: ads-creative-management Window: 60 seconds Quota: 200 requests

  • Read

    Get Structured Post

    Retrieve a structured post. Rate Limit See the rate limits for Creative Management Policy Slug: ads-creative-management Window: 60 seconds Quota: 200 requests

  • Write

    Create Structured Post Creation Job

    Create a structured post creation job. Rate Limit See the rate limits for Creative Management Policy Slug: ads-creative-management Window: 60 seconds Quota: 200 requests

  • Write

    Update Structured Post

    Modify allowcomments on an existing structured post. Create another structured post to change other parts of the ad, such as the headline or assets. Rate Limit See the rate limits for Creative Management Policy Slug: ads-creative-management Window: 60 seconds Quota: 200 requests

Targeting

  • Read

    List Carriers

    Retrieve details on targetable carriers. Rate Limit See the rate limits for Targeting Taxonomy Policy Slug: ads-targeting-taxonomy Window: 60 seconds Quota: 100 requests

  • Read

    List Communities

    Retrieve details on targetable communities. Rate Limit See the rate limits for Targeting Taxonomy Policy Slug: ads-targeting-taxonomy Window: 60 seconds Quota: 100 requests

  • Read

    Search Communities

    Find targetable communities based on their name or topic. Rate Limit See the rate limits for Targeting Taxonomy Policy Slug: ads-targeting-taxonomy Window: 60 seconds Quota: 100 requests

  • Read

    List Communities Suggestions

    Retrieve suggested communities based on keywords and/or a website. Rate Limit See the rate limits for Targeting Taxonomy Policy Slug: ads-targeting-taxonomy Window: 60 seconds Quota: 100 requests

  • Read

    List Devices

    Retrieve details on targetable devices. Rate Limit See the rate limits for Targeting Taxonomy Policy Slug: ads-targeting-taxonomy Window: 60 seconds Quota: 100 requests

  • Read

    List Geolocations

    Retrieve details on targetable geolocations. Rate Limit See the rate limits for Targeting Taxonomy Policy Slug: ads-targeting-taxonomy Window: 60 seconds Quota: 100 requests

  • Read

    List Interests

    Retrieve details on targetable interests. Rate Limit See the rate limits for Targeting Taxonomy Policy Slug: ads-targeting-taxonomy Window: 60 seconds Quota: 100 requests

  • Read

    List Keyword Suggestions

    Retrieve keyword suggestions seeded from a list of input terms. Each suggestion includes its monthly view count. Rate Limit See the rate limits for Keyword Suggestions Policy Slug: ads-keyword-suggestions Window: 60 seconds Quota: 100 requests

  • Read

    List Languages

    Retrieve details on targetable languages. Rate Limit See the rate limits for Targeting Taxonomy Policy Slug: ads-targeting-taxonomy Window: 60 seconds Quota: 100 requests

  • Read

    List Third-Party Audiences

    Retrieve details on supported third-party audiences. Rate Limit See the rate limits for Targeting Taxonomy Policy Slug: ads-targeting-taxonomy Window: 60 seconds Quota: 100 requests

  • Write

    Do Geolocation Validations

    Verify whether certain geolocations are targetable. Invalid geolocations will return an error message. Rate Limit See the rate limits for Targeting Taxonomy Policy Slug: ads-targeting-taxonomy Window: 60 seconds Quota: 100 requests

  • Write

    Do Keyword Validations

    Validate whether certain keywords are targetable. Rate Limit See the rate limits for Targeting Taxonomy Policy Slug: ads-targeting-taxonomy Window: 60 seconds Quota: 100 requests

Time Zones

  • Read

    List Time Zones

    List supported time zones. Rate Limit See the rate limits for Campaign Management Read Policy Slug: ads-campaign-management-read Window: 60 seconds Quota: 400 requests

See How connections work for access and permissions, or browse all integrations.