Loyalty APIs (3.0.0)

Customer loyalty drives successful enterprises, representing the trust and emotional connection consumers develop with brands over time. In today's competitive landscape with evolving customer expectations, retaining existing customers is as crucial as attracting new ones. Our Customer Loyalty API revolutionizes customer engagement by enabling seamless integration of loyalty programs into your applications, websites, and platforms. This solution empowers businesses of all sizes with personalized experiences, targeted rewards, and data-driven insights to enhance customer lifetime value. This documentation guides you through integration with detailed explanations, endpoints, examples, and best practices suitable for both newcomers and experienced developers.

Key Features-

Customer Enrollment - Easily register customers with minimal API calls

Points and Rewards Management - Track points and incentivize engagement

Personalized Promotions - Create targeted offers based on individual preferences

Data Analytics - Gain insights into customer behavior for informed decisions

Security and Compliance - Protect customer data with robust security measures

Seamless Integration - Compatible with various platforms for hassle-free implementation

Download OpenAPI description
Languages
Servers

https://s15.socialannex.net/api/3.0/

Users

Welcome to the User API Documentation for Annex Cloud! This comprehensive guide is designed to empower developers, administrators, and system integrators with the knowledge and tools necessary to seamlessly interact with our loyalty platform's user-related functionalities. As the cornerstone of our customer engagement ecosystem, the Users API enables you to effortlessly manage user profiles, personalize experiences, and unlock the full potential of our loyalty solutions.

Whether you're aiming to integrate user registration into your application, retrieve user information for tailored experiences, or track user activity for insightful analytics, this documentation will serve as your compass in navigating the world of user management within our loyalty-based framework. We understand that your technical expertise is as unique as the experiences you aim to deliver to your users, and that's why we've crafted this guide to be both informative for newcomers and insightful for seasoned developers.

By leveraging the power of the User API, you'll gain the ability to create, update, and retrieve user profiles, harnessing valuable data to drive loyalty strategies and cultivate lasting relationships. From conceptual overviews to in-depth endpoints and practical examples, we've curated a resource that not only imparts technical know-how but also encourages innovation and creativity in building user-centric solutions.

Thank you for choosing Annex Cloud as your partner in loyalty solutions.

Operations

Points

Welcome to the Points API documentation for Annex Cloud, your gateway to unlocking a world of loyalty-based rewards and customer engagement. In this comprehensive guide, we'll walk you through the powerful capabilities of our Points API, designed to seamlessly integrate with your systems and empower you to create unforgettable experiences for your customers.

At Annex Cloud, we understand that building lasting relationships with your customers is at the core of your business. Our Points API provides you with the tools to effortlessly implement a robust loyalty program that not only drives customer retention but also enhances brand affinity. Whether you're a developer looking to integrate our API or a business leader seeking to harness the potential of loyalty rewards, this documentation will equip you with the knowledge and insights needed to succeed.

From awarding points for purchases and referrals to offering personalized rewards and exclusive perks, our Points API puts the control in your hands. With clear and concise endpoints, accompanied by code samples and real-world use cases, you'll be able to quickly grasp the API's functionality and start building innovative loyalty solutions that set you apart in today's competitive market.

Get ready to embark on a journey that goes beyond transactions. Let's dive into the intricacies of the Points API, where creativity meets technology to redefine the way you connect with your customers and drive sustainable business growth.

Operations

Action

Welcome to the Action API Documentation for Annex Cloud! We understand that crafting an exceptional loyalty program involves more than just rewarding points—it's about creating dynamic and engaging experiences for your customers. Our Loyalty Actions API is your gateway to elevating your loyalty program, allowing you to design and implement meaningful interactions that resonate with your audience. The Loyalty Actions API by Annex Cloud is a powerful tool designed to help you go beyond traditional loyalty rewards. With this API, you can:

Drive Customer Engagement- Create interactive and personalized experiences to keep your customers actively involved in your loyalty program.

Enable Real-time Interactions- Implement actions that trigger instantly based on customer behavior, ensuring timely and relevant rewards.

Enhance User Experience- Seamlessly integrate actions into your existing applications, websites, and platforms to provide a cohesive and enjoyable user experience.

Encourage Desired Behaviors- Design and deploy actions that align with your business objectives, encouraging customers to take specific actions that benefit both them and your brand.

At Annex Cloud, we believe in the power of meaningful interactions to strengthen the bond between your brand and your customers. This documentation is your key to unlocking the full potential of our Loyalty Actions API, and we're excited to embark on this journey with you. Thank you for choosing Annex Cloud to enhance your loyalty program, and let's create extraordinary experiences together! Let's get started!

Operations

Activity

Welcome to the Activity API documentation for Annex Cloud! Here, we are excited to guide you through the dynamic world of loyalty-based interactions and engagement. Our Activity API empowers you to seamlessly integrate and enhance your loyalty program with real-time activity tracking, enabling you to craft personalized experiences for your valued customers.

