API Queries - Update Campaign Folder

The update_campaign function allows you to change settings or the status of an existing Campaign folder. This function requires additional parameters. Although optional parameters are not all required, at least one must be included. Failing to include required paramters or at least one optional will result in an error response.


Additional Parameters

  • campaign - Name of Campaign folder to update. (Required)
  • active - To Stop or Activate the campaign folder, use values. 0 or 1, respectively (Optional)

Note: Make sure to URL encode all values, especially the campaign name.


Example query and response

In this example, we will be stopping the Campaign folder "Credit Cards".

Example query:

https://bid.trellian.com/api.html?username=user&password=pass&api_key=key&mode=update_campaign&campaign
=
Credit%20Cards&active=0

Note the URL encoding on the values.

Response:

<results> 
<result Setting="Active" Success="1" Value="0" /> 
</results>

The result for the setting update will be shown (represented by Success="1", meaning it was successful). The above response means that the Campaigns folder's status is now stopped (represented by Value="0").


Error Responses:

Possible error responses for this function are:

For a complete list of error responses, see the Error Codes manual page.