Doordash

Doordash Product Ads API

The Product Ads API from Doordash — 1 operation(s) for product ads.

GitHub OpenAPI

Operations 3

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

POST /ads/api/v1/{campaignType}/productAds Add a product to an ad group as an ad · Create product ad #
Ask an LLM
“How do I add a product to an ad group as a product ad?”
“Can I mark a product ad as priority?”
Tell an agent
Create a {campaignType} product ad for product {productId} ({idType}) in ad group {adGroupId} of campaign {campaignId}.
Advertise product {productId} ({idType}) as a priority ad in ad group {adGroupId}, campaign {campaignId}, {campaignType}.
GET /ads/api/v1/{campaignType}/productAds List product ads · Get product ads #
Ask an LLM
“Which product ads are in my campaigns?”
“Can I filter product ads by ad group?”
Tell an agent
List {campaignType} product ads.
List product ads in ad group {adGroupIds} for {campaignType}.
DELETE /ads/api/v1/{campaignType}/productAds Remove a product ad from an ad group · Delete product ad #
Ask an LLM
“How do I remove a product from an ad group?”
“Can I delete one product ad without deleting its ad group?”
Tell an agent destructive · confirm first
Delete the {campaignType} product ad for product {productId} in ad group {adGroupId} of campaign {campaignId}.
Stop advertising product {productId} in ad group {adGroupId} ({campaignType}).

Documentation

📖
APIReference
https://developer.doordash.com/en-US/api/ads
📖
APIReference
https://developer.doordash.com/en-US/api/storefront
📖
APIReference
https://developer.doordash.com/en-US/api/drive_v2_parcel
📖
Documentation
https://developer.doordash.com/en-US/docs/drive/how_to/Parcel/error_handling
📖
APIReference
https://developer.doordash.com/en-US/api/drive_refunds
📖
APIReference
https://developer.doordash.com/en-US/api/drive_redelivery
📖
APIReference
https://developer.doordash.com/en-US/api/drive_dasher_feedback
📖
APIReference
https://developer.doordash.com/en-US/api/external_checkout
📖
APIReference
https://developer.doordash.com/en-US/api/marketplace_legacy
📖
Documentation
https://developer.doordash.com/en-US/docs/marketplace/faq/legacy_partner_migration

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/doordash/refs/heads/main/openapi/doordash-product-ads-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/doordash-product-ads-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

doordash-product-ads-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  version: 1.0.29
  title: DoorDash Ads Product Ads API
  description: DoorDash Ads API for Sponsored Products for campaign management and reporting operations.
servers:
- url: https://openapi.doordash.com
security:
- Ads API Key Authentication: []
tags:
- name: Product Ads
paths:
  /ads/api/v1/{campaignType}/productAds:
    post:
      tags:
      - Product Ads
      operationId: createProductAd
      summary: Create product ad
      description: Create a single product ad the provided campaign and ad group IDs.
      parameters:
      - $ref: '#/components/parameters/campaignType'
      requestBody:
        description: A product ad to create.
        content:
          application/json:
            schema:
              type: object
              $ref: '#/components/schemas/CreateProductAdRequest'
      responses:
        '200':
          description: Success.
          content:
            application/json:
              schema:
                description: The created product ad.
                $ref: '#/components/schemas/ProductAdResponse'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '500':
          $ref: '#/components/responses/InternalServerError'
    get:
      tags:
      - Product Ads
      operationId: getProductAds
      summary: Get product ads
      description: Get a list of product ads, optionally filtered by campaign IDs and/or adGroup IDs.
      parameters:
      - $ref: '#/components/parameters/campaignType'
      - $ref: '#/components/parameters/startIndex'
      - $ref: '#/components/parameters/count'
      - name: campaignIdFilter
        in: query
        description: A comma-delimited list of campaign identifiers. At least one of campaignIdFilter and adGroupIdFilter is required.
        required: false
        schema:
          type: string
      - name: adGroupIdFilter
        in: query
        description: A comma-delimited list of ad group identifiers. At least one of campaignIdFilter and adGroupIdFilter is required.
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Success.
          content:
            application/json:
              schema:
                type: object
                required:
                - productAds
                properties:
                  productAds:
                    description: List of product ads
                    type: array
                    items:
                      $ref: '#/components/schemas/ProductAdResponse'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '500':
          $ref: '#/components/responses/InternalServerError'
    delete:
      tags:
      - Product Ads
      operationId: deleteProductAd
      summary: Delete product ad
      description: Delete a single product ad by the provided identifier.
      parameters:
      - $ref: '#/components/parameters/campaignType'
      requestBody:
        description: The identifier of an existing product ad.
        content:
          application/json:
            schema:
              type: object
              required:
              - campaignId
              - adGroupId
              - idType
              - productId
              properties:
                campaignId:
                  $ref: '#/components/schemas/CampaignId'
                adGroupId:
                  $ref: '#/components/schemas/AdGroupId'
                idType:
                  $ref: '#/components/schemas/ProductIdType'
                productId:
                  $ref: '#/components/schemas/ProductId'
      responses:
        '200':
          description: Success.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeleteProductAdResponse'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '500':
          $ref: '#/components/responses/InternalServerError'