In this comprehensive guide, you will find everything you need to know to leverage the full potential of our Activity API. Whether you are a seasoned developer looking to integrate our API into your existing systems, or a business visionary seeking to create innovative loyalty solutions, we have got you covered.

From tracking points accumulation and rewards redemption to monitoring user interactions and crafting targeted campaigns, our Activity API opens doors to a new realm of customer engagement possibilities. We understand the significance of fostering lasting relationships with your clientele, and this API paves the way for fostering those connections in meaningful and profitable ways.

Through easy-to-follow examples, detailed endpoints, request and response formats, this documentation will empower you to harness the power of our Activity API effectively.

Explore the API, experiment with its capabilities, and unlock the potential to redefine loyalty experiences for your customers. The possibilities are boundless, and the rewards are waiting. Let us get started!

Operations

Tiers

Welcome to the Tiers API Documentation for Annex Clouds cutting-edge loyalty program platform. Our Tiers API empowers developers, businesses, and partners to seamlessly integrate and enhance their applications with our dynamic and customizable loyalty tiers system. This API documentation serves as your comprehensive guide to understanding and implementing the Tiers API, unlocking the full potential of loyalty-driven engagement for your customers.

Whether you are looking to reward long-term patrons, incentivize higher spending, or create personalized experiences for your member base, our Tiers API offers a versatile solution that aligns with your unique business goals. By integrating this API, you can effortlessly design and manage multi-tiered loyalty structures that captivate, engage, and retain your audience, all while enjoying the ease of integration and scalability that our platform provides.

Throughout this documentation, we will delve into the core functionalities of the Tiers API, walking you through the steps to seamlessly incorporate loyalty tiers into your applications. From setting up tier parameters and defining eligibility criteria, to handling tier transitions and leveraging tier-specific benefits, we have got you covered with clear instructions and code examples.

Operations

Rewards

At Annex Cloud, we understand the power of loyalty and the importance of rewarding your customers for their continued support. Our Loyalty Rewards API is designed to help you seamlessly integrate and enhance your loyalty program, making it easier than ever to create engaging, customized, and rewarding experiences for your customers. Using our Rewards API, you can easily access and utilize members' rewards data, allowing you to keep tabs on your loyal customer base, their preferences, and their engagement with your program. Additionally, you can access a comprehensive list of rewards used by your members, providing insights into what incentives are most appealing and effective.

This documentation covers everything you need to get started with our Loyalty Rewards API, including detailed information on available API endpoints and how to use them.

Thank you for choosing Annex Cloud for your loyalty needs, and we look forward to helping you build stronger, more loyal customer relationships.

Operations

Segment

Segment module can be used to differentiate the Users into groups which can be used in other loyalty modules for offers or campaigns. Define segments and conditions and use them to incentivize your members.

Operations

Campaign

Welcome to the Loyalty Program Campaigns API Documentation for Annex Cloud! This comprehensive guide is designed to empower developers, businesses, and stakeholders to seamlessly integrate and leverage our Loyalty Program Campaigns API within their applications and systems.

Our loyalty-based company understands the significance of fostering meaningful relationships with our valued customers. As such, we have crafted a powerful API that enables businesses to create, manage, and optimize loyalty campaigns, driving customer engagement, loyalty, and retention.

Annex Cloud’s Loyalty Program Campaigns API is a robust and flexible tool that facilitates the integration of our loyalty program capabilities into your applications and platforms. Through this API, you can design and execute diverse loyalty campaigns, offering tailored rewards and incentives to your customers based on their actions, purchases, or interactions with your brand.

By integrating our API, you unlock a plethora of benefits:

Customized Loyalty Campaigns: Design unique loyalty campaigns that align with your business goals and resonate with your customer base.

Enhanced Customer Engagement: Drive customer engagement by offering personalized rewards and promotions, enhancing their loyalty and advocacy.

Real-time Performance Insights: Obtain real-time analytics and insights into the performance of your loyalty campaigns, allowing you to optimize strategies for maximum effectiveness.

Seamless Integration: Easily integrate the Loyalty Program Campaigns API into your existing systems, ensuring a smooth and efficient loyalty program management process.

This documentation covers essential aspects, endpoints, request and response examples, and best practices to ensure a seamless integration and utilization of the Loyalty Program Campaigns API. Let's embark on this journey to elevate your loyalty programs and build lasting connections with your cherished customers.

Operations

Get campaign details by User ID and either Campaign ID or Campaign Status

Request

This API is used to get the campaigns details against the user & campaignID.

Bodyapplication/json
Retrieve Campaign Details by Campaign ID and User IDobject
Retrieve Campaign Details by Campaign Status and User IDobject

Custom points are not predefined in the system; instead, they are set and managed based on specific user-defined criteria.

