--- updatedAt: 2026-07-01T22:35:10.000Z --- # Create new campaign Create a new campaign using this method. Successfully created campaigns will be assigned a unique campaign ID. ### URL: POST /api/v1/campaigns # Query Parameters
Parameter Notes Type Required  Possible Values
name The name of the campaign string Y The campaign name should be unique.
campaignType The type of the campaign string Y Values of campaignType:
  • sponsoredProducts
  • sba
  • video

Note: Define campaign type as “sba” for setting up Sponsored Brands campaigns
  • If you are a 3P seller trying to create Sponsored Brands campaign, you need to have an accepted brand registered in the Walmart brandportal. We will allow you to create a campaign only when you have an accepted brand which will be subject to campaign review guidelines.
  • If your request does not go through, please wait at least 24 hours before trying again.
Define campaign type as “video” for setting up Sponsored Videos campaigns 
  • Please use targeting type “manual” for campaign type “video”
  • If you are a 3P seller trying to create Sponsored Videos campaign, you need to have an accepted brand registered in Walmart brandportal. We will allow you to create a campaign only when you have an accepted brand which will be subject to review as per campaign review guidelines.
  • If your request does not go through, please wait at least 24 hours before trying again.
targetingType The targeting type of the campaign is set of options to create campaigns with different bidding types. string Y Possible values:
  • manual
  • auto
