Doordash

Doordash Campaigns API

The Campaigns API from Doordash — 3 operation(s) for campaigns.

GitHub OpenAPI

Operations 5

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}/campaigns Create an ad campaign · Create campaign #
Ask an LLM
“How do I launch a new DoorDash ad campaign with a budget?”
“What is required to create a campaign besides a name?”
Tell an agent
Create a {campaignType} campaign named {name} with budget {budget} starting {startDate}.
Launch a new {campaignType} campaign {name} with a {budget} budget from {startDate} to {endDate}.
PUT /ads/api/v1/{campaignType}/campaigns Update an ad campaign's budget, dates or status · Update campaign #
Ask an LLM
“How do I raise the budget on an existing ad campaign?”
“Can I pause a campaign or change its end date?”
Tell an agent
Set the budget of {campaignType} campaign {campaignId} to {budget}.
Set {campaignType} campaign {campaignId} status to {status}.
GET /ads/api/v1/{campaignType}/campaigns List ad campaigns · Get campaigns #
Ask an LLM
“What ad campaigns do I have running?”
“Can I page through campaigns with a start index and count?”
Tell an agent
List my {campaignType} campaigns.
List {count} {campaignType} campaigns starting at {startIndex}.
GET /ads/api/v1/{campaignType}/campaigns/{campaignId} Get one ad campaign by ID · Get campaign by ID #
Ask an LLM
“What are the settings of one particular campaign?”
“Can I look up one campaign's budget and dates by its ID?”
Tell an agent
Show {campaignType} campaign {campaignId}.
Get the budget and dates of campaign {campaignId} ({campaignType}).
GET /ads/api/v1/campaigns/{campaignId}/recommendations Get budget capout recommendations for a campaign · Get budget capout recommendations #
Ask an LLM
“Is my campaign running out of budget early, and what is recommended?”
“Which budget recommendations exist for a campaign that caps out?”
Tell an agent
Get budget capout recommendations for campaign {campaignId}.
Show the capout report for campaign {campaignId}.

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-campaigns-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-campaigns-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-campaigns-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  version: 1.0.29
  title: DoorDash Ads Campaigns 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: Campaigns
paths:
  /ads/api/v1/{campaignType}/campaigns:
    post:
      tags:
      - Campaigns
      operationId: createCampaign
      summary: Create campaign
      description: Create a single campaign.
      parameters:
      - $ref: '#/components/parameters/campaignType'
      requestBody:
        description: A campaign to create.
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateCampaignRequest'
      responses:
        '200':
          description: Success.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CampaignResponse'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '500':
          $ref: '#/components/responses/InternalServerError'
    put:
      tags:
      - Campaigns
      operationId: updateCampaign
      summary: Update campaign
      description: Update a single campaign.
      parameters:
      - $ref: '#/components/parameters/campaignType'
      requestBody:
        description: A partial campaign object used to update an existing campaign.
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateCampaignRequest'
      responses:
        '200':
          description: Success.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CampaignResponse'
        '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:
      - Campaigns
      operationId: getCampaigns
      summary: Get campaigns
      description: Get a list of campaigns.
      parameters:
      - $ref: '#/components/parameters/startIndex'
      - $ref: '#/components/parameters/count'
      - $ref: '#/components/parameters/campaignType'
      responses:
        '200':
          description: Success.
          content:
            application/json:
              schema:
                type: object
                required:
                - campaigns
                properties:
                  campaigns:
                    description: List of campaigns.
                    type: array
                    items:
                      $ref: '#/components/schemas/CampaignResponse'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '500':
          $ref: '#/components/responses/InternalServerError'
  /ads/api/v1/{campaignType}/campaigns/{campaignId}:
    get:
      tags:
      - Campaigns
      operationId: getCampaignById
      summary: Get campaign by ID
      description: Get a single campaign by the provided identifier.
      parameters:
      - $ref: '#/components/parameters/campaignType'
      - name: campaignId
        in: path
        description: Unique identifier for a campaign
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CampaignResponse'
        '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'
  /ads/api/v1/campaigns/{campaignId}/recommendations:
    get:
      tags:
      - Campaigns
      operationId: getBudgetCapoutRecommendations
      summary: Get budget capout recommendations
      description: Get budget capout report and recommendations for the provided campaign ID.
      parameters:
      - $ref: '#/components/parameters/campaignId'
      responses:
        '200':
          description: Success.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BudgetCapoutRecommendationsResponse'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '500':
          $ref: '#/components/responses/InternalServerError'