curl -i -X POST \
  https://s15.socialannex.net/api/3.0/campaign \
  -H 'Content-Type: application/json' \
  -d '{
    "Retrieve Campaign Details by Campaign ID and User ID": {
      "userId": "user@domain.com",
      "campaignId": 10007
    },
    "Retrieve Campaign Details by Campaign Status and User ID": {
      "userId": "user@domain.com",
      "campaignStatus": "Active"
    }
  }'

Responses

successful operation

Body
getCampaignByUserAndCampaignIdobject

NOTE 1- The following API response body displays when Super Admin flag - Update API structure to display complete campaign data is “Enabled”. NOTE 2- when Super admin flag - Update API structure to display complete campaign data is “disabled”, the audience object is shown at the header level after the campaignTagline parameter and only the first milestone audience is visible. Therefore, to see the audience details for each milestone the above flag should be enabled.

Response
{ "getCampaignByUserAndCampaignId": { "Campaign Details by Campaign ID and User ID": { … }, "Campaign Details by Campaign Status and User ID": { … } } }

Fetch Campaign Details by Campaign Status

Request

This method retrieves campaign details for campaigns based on the Campaign Status. To retrieve details for all campaigns of any status, use campaign status = all

Path
campaignStatusstringrequired

ALL- Displays details for all campaigns. ACTIVE - Displays details for campaigns for which the Status toggle is ON and the current date falls within the Campaign Period only. INACTIVE - Displays details for campaigns for which the Status toggle is OFF and the current date falls within the Campaign Period only. UPCOMING - Displays details for campaigns for which the current date is earlier than the Campaign Period only. EXPIRED - Displays details for campaigns for which the current date is after the Campaign Period only.

Example: ALL
curl -i -X GET \
  'https://s15.socialannex.net/api/3.0/campaign/{{status}}'

Responses

successful operation

Body
allCampaignDetailsobject

Displays details for campaigns according to the campaignStatus parameter

pagesinteger

Displays the total number of pages.

Example: 7
currentPageinteger

Displays the current page number

Example: 1
Response
{ "allCampaignDetails": { "siteId": "29235480", "campaignId": 6776, "campaignGroupId": 3, "campaignName": "End of Summer", "campaignDateFrom": "2021-08-08T07:00:12+0000", "campaignDateTo": "2021-08-08T07:00:12+0000", "individualValidityEnabled": "No", "campaignImageUrl": "https://summeroffer.com/image", "campaignDescription": "Promotions for Back to School products.", "campaignTerms": "Limited to Gold members. Valid from 8/1/2023 to 8/31/2023.", "campaignTagline": "Best campaign ever.", "audience": { … }, "campaignStatus": "Active", "activationRequired": "No", "campaignGroupName": "Group One", "numberofMilestones": 1, "campaignAttributes": { … }, "campaignCreateDate": "2021-08-08T07:00:12+0000", "campaignUpdateDate": "2021-08-08T07:00:12+0000" }, "pages": 7, "currentPage": 1 }

Fetch Campaign Details by Campaign ID

Request

This method retrieves campaign details for a specific Campaign ID. The user must provide the Campaign ID as a key to fetch all the details of that campaign.

Path
campaignIdintegerrequired

Enter a unique internal Campaign ID.

Example: 123
curl -i -X GET \
  'https://s15.socialannex.net/api/3.0/campaign/{123}'

Responses

successful operation

Body
siteIdstring

Displays the unique internal Site ID.

Example: "29235480"
campaignIdinteger

Displays the unique internal Campaign ID.

Example: 4872
campaignGroupIdinteger

Displays the ID of the campaign group to which the campaign belongs. This parameter is visible only when the "Campaign Group" super admin flag is enabled.

Example: 3
campaignNamestring

Displays the name of the campaign.

Example: "Back to School Savings"
campaignDateFromstring

Displays the date in yyyy-MM-dd'T'HH:mm:ssZ format on which the campaign becomes active.

Example: "2021-08-08T07:00:12+0000"
campaignDateTostring

Displays the date in yyyy-MM-dd'T'HH:mm:ssZ format on which the campaign stops being active.

Example: "2021-08-08T07:00:12+0000"
individualValidityEnabledstring

Displays the status as "Yes" if Apply Individual Validity is ON (enabled), or "No" if Apply Individual Validity is OFF (disabled). For campaigns with “Apply Individual Validity “ enabled, provide start and end dates for each member based on their user ID via individual validity API. Members can only earn benefits during their individual validity period.

Example: "Yes"
campaignImageUrlstring

Displays the URL for the campaign image.

Example: "https://summeroffer.com/image"
campaignDescriptionstring

Displays the description of the campaign in encoded HTML.

Example: "Promotions for Back to School products."
campaignTermsstring

Displays the terms and conditions of the campaign in encoded HTML.

