---
title: "POST /v1/advertisers/{advertiserId}/campaigns"
method: POST
path: "/v1/advertisers/{advertiserId}/campaigns"
tags: ["Campaigns"]
---

# POST /v1/advertisers/{advertiserId}/campaigns

`POST /v1/advertisers/{advertiserId}/campaigns`

## Path parameters

- `advertiserId` string, required

## Request body

- CampaignCreateRequest
  - `type` string, nullable
  - `name` string, required
  - `budget` number, double, nullable
  - `budgetFrequency` string, nullable
  - `startDate` string, date-time, nullable
  - `endDate` string, date-time, nullable
  - `geo` GeoRequest
    - `states` string[], nullable
    - `cities` CityGeoRequest[], nullable
      - `name` string, required
      - `stateCode` string, required
    - `zips` ZipGeoRequest[], nullable
      - `code` string, required
    - `dmas` integer[], nullable
  - `audience` CampaignAudienceRequest
    - `type` 'Demographic' | 'Retargeting', required
    - `demographicAudience` DemographicAudienceRequest
      - `segments` integer[], nullable
    - `retargetingAudience` RetargetingAudienceRequest
      - `retargetingType` string, nullable
      - `retargetingCampaignIds` string[], nullable
      - `urlParts` string[], nullable
  - `settings` CampaignSettingsRequest
    - `dayparting` DaypartingRequest
      - `sunday` integer[], nullable
      - `monday` integer[], nullable
      - `tuesday` integer[], nullable
      - `wednesday` integer[], nullable
      - `thursday` integer[], nullable
      - `friday` integer[], nullable
      - `saturday` integer[], nullable
    - `frequencyCap` FrequencyCapRequest
      - `maxImpressions` integer
      - `period` string, nullable
  - `internetSettings` InternetSettingsRequest
    - `bidStrategyPresetId` string, nullable
  - `contactEmail` string, nullable
  - `isRetargeting` boolean, nullable

## Response `200`

Success

- CampaignResponseResponse
  - `timestamp` string, date-time
  - `errors` Error[], nullable
    - `code` string, nullable
    - `name` string, nullable
    - `message` string, nullable
    - `description` string, nullable
  - `data` CampaignResponse
    - `id` string, nullable
    - `name` string, nullable
    - `campaignType` string, nullable
    - `status` string, nullable
    - `budget` number, double
    - `budgetFrequency` string, nullable
    - `startDate` string, date-time, nullable
    - `endDate` string, date-time, nullable
    - `geo` GeoResponse
      - `locationTargetType` string, nullable
      - `states` string[], nullable
      - `cities` CityGeoResponse[], nullable
        - `name` string, nullable
        - `stateCode` string, nullable
      - `zips` ZipGeoResponse[], nullable
        - `code` string, nullable
      - `dmas` integer[], nullable
    - `audience` CampaignAudienceResponse
      - `type` 'Demographic' | 'Retargeting'
      - `demographicAudience` DemographicAudienceResponse
        - `segments` SegmentResponse[], nullable
          - `id` integer
          - `name` string, nullable
          - `path` string, nullable
      - `retargetingAudience` RetargetingAudienceResponse
        - `retargetingType` string, nullable
        - `retargetingCampaignIds` string[], nullable
        - `urlParts` string[], nullable
    - `settings` CampaignSettingsResponse
      - `dayparting` DaypartingResponse
        - `sunday` integer[], nullable
        - `monday` integer[], nullable
        - `tuesday` integer[], nullable
        - `wednesday` integer[], nullable
        - `thursday` integer[], nullable
        - `friday` integer[], nullable
        - `saturday` integer[], nullable
      - `frequencyCap` FrequencyCapResponse
        - `maxImpressions` integer
        - `period` string, nullable
    - `internetSettings` InternetSettingsResponse
      - `bidStrategyPresetId` string, nullable
    - `tvSettings` TvSettingsResponse
    - `billboardSettings` BillboardSettingsResponse
    - `audioSettings` AudioSettingsResponse
    - `adIds` string[], nullable
    - `totalIntervals` integer, nullable
    - `intervalsCompleted` integer, nullable
    - `activatedDate` string, date-time, nullable
    - `createdAt` string, date-time
    - `updatedAt` string, date-time

---

[API](https://skmtc.net/adcritter/apis/adcritter-api.md) · [All operations](https://skmtc.net/adcritter/apis/adcritter-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/adcritter/adcritter-api/revisions/d216a4676bdd/schema)