Update Existing Ad Group

Make changes in an existing ad group.

🌐

URL: PUT/api/v1/adGroups

Query Parameters

ParameterDescriptionTypeRequiredPossible Values
adGroupIdThe ID of the ad group. Required only if updating existing ad groupintegerYUnique numeric identifier
nameThe name of the ad groupstringNRelevant string value representing the ad group
statusSpecified status of ad groupstringNStatus values can be:
  • enabled
  • disabled
  • deleted

Sample Request

curl -X PUT \
'https://developer.api.stg.walmart.com/api-proxy/service/WPA/Api/v1/api/v1/adGroups' \
--header 'Authorization: Bearer <auth_token>'\ --header 'accept: application/json' \
--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' \
--data ' { "adGroupId": 500044, "name": "AdGroup 5", "status": "enabled” }'

Response

ElementDescriptionType
codeShows status of the ad group update operation Values: success, failurestring
detailsDetails of the updatestring
adGroupIdId of the ad group being updatedinteger

Sample Response

[ { "code": "success", "details": "", "adGroupId": 500003 } { "code": "failure", "details": " Ad Group Id validation failed", "adGroupId": 0 }
]