Example: "Limited to Gold members. Valid from 8/1/2023 to 8/31/2023."
campaignTaglinestring

Displays the tagline of the campaign in encoded HTML.

Example: "JTNDcCUzRXBwcHBwcHBwcHBwcHBwcHBwcHBwcHBwcHBwcCUzQyUyRnAlM0UlMEE"
audienceobject

Displays the audience selected for the campaign (segment and tier) [When the Super Admin flag - Update API structure to display complete campaign data is “disabled”, then the audience array appears at the header level as described below.].

campaignStatusstring

Displays the status of the campaign. Active, Inactive, Upcoming or Expired.

Example: "Active"
activationRequiredstring

Displays the status as "Yes" if activation required is ON (enabled), or "No" if activation required is OFF (disabled). If "Activation Required" is enabled, members can achieve the campaign benefits only after activating the campaign through the Activation API.

Example: "Yes"
campaignGroupNamestring

Displays the group selected for the campaign, if any.

Example: "Elite group"
campaignAttributesobject

Displays the campaign data related to the Campaign extended attributes configured for the program. These extended attributes can be configured under Additional Loyalty Settings to capture additional metadata for campaigns.

campaignCreateDatestring

Displays the date in yyyy-MM-dd'T'HH:mm:ssZ format on which the campaign was created.

Example: "2021-08-08T07:00:12+0000"
campaignUpdateDatestring

Displays the date in yyyy-MM-dd'T'HH:mm:ssZ format on which the campaign was last updated.

Example: "2021-08-08T07:00:12+0000"
milestoneobject

Displays an array containing the details of milestones included in the campaign.

campaignBenefitobject

Displays any additional benefit set up for campaign

Response
{ "siteId": "29235480", "campaignId": 4872, "campaignGroupId": 3, "campaignName": "Back to School Savings", "campaignDateFrom": "2021-08-08T07:00:12+0000", "campaignDateTo": "2021-08-08T07:00:12+0000", "individualValidityEnabled": "Yes", "campaignImageUrl": "https://summeroffer.com/image", "campaignDescription": "Promotions for Back to School products.", "campaignTerms": "Limited to Gold members. Valid from 8/1/2023 to 8/31/2023.", "campaignTagline": "JTNDcCUzRXBwcHBwcHBwcHBwcHBwcHBwcHBwcHBwcHBwcCUzQyUyRnAlM0UlMEE", "audience": { "segmentId": "1338d", "segment": "California", "tier": "Silver" }, "campaignStatus": "Active", "activationRequired": "Yes", "campaignGroupName": "Elite group", "campaignAttributes": { "partnerCode": "411211" }, "campaignCreateDate": "2021-08-08T07:00:12+0000", "campaignUpdateDate": "2021-08-08T07:00:12+0000", "milestone": { "name": "Elite Milestone", "description": "Applicable for specific Stores", "type": "Action", "detail": "Purchase", "actionId": 109, "actionDescription": "2x for all purchases made from the Segment listed stores.", "benefitName": "Bonus", "benefitValue": 2, "benefitActiveImageUrl": "MDN Web Docs", "benefitInactiveImageUrl": "MDN Web Docs", "benefitRedemptionDate": "2024-08-08T07:00:12+0000" }, "campaignBenefit": { "campaignBenefitType": "Campaign Bonus Points", "campaignBenefitName": "Even More Bonus Points", "campaignBenefitValue": 100, "campaignBenefitImageUrl": "MDN Web Docs", "campaignBenefitExpirationType": "Rolling", "campaignBenefitExpirationRollingPeriod": "0 days", "campaignBenefitExpirationDate": "2024-08-08T07:00:12+0000" } }

Fetch Campaign Details for all Campaigns for which a member is eligible

Request

This method retrieves all active eligible campaigns for a particular member. The user needs to use a unique user ID as a key to fetch all eligible campaigns for the particular member.

Path
memberIdstringrequired

Enter a unique User ID. This may or may not be the user’s email address.

Example: user@domain.com
curl -i -X GET \
  'https://s15.socialannex.net/api/3.0/users/{user@domain.com}/campaign'

Responses

successful operation

Body
siteIdstring

Displays the unique internal Site ID.

Example: "29235480"
idstring

Displays the member’s unique internal member ID

Example: 252927
emailstring

Displays the member’s email address. This may or may not be the same as the member ID.

Example: "user@domain.com"
firstNamestring

Displays the member’s first name.

Example: "Frank"
lastNamestring

Displays the member’s last name.

Example: "Jones"
userCampaignDetailsobject

Displays an array containing the member’s details for the campaign.

pagesinteger

Displays the total number of pages.

Example: 7
currentPageinteger

Displays the current page number

