Delete a Campaign
Removes a campaign from an account, including all customer transactions in it.
The data to be submitted to the API is composed of the following fields:
|
|
field |
|
Example |
|
Note |
|
|
|
user_id |
|
john1970 |
|
Required |
|
|
|
user_password |
|
1959caadac9b13dcb3 |
|
Required |
|
|
|
type |
|
campaign_delete |
|
Required |
|
|
|
action |
|
campaign |
|
Required |
|
|
|
account_id |
|
greatwidgets |
|
Required |
|
|
|
campaign_id |
|
1234567890123456 |
|
Required |
|
|
|
|
|
|
|
|
|
|
|
Output Format: |
|
|
|
output |
|
JSON or XML |
|
Optional. If not provided, defaults to XML |
|
|
|
callback |
|
someFunctionName |
|
Optional: JSONP format |
|
|
|
condensed |
|
yes |
|
Optional (No white space) Applies only to JSON(P) output |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Notes:
- The ability to delete campaigns is based on the permissions of the user_id that is making the call.
- Only one campaign can be deleted at a time. Loop this call in your program to delete multiple campaigns.
- Deactivating a campaign removes it from the list of campaigns that is returned in many other calls, without deleting any data associated with it (settings, customer transactions, etc.) This is often used to "turn off" recurring seasonal campaigns.
Example PHP Request:
If you are using PHP, the $data array would look like this:
- $data['user_id'] = 'john1970';
- $data['user_password'] = '1959caadac9b13dcb3';
- $data['type'] = 'campaign_delete';
- $data['action'] = 'campaign';
- $data['account_id'] = 'greatwidgets';
- $data['campaign_id'] = '1234567890123456';
Success XML Response:
- <response status="success">
- <campaign status="deleted">
- <id>1234567890123456</id>
- </campaign>
- </response>
Error XML Response:
- <response status="error">
- <error>Error message</error>
- </response>
|