Notes:
  • Define targeting type as “manual” to set up keyword bidding campaigns (including Sponsored Brands)
  • Please refer [here](https://advertisinghelp.walmart.com/s/guides?article=000008379) for more info
status Specified status of campaign string Y Possible values:
  • enabled
  • paused
  • completed
  • Please refer [here](https://developer.walmart.com/doc/us/us-wmc-ads/us-wmc-ads-campaigns/#statusdgm) for more info
startDate The date to start campaign date Y Date should be in format: yyyy-mm-dd
endDate The date when campaign ends. date Y To run campaign indefinitely, set value to: 9999-12-30
totalBudget Total budget of campaign double Note: This field is only required if budgetType is set to total
  • For 1p seller: The value of Total budget should at least be $100
  • For 3p seller: The value of Total budget should at least be $50
dailyBudget  Daily budget of campaign
Note:
  • Daily budget cannot exceed your total budget amount
  • Unspent budget will be rolled over to the next day
  • There is no limit on the amount of daily budget that can carry forward to the next day
 double Y
Note: This field is required only if budgetType is set to either “daily” or “both”
  • For 1p seller: The value of daily budget should at least be $50
  • For 3p seller: The value of daily budget should at least be $10
budgetType The type of budget allocation you want to choose for your campaign. string Y Possible values:
  • daily
  • both
rollover The indicator to suggest if the unspent daily budget from the previous day should be carried forward to next day’s daily budget   boolean Y Currently rollover only accepts “true” as a value. However, in the future it may be updated to accept “false” as well.
biddingStrategy A json object to store the bidding strategy. This stores bidding strategy through the field: strategy json N Possible values:
  • DYNAMIC – Indicates the bidding strategy to be dynamic
  • FIXED – Indicates the bidding strategy to be fixed
Notes:
  • If you don’t pass biddingStrategy in the request, the default strategy will be “FIXED”.
  • biddingStrategy is not applicable for Sponsored Brands and Sponsored Videos.
campaignOptions List of campaign setting options while creating a campaign. Campaign setting options:
  • Brand Term Targeting (BTT)
  • Complementary Product Targeting (CPT)

**Notes:**
  • BTT and CPT are only applicable to Sponsored Search automatic campaigns.
  • All net new automatic campaigns will be opted in to Brand Term Targeting by default.
  • Existing campaigns are opted out of BTT and CPT by default.
 array N Values of campaign options:
  • null
    • Passing a null value will opt in to both Brand Term Targeting AND Complementary Product Targeting
  • \[]
    • Passing an empty array will opt in to both Brand Term Targeting and Complementary Product Targeting
    • New automatic campaigns are set to an empty array by default
  • BRAND\_TERM\_OPT\_OUT
    • This option is used to opt out of Brand Term Targeting
  • COMPLEMENTARY\_OPT\_OUT
    • This option is used to opt out of Complementary Product Targeting


**Note:** **If an empty array \[] or null value is passed for campaignOptions, the campaign will be created with both BTT and CPT opted-in.**
advertiserId ID of advertiser whose campaign is to be scheduled integer Y Advertiser ID for which the campaign is to be created
### Note: * It’s not mandatory to define both totalBudget and dailyBudget parameters together. However, one of these must be defined. * To set daily budget, you must choose value of budgetType as “daily” and then define dailyBudget. Define rollover as true to get remainder of daily budget from previous day to be carried forward to next day * Maximum budget spent on a given day will be limited to twice of the set dailyBudget amount * Currently rollover only accepts “true” as a value. However, in future it may be updated to accept “false” as well. * There will be no control on pacing and the budget will be used as soon as possible ## Headers | Header Name | Description | Required | Values | | ------------------------ | ---------------------------------------------------------------------------------------------------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------ | | Authorization | The token will provide you the access to the API. It is same for all advertisers you access through the API. | Y | Please utilize the generated `auth_token` shared with you at the time of partner onboarding from the Getting Started Guide | | WM\_CONSUMER.ID | We will provide you the consumer ID to access the API. It is same for all advertisers you access through the API.    | Y | Please use the generated `ConsumerId` shared with you at the time of partner onboarding. Refer to the Getting Started Guide for more information | | WM\_SEC.AUTH\_SIGNATURE | Auth signature as an API key. | Y | Use the signature generator code from Getting Started Guide to generate this value | | WM\_SEC.KEY\_VERSION | We will provide you with the KEY VERSION to access the API. It is same for all advertisers you access through the API. | Y | 1 | | WM\_CONSUMER.intimestamp | Timestamp for which the auth signature is generated. Use Unix epoch format for the timestamp. | Y | Use the signature generator code from Getting Started Guide to generate this value | | Content-Type | Format of the message body | Y | application/json |
## Sample Request 1 – Opt in to CPT and BTT (empty campaignOptions), DYNAMIC biddingStrategy ```curl curl -X POST \ 'https://developer.api.stg.walmart.com/api-proxy/service/WPA/Api/v1/api/v1/campaigns' \ --header 'Authorization: Bearer ' \ --header 'WM_SEC.AUTH_SIGNATURE: ***********' \ --header 'WM_SEC.KEY_VERSION: 1' \  --header 'WM_CONSUMER.ID: adfwe-v23-faasd2r-afs-asdfqeff' \ --header 'WM_CONSUMER.intimestamp: 1565309779' \ --header 'Content-Type: application/json' \ --header 'accept: application/json' \ --data ‘[ { "advertiserId": 16274575, "name": "Campaign3", "campaignType": "sponsoredProducts", "targetingType": "auto", "status": "enabled", "startDate": "2024-07-18", "endDate": "2024-08-03", "totalBudget": 4000, "dailyBudget": 500, "budgetType" : "both", "rollover" : true, "biddingStrategy": {         "strategy": "DYNAMIC" }, "campaignOptions": [] } ]’ ``` ## Sample Request 2 – Opt in to CPT and BTT (no campaignOptions field), FIXED biddingStrategy ```curl curl -X POST \ 'https://developer.api.stg.walmart.com/api-proxy/service/WPA/Api/v1/api/v1/campaigns' \ --header 'Authorization: Bearer ' \ --header 'WM_SEC.AUTH_SIGNATURE: ***********' \ --header 'WM_SEC.KEY_VERSION: 1' \  --header 'WM_CONSUMER.ID: adfwe-v23-faasd2r-afs-asdfqeff' \ --header 'WM_CONSUMER.intimestamp: 1565309779' \ --header 'Content-Type: application/json' \ --header 'accept: application/json' \ --data ‘[ { "advertiserId": 16274575, "name": "Campaign3", "campaignType": "sponsoredProducts", "targetingType": "auto", "status": "enabled", "startDate": "2024-07-18", "endDate": "2024-08-03", "totalBudget": 4000, "dailyBudget": 500, "budgetType" : "both", "rollover" : true, "biddingStrategy": { "strategy": "FIXED" }, } ]’ ``` ## Sample Request 3 – Opt out of CPT and BTT ```curl curl -X POST \ 'https://developer.api.stg.walmart.com/api-proxy/service/WPA/Api/v1/api/v1/campaigns' \ --header 'Authorization: Bearer ' \ --header 'WM_SEC.AUTH_SIGNATURE: ***********' \ --header 'WM_SEC.KEY_VERSION: 1' \  --header 'WM_CONSUMER.ID: adfwe-v23-faasd2r-afs-asdfqeff' \ --header 'WM_CONSUMER.intimestamp: 1565309779' \ --header 'Content-Type: application/json' \ --header 'accept: application/json' \ --data ‘[ { "advertiserId": 16274575, "name": "Campaign3", "campaignType": "sponsoredProducts", "targetingType": "auto", "status": "enabled", "startDate": "2024-07-18", "endDate": "2024-08-03", "totalBudget": 4000, "dailyBudget": 500, "budgetType" : "both", "rollover" : true, "biddingStrategy": { “strategy”: “DYNAMIC” }, "campaignOptions": ["COMPLEMENTARY_OPT_OUT, BRAND_TERM_OPT_OUT"] } ]’ ``` ## Sample Request 4 – Opt in CPT, Opt out BTT ```curl curl -X POST \ 'https://developer.api.stg.walmart.com/api-proxy/service/WPA/Api/v1/api/v1/campaigns' \ --header 'Authorization: Bearer ' \ --header 'WM_SEC.AUTH_SIGNATURE: ***********' \ --header 'WM_SEC.KEY_VERSION: 1' \  --header 'WM_CONSUMER.ID: adfwe-v23-faasd2r-afs-asdfqeff' \ --header 'WM_CONSUMER.intimestamp: 1565309779' \ --header 'Content-Type: application/json' \ --header 'accept: application/json' \ --data ‘[ { "advertiserId": 16274575, "name": "Campaign3", "campaignType": "sponsoredProducts", "targetingType": "auto", "status": "enabled", "startDate": "2024-07-18", "endDate": "2024-08-03", "totalBudget": 4000, "dailyBudget": 500, "budgetType" : "both", "rollover" : true, "biddingStrategy": { “strategy”: “DYNAMIC” }, "campaignOptions": ["BRAND_TERM_OPT_OUT"] } ]’ ``` ## Sample Request 5 – Opt out CPT, Opt in BTT ```curl curl -X POST \ 'https://developer.api.stg.walmart.com/api-proxy/service/WPA/Api/v1/api/v1/campaigns' \ --header 'Authorization: Bearer ' \ --header 'WM_SEC.AUTH_SIGNATURE: ***********' \ --header 'WM_SEC.KEY_VERSION: 1' \  --header 'WM_CONSUMER.ID: adfwe-v23-faasd2r-afs-asdfqeff' \ --header 'WM_CONSUMER.intimestamp: 1565309779' \ --header 'Content-Type: application/json' \ --header 'accept: application/json' \ --data ‘[ { "advertiserId": 16274575, "name": "Campaign3", "campaignType": "sponsoredProducts", "targetingType": "auto", "status": "enabled", "startDate": "2024-07-18", "endDate": "2024-08-03", "totalBudget": 4000, "dailyBudget": 500, "budgetType" : "both", "rollover" : true, "biddingStrategy": { “strategy”: “DYNAMIC” }, "campaignOptions": ["COMPLEMENTARY_OPT_OUT"] } ]’ ``` # Response | Element  | Description | Type | | ---------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------- | | code | The response code can have following values:
  • success
  • failure
  • Click [here](/advertising-partners-search/docs/api-status-codes-and-errors-1) for more information about Status Codes and Errors
| string | | details | Details of the error if response code value is ‘failure’ | string | | campaignId | ID of the campaign | integer | ## Sample Response 1 ``` {    "code": "success",    "details": "",    "campaignId": 50001 "campaignOptions": [] } ``` ## Sample Response 2 ``` {    "code": "success",    "details": "",    "campaignId": 50002 "campaignOptions": [] } ``` ## Sample Response 3 ``` {    "code": "success",    "details": "",    "campaignId": 50003 "campaignOptions": ["COMPLEMENTARY_OPT_OUT, BRAND_TERM_OPT_OUT"] } ``` ## Sample Response 4 ``` {    "code": "success",    "details": "",    "campaignId": 50004 "campaignOptions": ["COMPLEMENTARY_OPT_OUT"] } ``` ## Sample Response 5 ``` {     "code": "failure",     "details": "error message",     "campaignId": 0 } ```
# Campaign Status Flow Diagram ![](https://files.readme.io/f99eb7bfc44af2a260773a347a94901398761f935758db54c50f0113122befd0-Sponsored-Search-Campaign-Management-Workflow.png) Note: SB stands for Sponsored Brands campaign