Example: 1
Response
{ "siteId": "29235480", "id": 252927, "email": "user@domain.com", "firstName": "Frank", "lastName": "Jones", "userCampaignDetails": { "campaignId": 4700, "campaignGroupId": 123, "campaignName": "Back to School Savings", "campaignDateFrom": "2021-08-08T07:00:12+0000", "campaignDateTo": "2021-08-08T07:00:12+0000", "individualValidityEnabled": "Yes", "campaignImageUrl": "https://summeroffer.com/image", "campaignDescription": "Promotions for Back to School products.", "campaignTerms": "Limited to Gold members. Valid from 8/1/2023 to 8/31/2023.", "campaignTagline": "Best Deals ever", "campaignGroupName": "Elite Group", "campaignStatus": "Active", "activationRequired": "Yes", "campaignActivation": { … }, "audience": { … }, "memberCampaignStatus": "Complete", "memberCampaignCompletedDate": "2020-02-25T15:32:00+0000", "campaignAttributes": { … }, "campaignCreateDate": "2021-08-08T07:00:12+0000", "campaignUpdateDate": "2021-08-08T07:00:12+0000", "qualifiedPurchaseCount": "2", "totalPurchaseCount": "5", "milestone": { … }, "campaignBenefit": { … }, "individualValidity": { … } }, "pages": 7, "currentPage": 1 }

Reactivate the campaign to participate in it by using userId and campaignId details

Request

Use this PATCH campaign activation method to reactivate the campaign to participate in it. {Reactivation is required if the member receives individual validity more than one time for a campaign.}

Bodyapplication/json
userIdstringrequired

Enter the unique internal User ID.

Example: "user@domain.com"
campaignIdintegerrequired

Enter a unique internal Campaign ID.

Example: 179
curl -i -X PATCH \
  'https://s15.socialannex.net/api/3.0/campaign/activation/{{memberId}}' \
  -H 'Content-Type: application/json' \
  -d '{
    "userId": "user@domain.com",
    "campaignId": 179
  }'

Responses

successful operation

Body
userIdstring

Displays the unique internal member ID.

Example: "user@domain.com"
campaignIdinteger

Displays the unique internal campaign ID.

Example: 179
campaignNamestring

Displays the name of the campaign.

Example: "Back to School Savings"
campaignDateFromstring

Displays the date in yyyy-MM-dd'T'HH:mm:ssZ format on which the campaign becomes active.

Example: "2024-07-10T15:32:00+0000"
campaignDateTostring

Displays the date in yyyy-MM-dd'T'HH:mm:ssZ format on which the campaign stops being active.

Example: "2024-07-10T15:32:00+0000"
campaignStatusstring

Displays the status of the campaign. Active, Inactive, Upcoming or Expired.

Example: "Active"
activationRequiredstring

Displays the status as "Yes" if activation required is ON (enabled), or "No" if activation required is OFF (disabled). If "Activation Required" is enabled, members can achieve the campaign benefits only after activating the campaign through the Activation API.

Example: "Yes"
activatedstring

Displays the value as “Yes” if the member has activated the campaign successfully.

Example: "Yes"
activatedOnstring

Displays the date in yyyy-MM-dd'T'HH:mm:ssZ format on which the campaign is activated by the member.

Example: "2024-07-10T15:32:00+0000"
individualValidityEnabledstring

Displays the status as "Yes" if Apply Individual Validity is ON (enabled), or "No" if Apply Individual Validity is OFF (disabled). For campaigns with “Apply Individual Validity “ enabled, provide start and end dates for each member based on their user ID via individual validity API. Members can only earn benefits during their individual validity period.

Example: "Yes"
individualValidityStartDatestring

Displays the date in yyyy-MM-dd'T'HH:mm:ssZ format when the individual validity started.

Example: "2024-07-11T15:32:00+0000"
individualValidityEndDatestring

Displays the date in yyyy-MM-dd'T'HH:mm:ssZ format when the individual validity ended.

Example: "2024-07-11T15:32:00+0000"
Response
{ "userId": "user@domain.com", "campaignId": 179, "campaignName": "Back to School Savings", "campaignDateFrom": "2024-07-10T15:32:00+0000", "campaignDateTo": "2024-07-10T15:32:00+0000", "campaignStatus": "Active", "activationRequired": "Yes", "activated": "Yes", "activatedOn": "2024-07-10T15:32:00+0000", "individualValidityEnabled": "Yes", "individualValidityStartDate": "2024-07-11T15:32:00+0000", "individualValidityEndDate": "2024-07-11T15:32:00+0000" }

Activate the campaign to participate in it by using userId and campaignId details

Request

Use this POST campaign activation method to let the member activate the campaign to participate in it.

Bodyapplication/json
userIdstringrequired

Enter the unique internal member ID.

Example: "user@domain.com"
campaignIdintegerrequired

Enter a unique internal Campaign ID.

Example: 179
curl -i -X POST \
  https://s15.socialannex.net/api/3.0/campaign/activation \
  -H 'Content-Type: application/json' \
  -d '{
    "userId": "user@domain.com",
    "campaignId": 179
  }'

