Membership Programs - Create New

Create a new Membership Program for a business (client account). After creating a membership program you can proceed to create multiple membership levels (e.g. Basic, Silver, Gold) for that program.

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

Notes:

• Membership types available: A = Based on Points Accrued (amount of points earned by the customer over a period of time). B = Based on Custom Qualifier (allows you to define a particular activity that is being tracked, example: number of nights that a customer is staying at a hotel).
• Membership customer qualifier name: The membership custom qualifier name is only requierd for membership type "B". Example: membership_custom_qualifier_name= Nights (if you are tracking how many nights a customer needs to stay at a hotel in order to qualify for a higher membership level.)
• Time range: number of days (D), months (M), or years (Y) that you want to include in order to define which customers qualify for each membership level.
• Time unit: D for days, M for months, and Y for years.

Example PHP Request:

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

1. $data['API'] = '1.5';
2. $data['user_id'] = 'john1970';
3. $data['user_api_key'] = '1959caadac9b13dcb3';
4. $data['account_id'] = 'greatwidgets';
5. $data['type'] = 'manage_memberships';
6. $data['action'] = 'new';
7. $data['membership_program_name'] = 'Amazing Rewards'
8. $data['membership_style'] = 'A';
9. $data['membership_time_range'] = '12';
10. $data['membership_time_unit'] = 'M';
11. $data['membership_campaigns_included'] = 'all';

Success XML Response:

1. <response status="success">
2. <membership_program_id>5208143496464281</membership_program_id>
3. </response>

Error XML Response:

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