components:
  schemas:
    DayOfWeek:
      type: string
      enum:
      - MONDAY
      - TUESDAY
      - WEDNESDAY
      - THURSDAY
      - FRIDAY
      - SATURDAY
      - SUNDAY
      - UNSPECIFIED
    CampaignResponse:
      required:
      - campaignId
      - name
      - description
      - status
      - statusDescription
      - code
      - codeDescription
      - campaignType
      - budget
      - startDate
      - endDate
      - placementType
      - permission
      properties:
        campaignId:
          $ref: '#/components/schemas/CampaignId'
        name:
          $ref: '#/components/schemas/Name'
        description:
          $ref: '#/components/schemas/Description'
        status:
          $ref: '#/components/schemas/StatusRead'
        statusDescription:
          $ref: '#/components/schemas/StatusDescription'
        code:
          $ref: '#/components/schemas/Code'
        codeDescription:
          $ref: '#/components/schemas/CodeDescription'
        campaignType:
          $ref: '#/components/schemas/CampaignType'
        budget:
          $ref: '#/components/schemas/BudgetRead'
        startDate:
          $ref: '#/components/schemas/StartDate'
        endDate:
          $ref: '#/components/schemas/EndDate'
        placementType:
          $ref: '#/components/schemas/PlacementType'
        permission:
          $ref: '#/components/schemas/Permission'
    Name:
      description: Resource name.
      type: string
    Permission:
      required:
      - isReadOnly
      - message
      properties:
        isReadOnly:
          description: Indicates whether a campaign is read-only through the API
          type: boolean
        message:
          description: Description of the campaign permission
          type: string
    PacingStrategy:
      description: Controls how the budget is distributed over the campaign duration.
      type: string
      enum:
      - DEMAND
      - UNSPECIFIED
      x-enumDescriptions:
        DEMAND: Spend more of the budget when traffic is high, and less when traffic is low.
        UNSPECIFIED: Specify to use the default pacing strategy.
    CampaignId:
      description: Unique campaign identifier.
      type: string
    MonetaryFields:
      required:
      - unitAmount
      - currency
      properties:
        unitAmount:
          description: Integer representing a monetary value in cents.
          type: number
        currency:
          description: Monetary value currency
          type: string
          enum:
          - USD
        displayString:
          description: Monetary value formatted for display
          type: string
        decimalPlaces:
          description: Monetary value currency decimal places
          type: number
        symbol:
          description: Monetary value symbol
          type: string
    CampaignType:
      description: The advertising product managed by this campaign.
      type: string
      enum:
      - SPONSORED_PRODUCTS
    Code:
      description: An enumerated success or error code for machine use.
      type: string
    CreateCampaignRequest:
      required:
      - name
      - campaignType
      - budget
      - startDate
      properties:
        name:
          $ref: '#/components/schemas/Name'
        description:
          $ref: '#/components/schemas/Description'
        budget:
          $ref: '#/components/schemas/BudgetWrite'
        startDate:
          $ref: '#/components/schemas/StartDate'
        endDate:
          $ref: '#/components/schemas/EndDate'
    BudgetRead:
      required:
      - daily
      - lifetime
      properties:
        daily:
          allOf:
          - $ref: '#/components/schemas/MonetaryFieldsExtended'
          - type: object
            description: A daily budget for the campaign
        lifetime:
          allOf:
          - $ref: '#/components/schemas/MonetaryFieldsExtended'
          - type: object
            description: A lifetime budget for the campaign
        pacingStrategy:
          $ref: '#/components/schemas/PacingStrategy'
    UpdateCampaignRequest:
      required:
      - campaignId
      properties:
        campaignId:
          $ref: '#/components/schemas/CampaignId'
        name:
          $ref: '#/components/schemas/Name'
        description:
          $ref: '#/components/schemas/Description'
        status:
          $ref: '#/components/schemas/StatusWrite'
        budget:
          $ref: '#/components/schemas/BudgetWrite'
        startDate:
          $ref: '#/components/schemas/StartDate'
        endDate:
          $ref: '#/components/schemas/EndDate'
    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
    StatusDescription:
      description: Description of the resource is in current state.
      type: string
    CodeDescription:
      description: A human-readable description of the code.
      type: string
    DailyCapOutTime:
      type: object
      properties:
        dayOfWeek:
          $ref: '#/components/schemas/DayOfWeek'
        capOutTime:
          type: number
        maximumLiveHours:
          type: number
    BudgetWrite:
      properties:
        daily:
          description: Daily budget for the campaign
          properties:
            unitAmount:
              description: Integer representing a monetary value in cents.
              type: number
        lifetime:
          description: Lifetime budget for the campaign
          properties:
            unitAmount:
              description: Integer representing a monetary value in cents.
              type: number
        pacingStrategy:
          $ref: '#/components/schemas/PacingStrategy'
          description: 'Used to opt into or out of Optimized Pacing. In updates without a pacingStrategy specified, the existing pacingStrategy will be preserved.

            * `DEMAND` - Spend more of the budget when traffic is high, and less when traffic is low. Requires daily budget to be set.

            * `UNSPECIFIED` - Specify to opt out of Optimized Pacing and use the default pacing strategy.

            '
      minProperties: 1
      description: At least one of daily or lifetime budget must be configured.
    StatusRead:
      description: Current resource state.
      type: string
      enum:
      - INCOMPLETE
      - IN_REVIEW
      - SCHEDULED
      - ACTIVE
      - PAUSED
      - ENDED
      - DRAFT
      - REJECTED
      - CANCELLED
    RecommendedBudget:
      type: object
      properties:
        avgCapOutTimeLast7Days:
          type: number
        recommendedBudget:
          $ref: '#/components/schemas/MonetaryFields'
        totalMissedSalesLast7Days:
          $ref: '#/components/schemas/MonetaryFields'
        dailyCapOutTime:
          type: array
          items:
            $ref: '#/components/schemas/DailyCapOutTime'
    EndDate:
      description: End date for the resource to stop running. The format of the date is yyyy-MM-dd HH:mm:ss.
      type: string
      example: '2025-12-01 00:00:00'
    PlacementType:
      description: Specifies how all ad groups for the campaign will specify placement type details.
      type: string
      enum:
      - AUTOMATIC
      - MANUAL
    StartDate:
      description: Start date for the resource to go live. The format of the date is yyyy-MM-dd HH:mm:ss.
      type: string
      example: '2025-11-01 00:00:00'
    BudgetCapoutRecommendationsResponse:
      type: object
      properties:
        adEntityId:
          type: string
          description: ''
        type:
          type: string
          description: ''
        value:
          $ref: '#/components/schemas/RecommendedBudget'
    StatusWrite:
      description: Current resource state.
      type: string
      enum:
      - ACTIVE
      - PAUSED
      - ENDED
    Description:
      description: Resource description.
      type: string
    MonetaryFieldsExtended:
      required:
      - unitAmount
      - currency
      - displayString
      - decimalPlaces
      - symbol
      - symbolPlacement
      - sign
      properties:
        unitAmount:
          description: Integer representing a monetary value in cents.
          type: number
        currency:
          description: Monetary value currency
          type: string
          enum:
          - USD
        displayString:
          description: Monetary value formatted for display
          type: string
        decimalPlaces:
          description: Monetary value currency decimal places
          type: number
        symbol:
          description: Monetary value symbol
          type: string
        symbolPlacement:
          description: Monetary value symbol placement
          type: string
          enum:
          - left
          - right
        sign:
          description: True indicates the monetary value is positive. False indicates the monetary value is negative.
          type: boolean
  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
    campaignId:
      name: campaignId
      in: path
      description: Unique identifier for a campaign
      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}'.