Responses

successful operation

Body
userIdstring

Displays the unique internal member ID.

Example: "user@domain.com"
campaignIdinteger

Displays the unique internal Campaign ID.

Example: 179
campaignNamestring

Displays the name of the campaign.

Example: "Back to School Savings"
campaignDateFromstring

Displays the date in yyyy-MM-dd'T'HH:mm:ssZ format on which the campaign becomes active.

Example: "2021-08-08T07:00:12+0000"
campaignDateTostring

Displays the date in yyyy-MM-dd'T'HH:mm:ssZ format on which the campaign stops being active.

Example: "2021-08-08T07:00:12+0000"
campaignStatusstring

Displays the status of the campaign. Active, Inactive, Upcoming or Expired.

Example: "Active"
activationRequiredstring

Displays the status as "Yes" if activation required is ON (enabled), or "No" if activation required is OFF (disabled). If "Activation Required" is enabled, members can achieve the campaign benefits only after activating the campaign through the Activation API.

Example: "Yes"
activatedstring

Displays the value as “Yes” if the member has activated the campaign successfully.

Example: "Yes"
activatedOnstring

Displays the date in yyyy-MM-dd'T'HH:mm:ssZ format on which the campaign is activated by the member.

Example: "2024-07-10T15:32:00+0000"
individualValidityEnabledstring

Displays the status as "Yes" if Apply Individual Validity is ON (enabled), or "No" if Apply Individual Validity is OFF (disabled). For campaigns with “Apply Individual Validity “ enabled, provide start and end dates for each member based on their user ID via individual validity API. Members can only earn benefits during their individual validity period.

Example: "Yes"
individualValidityStartDatestring

Displays the date in yyyy-MM-dd'T'HH:mm:ssZ format when the individual validity started.

Example: "2024-07-11T15:32:00+0000"
individualValidityEndDatestring

Displays the date in yyyy-MM-dd'T'HH:mm:ssZ format when the individual validity ended.

Example: "2024-07-11T15:32:00+0000"
Response
{ "userId": "user@domain.com", "campaignId": 179, "campaignName": "Back to School Savings", "campaignDateFrom": "2021-08-08T07:00:12+0000", "campaignDateTo": "2021-08-08T07:00:12+0000", "campaignStatus": "Active", "activationRequired": "Yes", "activated": "Yes", "activatedOn": "2024-07-10T15:32:00+0000", "individualValidityEnabled": "Yes", "individualValidityStartDate": "2024-07-11T15:32:00+0000", "individualValidityEndDate": "2024-07-11T15:32:00+0000" }

To set a personalized individual validity period for a member within the general campaign period

Request

Use this POST campaign individual validity method to send individual validity for each target member in bulk.

Bodyapplication/json
campaignIdintegerrequired

Enter a unique internal Campaign ID.

Example: 179
memberDetailsobject
curl -i -X POST \
  https://s15.socialannex.net/api/3.0/campaign/individualvalidity \
  -H 'Content-Type: application/json' \
  -d '{
    "campaignId": 179,
    "memberDetails": {
      "userId": "user@domain.com",
      "individualValidityStartDate": "2024-07-11T15:32:00+0000",
      "individualValidityEndDate": "2024-07-11T15:32:00+0000"
    }
  }'

Responses

successful operation

Body
siteIdstring

Displays the unique internal Site ID.

Example: "29235480"
campaignIdinteger

Displays the unique internal Campaign ID.

Example: 179
campaignNamestring

Displays the name of the campaign.

Example: "Back to School Savings"
campaignDateFromstring

Displays the date in yyyy-MM-dd'T'HH:mm:ssZ format on which the campaign becomes active.

Example: "2021-08-08T07:00:12+0000"
campaignDateTostring

Displays the date in yyyy-MM-dd'T'HH:mm:ssZ format on which the campaign stops being active.

Example: "2021-08-08T07:00:12+0000"
campaignStatusstring

Displays the status of the campaign. Active, Inactive, Upcoming or Expired.

Example: "Active"
memberDetailsobject

Displays the details of the members.

statusDataobject

Displays the details regarding the status of the campaigns.

Response
{ "siteId": "29235480", "campaignId": 179, "campaignName": "Back to School Savings", "campaignDateFrom": "2021-08-08T07:00:12+0000", "campaignDateTo": "2021-08-08T07:00:12+0000", "campaignStatus": "Active", "memberDetails": { "userId": "user@domain.com", "individualValidityStartDate": "2024-07-11T15:32:00+0000", "individualValidityEndDate": "2024-07-11T15:32:00+0000" }, "statusData": { "total": 1, "success": 1, "failed": 0 } }

Fetch the Campaign Groups

Request

This API method returns the response as per the campaign group status passed, i.e. all, active or inactive.

Path
statusstringrequired