components:
  schemas:
    IsPriority:
      description: Indicates pinned product for Sponsored Brand campaigns.
      type: boolean
      default: false
    CampaignId:
      description: Unique campaign identifier.
      type: string
    AdGroupId:
      description: Unique ad group identifier.
      type: string
    ProductIdType:
      description: Product ID type
      type: string
      enum:
      - GTIN_14
      - UPC
      - DD_SIC
    Code:
      description: An enumerated success or error code for machine use.
      type: string
    Error:
      properties:
        code:
          description: An enumerated error for machine use.
          type: string
          readOnly: true
        details:
          description: A human-readable description of the error.
          type: string
          readOnly: true
    CodeDescription:
      description: A human-readable description of the code.
      type: string
    DeleteProductAdResponse:
      required:
      - campaignId
      - adGroupId
      - idType
      - productId
      - code
      - codeDescription
      - ddSic
      - upcs
      - gtin14s
      properties:
        campaignId:
          $ref: '#/components/schemas/CampaignId'
        adGroupId:
          $ref: '#/components/schemas/AdGroupId'
        idType:
          $ref: '#/components/schemas/ProductIdType'
        productId:
          $ref: '#/components/schemas/ProductId'
        ddSic:
          description: DoorDash product identifier.
          type: string
        code:
          $ref: '#/components/schemas/Code'
        codeDescription:
          $ref: '#/components/schemas/CodeDescription'
        upcs:
          type: array
          items:
            type: string
        gtin14s:
          type: array
          items:
            type: string
    CreateProductAdRequest:
      required:
      - campaignId
      - adGroupId
      - idType
      - productId
      properties:
        campaignId:
          $ref: '#/components/schemas/CampaignId'
        adGroupId:
          $ref: '#/components/schemas/AdGroupId'
        idType:
          $ref: '#/components/schemas/ProductIdType'
        productId:
          $ref: '#/components/schemas/ProductId'
        isPriority:
          $ref: '#/components/schemas/IsPriority'
    ProductAdResponse:
      required:
      - campaignId
      - adGroupId
      - idType
      - productId
      - ddSic
      - upcs
      - gtin14s
      properties:
        campaignId:
          $ref: '#/components/schemas/CampaignId'
        adGroupId:
          $ref: '#/components/schemas/AdGroupId'
        idType:
          $ref: '#/components/schemas/ProductIdType'
        productId:
          $ref: '#/components/schemas/ProductId'
        ddSic:
          description: DoorDash product identifier.
          type: string
        isPriority:
          $ref: '#/components/schemas/IsPriority'
        upcs:
          type: array
          items:
            type: string
        gtin14s:
          type: array
          items:
            type: string
    ProductId:
      description: Unique product identifier based on product ID type.
      type: string
  responses:
    InternalServerError:
      description: One or more query parameters contained an invalid value.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Forbidden:
      description: Forbidden.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Unauthorized:
      description: Unauthorized.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    NotFound:
      description: The requested resource was not found.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    BadRequest:
      description: Bad request.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  parameters:
    startIndex:
      name: startIndex
      in: query
      description: 0-indexed record offset for the result set. Defaults to 0.
      schema:
        type: number
        default: 0
    campaignType:
      name: campaignType
      in: path
      description: Indicates campaign type. 'sp' for Sponsored Products or 'sb' for Sponsored Brand
      required: true
      schema:
        type: string
    count:
      name: count
      in: query
      description: Number of records to include in the paged response.
      required: false
      schema:
        type: number
  securitySchemes:
    Ads_API_Key_Authentication:
      type: apiKey
      scheme: bearer
      in: header
      name: Authorization
      description: We will be using stateful token based API keys to authenticate clients, passed in the 'Authorization' header as 'Bearer {API_KEY}'.