Update Existing BuyX Campaign Item

Update an existing item in a "Buy X Get 1 Free" campaign.

The data to be submitted to the API is composed of the following fields:

Notes:

• The ability to update items is based on the permissions of the user_id that is making the call.
• Only one item can be updated at a time. Loop this call in your program to add multiple items at the same time.
• This call applies only to "Buy X Get 1 Free" campaigns.
• The new_reward_level is the quantity of items that need to be purchased before the next one is free.
• If changing the Item Description by providing a new_item_description this will also update all past transactions so that it will look like previous transactions were for the same newly updated item. To keep the old description just create a new item instead.
• The new_item_identifier is an optional field that lets you specify an item ID such as a SKU.

Example PHP Request:

If you are using PHP, the $data array would look like this:

1. $data['user_id'] = 'john1970';
2. $data['user_password'] = '1959caadac9b13dcb3';
3. $data['type'] = 'campaign_update';
4. $data['action'] = 'item';
5. $data['account_id'] = 'greatwidgets';
6. $data['campaign_id'] = '1234567890123456';
7. $data['item_id'] = '234';
8. $data['new_reward_level'] = '11';
9. $data['new_item_description'] = 'Coffee or Tea';
10. $data['new_item_identifier'] = '1DF345S1';

Success XML Response:

1. <response status="success">
2. <item status="updated">
3. <id>14</id>
4. </item>
5. </response>

Note:

• A successful result will return the item_id of the item. This id can also be retrieved with the Campaign - List BuyX Items API call.

Error XML Response:

1. <response status="error">
2. <error>Error message</error>
3. </response>