Enter ACTIVE to see all the active campaign groups. Enter INACTIVE to see all the campaign inactive groups and ALL to see all the campaign groups that are present

Example: Active
curl -i -X GET \
  'https://s15.socialannex.net/api/3.0/campaign/group/{Active}'

Responses

successful operation

Body
allCampaignDetailsobject
pagesinteger

Displays the total number of pages for the campaign group response.

Example: 7
currentPageinteger

Displays the current page number on which the campaign group information is displayed.

Example: 7
Response
{ "allCampaignDetails": { "siteId": "29235480", "campaignGroupId": 3, "campaignGroupName": "Group A", "status": "Active", "rule": "All eligible campaigns should be applied.", "campaignDetails": { … }, "campaignGroupCreateDate": "2024-08-08T07:00:12+0000", "campaignGroupUpdateDate": "2024-08-08T07:00:12+0000" }, "pages": 7, "currentPage": 7 }

Fetch details of specific Campaign Group

Request

This method allows users to retrieve detailed information about a campaign group by specifying a unique Campaign Group ID.

Path
campaignGroupIdintegerrequired

Enter the campaign group ID.

Example: 123
curl -i -X GET \
  'https://s15.socialannex.net/api/3.0/campaign/group/{123}'

Responses

successful operation

Body
siteIdstring

Displays the unique internal Site ID.

Example: "29235480"
campaignGroupIdinteger

Displays the campaign group ID.

Example: 123
campaignGroupNamestring

Display the name of the campaign group.

Example: "Group B"
statusstring

Displays the campaign group status.

Example: "Active"
rulestring

Displays the selected precedence rule..

Example: "All eligible campaigns should be applied."
campaignDetailsobject

Displays the details of all campaigns linked to the campaign group.

campaignGroupCreateDatestring

Displays the date in yyyy-MM-dd'T'HH:mm:ssZ format on which the campaign group was created.

Example: "2024-08-08T07:00:12+0000"
campaignGroupUpdateDatestring

Displays the date in yyyy-MM-dd'T'HH:mm:ssZ format on which the campaign group was last updated.

Example: "2024-08-08T07:00:12+0000"
Response
{ "siteId": "29235480", "campaignGroupId": 123, "campaignGroupName": "Group B", "status": "Active", "rule": "All eligible campaigns should be applied.", "campaignDetails": { "campaignId": 4700, "campaignName": "Campaign A", "campaignSequenceNumber": 1, "campaignDateFrom": "2020-03-25T15:32:00+0000", "campaignDateTo": "2020-03-25T15:32:00+0000", "campaignStatus": "Active", "campaignCreateDate": "2020-03-25T15:32:00+0000", "campaignUpdateDate": "2020-03-25T15:32:00+0000" }, "campaignGroupCreateDate": "2024-08-08T07:00:12+0000", "campaignGroupUpdateDate": "2024-08-08T07:00:12+0000" }

Orders

Welcome to the Orders API documentation for Annex Cloud, where loyalty and seamless customer experiences converge. This API empowers developers, partners, and integrators to tap into the core of our loyalty-based ecosystem, enabling the creation of innovative and personalized solutions that enhance customer engagement and drive business growth.

In this comprehensive guide, you will find all the essential information needed to integrate with our Orders API seamlessly. Whether you're a seasoned developer seeking to leverage the power of loyalty data or a business owner aiming to enhance customer satisfaction, this documentation will serve as your compass to navigate the world of loyalty-driven transactions.

From placing orders and tracking purchases to utilizing loyalty rewards within the checkout process, the Orders API opens a realm of possibilities. By harnessing this interface, you can craft applications that bridge the gap between exceptional user experiences and business success.

We've designed this documentation to provide clear insights into the capabilities, endpoints, authentication, and best practices for utilizing the Orders API effectively. As you embark on this integration journey, we encourage you to explore the diverse use cases, reference implementations, and code snippets that will help you hit the ground running.

Thank you for choosing Annex Cloud as your partner in delivering unparalleled loyalty experiences. Let's dive into the intricacies of the Orders API and pave the way for loyalty-driven innovation that transforms the way customers interact with your brand.

Operations

BlockList

Welcome to Annex Cloud's Loyalty Blocklist API- a powerful tool designed to fortify the security and integrity of your loyalty program. In the dynamic landscape of customer engagement and rewards, ensuring the trustworthiness of your platform is paramount. Our Blocklist API is crafted to be the guardian of your loyalty ecosystem, providing a robust defense against fraudulent activities, unauthorized access, and other potential threats.

Elevate your loyalty program security with Annex Cloud's Loyalty Blocklist API.

Operations

Product

Welcome to the Annex Cloud Products API Documentation! We're excited to have you here as you explore the powerful tools and capabilities our Loyalty Program offers through this API.

