Create New Campaign Promotion

Add a new promotion to an existing Points-based campaign.

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

Notes:

• The ability to create promotions is based on the permissions of the user_id that is making the call.
• The promo_amount is based on the promo_operation chosen:
  • The "x" operation is a multiplier, so the promo_amount given will multiply the amount of points earned. For example:
    • A value of "1.25" is equivalent to adding 25% more points (100pts becomes 125pts)
    • A value of "0.5" is quivlaent to having the amount of points earned (100pts becomes 50pts)
  • The "+" operation adds the promo_amount to the points earned. For example:
    • A value of "100" will add 100 points to the amount of points earned.
    • A value of "-50" will subtract 50 points from the amount of points earned.
• The promo_description is required in order to properly show some decriptive text in lists of promotions.
• Only one promotion can be added at a time. Loop this call in your program to add multiple promotions at the same time.

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_new';
4. $data['action'] = 'promo';
5. $data['account_id'] = 'greatwidgets';
6. $data['campaign_id'] = '1234567890123456';
7. $data['promo_operation'] = 'x';
8. $data['promo_amount'] = '1.25';
9. $data['promo_description'] = 'Pre-booking bonus (25%)';

Success XML Response:

1. <response status="success">
2. <campaign>
3. <promo>
4. <id>14</id>
5. </promo>
6. </campaign>
7. </response>

Note:

• A successful result will return the promo_id of the promotion. This id can also be retrieved with the Campaign - List Promotions API call.

Error XML Response:

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