At Annex Cloud, we understand the significance of fostering customer loyalty. Our mission is to help businesses like yours build lasting relationships with their customers by offering engaging and rewarding loyalty programs. Our Products API is a key component of this mission, allowing you to seamlessly integrate our loyalty features into your applications and systems.

This documentation is designed to be your comprehensive guide to using our Products API effectively. Whether you're a seasoned developer looking to dive into the technical details or a business owner seeking to enhance customer engagement, you'll find valuable information here to help you get started and make the most of our loyalty solutions.

To begin using our Products API, you'll need an API key and a clear understanding of how our endpoints work. We've organized this documentation into user-friendly sections, including:

Authentication: Learn how to securely authenticate your requests.

Endpoints: Explore the various API endpoints available and how to use them effectively.

Examples: Find practical examples and use cases to inspire your integration.

We're here to support you on your journey to building a more loyal customer base and boosting your business's success. If you have any questions or need assistance, please don't hesitate to reach out to our dedicated support team.

Thank you for choosing Annex Cloud as your partner in loyalty. Let's work together to create rewarding experiences for your customers.

Operations

Others

At Annex Cloud, we understand the diverse needs of our clients and the dynamic landscape of the loyalty industry. The Others API is crafted to cater to specific requirements that go beyond the standard functionalities, offering you flexibility and customization. Through strategic utilization of Store ID and Site ID, you gain the power to precisely identify and manage various aspects of your loyalty program across different stores and sites. We invite you to delve into the Others API and elevate your loyalty strategy to meet the specific needs of your audience and unlock new dimensions of customer engagement.

Operations

Survey

Welcome to the Survey API documentation for Annex Cloud! This comprehensive guide provides all the essential information and resources needed to integrate and interact with our survey platform programmatically. Our Survey API allows you to seamlessly integrate our powerful survey capabilities into your applications, websites, or systems. With this API, you can create, manage, and retrieve surveys, questions, responses, and more, empowering you to tailor survey experiences that align with your unique requirements. This documentation is designed to assist you in understanding how to leverage our API effectively, enabling you to:

Create Surveys: Dynamically generate surveys with specific questions and formats to suit your needs.

Retrieve Survey Data: Access survey responses and other relevant data for analysis or display.

Manage Surveys and Questions: Edit, delete, or modify existing surveys and questions to maintain an up-to-date and relevant survey structure.

Integrate Seamlessly: Integrate the survey capabilities seamlessly into your existing applications or platforms to collect valuable insights.

The subsequent sections will guide you through the necessary steps, providing examples and explanations to facilitate a smooth integration process.

Operations

Store

Welcome to the Store API documentation for Annex Cloud! We are thrilled to walk you through the exciting world of loyalty-based interactions and engagement. Our Store API allows you to seamlessly integrate and enhance your loyalty program by tracking real-time store details, enabling you to create personalized experiences for your valued customers.

The Store API is used to create stores in bulk, update the information of the created stores, and fetch all the details of the existing stores. Each store is identified by a unique store ID, which distinguishes it from other stores.

Operations

Hierarchy Management

Welcome to the Hierarchy Management API documentation for Annex Cloud! We are thrilled to walk you through the exciting world of loyalty-based interactions and engagement. Our Hierarchy Management API allows you to seamlessly integrate and enhance your loyalty program by tracking real-time Hierarchy Management details, enabling you to create personalized experiences for your valued customers.

The API methods covered in this document will enable you to create new groups, manage the activities of existing groups, and retrieve group details.

Operations

Issuance

Welcome to the Annex Cloud Issuance API documentation, where loyalty and seamless customer experiences converge. This comprehensive guide provides everything you need to seamlessly integrate with our transaction/issuance API. Whether you’re an experienced developer leveraging loyalty data or a business owner enhancing customer satisfaction, this documentation will guide you through the world of loyalty-driven transactions.

The Order API lacks the ability to handle specific dynamic attributes during order creation. To address this limitation, we have introduced the Issuance API, designed to store and process orders. Unlike the Order API, this new API does not include predefined calculations and mirrors the functionalities of the Order API.

Clients who would like to leverage more dynamic order attributes using the Issuance API will need to first calculate the points for spending and determine how members earn points. They will then send this value to our API, which should then accept it and grant the corresponding benefits based on the received payload.

Operations

Receipt

At Annex Cloud, we recognize the significance of loyalty and the value of rewarding your customers for their ongoing support. Our Loyalty Receipts API is designed to help you seamlessly integrate and enhance your loyalty program by enabling receipt upload, verification, and reward management, making it easier than ever to create engaging, customized, and rewarding experiences for your customers.

This documentation covers all aspects of the receipt upload and verification process. Once a receipt is successfully verified, members will earn points that they can redeem for coupons or use to purchase products based on their preferences.

Thank you for choosing Annex Cloud for your loyalty needs. We look forward to assisting you in building stronger and more loyal customer relationships.

Operations