Talon.One API
- API version:
Use the Talon.One API to integrate with your application and to manage applications and campaigns:
- Use the operations in the Integration API section are used to integrate with our platform
- Use the operation in the Management API section to manage applications and campaigns.
The API is available at the same hostname as your Campaign Manager deployment.
For example, if you access the Campaign Manager at https://yourbaseurl.talon.one/
,
the URL for the updateCustomerSessionV2 endpoint
is https://yourbaseurl.talon.one/v2/customer_sessions/{Id}
Automatically generated by the OpenAPI Generator
Building the API client library requires:
- Java 1.7+
- Maven/Gradle
To install the API client library to your local Maven repository, simply execute:
mvn clean install
To deploy it to a remote Maven repository instead, configure the settings of the repository and execute:
mvn clean deploy
Refer to the OSSRH Guide for more information.
Add this dependency to your project's POM:
<dependency>
<groupId>one.talon</groupId>
<artifactId>talon-one-client</artifactId>
<version>9.1.0</version>
<scope>compile</scope>
</dependency>
Add this dependency to your project's build file:
compile "one.talon:talon-one-client:9.1.0"
At first generate the JAR by executing:
mvn clean package
Then manually install the following JARs:
target/talon-one-client-9.1.0.jar
target/lib/*.jar
Please follow the installation instruction and execute the following Java code:
Note: The Integration API's V1 Update customer session
and Update customer profile
endpoints are now deprecated. Use their V2 instead. See Migrating to V2 for more information.
package com.example.consumer;
import com.google.gson.Gson;
import one.talon.ApiClient;
import one.talon.api.IntegrationApi;
import one.talon.api.ManagementApi;
import one.talon.model.*;
import java.util.*;
public class TalonApiTest {
public static void main(String[] args) {
Gson gson = new Gson();
IntegrationApi iApi = new IntegrationApi(new ApiClient("api_key_v1"));
// Setup: basePath
iApi.getApiClient().setBasePath("https://yourbaseurl.talon.one");
// Setup: when using 'api_key_v1', set apiKey & apiKeyPrefix must be provided
iApi.getApiClient().setApiKeyPrefix("ApiKey-v1");
iApi.getApiClient().setApiKey("dbc644d33aa74d582bd9479c59e16f970fe13bf34a208c39d6c7fa7586968468");
try {
// Creating a cart item object
CartItem cartItem = new CartItem();
cartItem.setName("Hawaiian Pizza");
cartItem.setSku("pizza-x");
cartItem.setQuantity(1);
cartItem.setPrice(new java.math.BigDecimal("5.5"));
// Creating a customer session of V2
NewCustomerSessionV2 customerSession = new NewCustomerSessionV2();
customerSession.setProfileId("Cool_Dude");
customerSession.addCouponCodesItem("Cool-Summer!");
customerSession.addCartItemsItem(cartItem);
// Initiating integration request wrapping the customer session update
IntegrationRequest request = new IntegrationRequest()
.customerSession(customerSession)
// Optional parameter of requested information to be present on the response related to the customer session update
.responseContent(Arrays.asList(
IntegrationRequest.ResponseContentEnum.CUSTOMERSESSION,
IntegrationRequest.ResponseContentEnum.CUSTOMERPROFILE
));
// Flag to communicate whether the request is a "dry run"
Boolean dryRun = false;
// Create/update a customer session using `updateCustomerSessionV2` function
IntegrationStateV2 is = iApi.updateCustomerSessionV2("deetdoot", request, dryRun, null);
System.out.println(is.toString());
// Parsing the returned effects list, please consult https://developers.talon.one/Integration-API/handling-effects-v2 for the full list of effects and their corresponding properties
for (Effect eff : is.getEffects()) {
if (eff.getEffectType().equals("addLoyaltyPoints")) {
// Typecasting according to the specific effect type
AddLoyaltyPointsEffectProps props = gson.fromJson(
gson.toJson(eff.getProps()),
AddLoyaltyPointsEffectProps.class
);
// Access the specific effect's properties
System.out.println(props.getName());
System.out.println(props.getProgramId());
System.out.println(props.getValue());
}
if (eff.getEffectType().equals("acceptCoupon")) {
// Typecasting according to the specific effect type
AcceptCouponEffectProps props = gson.fromJson(
gson.toJson(eff.getProps()),
AcceptCouponEffectProps.class
);
// work with AcceptCouponEffectProps' properties
// ...
}
}
} catch (Exception e) {
System.out.println(e);
}
}
}
package com.example.consumer;
import one.talon.ApiClient;
import one.talon.api.IntegrationApi;
import one.talon.api.ManagementApi;
import one.talon.model.*;
public class TalonApiTest {
public static void main(String[] args) {
// Management API example to load application with id 7
ManagementApi mApi = new ManagementApi(new ApiClient("management_key"));
// Setup: basePath
mApi.getApiClient().setBasePath("https://yourbaseurl.talon.one");
// Setup: when using 'management_key', set apiKey & apiKeyPrefix must be provided
mApi.getApiClient().setApiKeyPrefix("ManagementKey-v1");
mApi.getApiClient().setApiKey("2f0dce055da01ae595005d7d79154bae7448d319d5fc7c5b2951fadd6ba1ea07");
try {
// Calling `getApplication` function with the desired id (7)
Application application = mApi.getApplication(7);
System.out.println(application.toString());
} catch (Exception e) {
System.out.println(e);
}
}
}
All URIs are relative to https://yourbaseurl.talon.one
Class | Method | HTTP request | Description |
---|---|---|---|
IntegrationApi | createAudienceV2 | POST /v2/audiences | Create audience |
IntegrationApi | createCouponReservation | POST /v1/coupon_reservations/{couponValue} | Create coupon reservation |
IntegrationApi | createReferral | POST /v1/referrals | Create referral code for an advocate |
IntegrationApi | createReferralsForMultipleAdvocates | POST /v1/referrals_for_multiple_advocates | Create referral codes for multiple advocates |
IntegrationApi | deleteAudienceMembershipsV2 | DELETE /v2/audiences/{audienceId}/memberships | Delete audience memberships |
IntegrationApi | deleteAudienceV2 | DELETE /v2/audiences/{audienceId} | Delete audience |
IntegrationApi | deleteCouponReservation | DELETE /v1/coupon_reservations/{couponValue} | Delete coupon reservations |
IntegrationApi | deleteCustomerData | DELETE /v1/customer_data/{integrationId} | Delete customer's personal data |
IntegrationApi | generateLoyaltyCard | POST /v1/loyalty_programs/{loyaltyProgramId}/cards | Generate loyalty card |
IntegrationApi | getCustomerInventory | GET /v1/customer_profiles/{integrationId}/inventory | List customer data |
IntegrationApi | getCustomerSession | GET /v2/customer_sessions/{customerSessionId} | Get customer session |
IntegrationApi | getLoyaltyBalances | GET /v1/loyalty_programs/{loyaltyProgramId}/profile/{integrationId}/balances | Get customer's loyalty balances |
IntegrationApi | getLoyaltyCardBalances | GET /v1/loyalty_programs/{loyaltyProgramId}/cards/{loyaltyCardId}/balances | Get card's point balances |
IntegrationApi | getLoyaltyCardPoints | GET /v1/loyalty_programs/{loyaltyProgramId}/cards/{loyaltyCardId}/points | List card's unused loyalty points |
IntegrationApi | getLoyaltyCardTransactions | GET /v1/loyalty_programs/{loyaltyProgramId}/cards/{loyaltyCardId}/transactions | List card's transactions |
IntegrationApi | getLoyaltyProgramProfilePoints | GET /v1/loyalty_programs/{loyaltyProgramId}/profile/{integrationId}/points | List customer's unused loyalty points |
IntegrationApi | getLoyaltyProgramProfileTransactions | GET /v1/loyalty_programs/{loyaltyProgramId}/profile/{integrationId}/transactions | List customer's loyalty transactions |
IntegrationApi | getReservedCustomers | GET /v1/coupon_reservations/customerprofiles/{couponValue} | List customers that have this coupon reserved |
IntegrationApi | linkLoyaltyCardToProfile | POST /v2/loyalty_programs/{loyaltyProgramId}/cards/{loyaltyCardId}/link_profile | Link customer profile to card |
IntegrationApi | reopenCustomerSession | PUT /v2/customer_sessions/{customerSessionId}/reopen | Reopen customer session |
IntegrationApi | returnCartItems | POST /v2/customer_sessions/{customerSessionId}/returns | Return cart items |
IntegrationApi | syncCatalog | PUT /v1/catalogs/{catalogId}/sync | Sync cart item catalog |
IntegrationApi | trackEventV2 | POST /v2/events | Track event |
IntegrationApi | updateAudienceCustomersAttributes | PUT /v2/audience_customers/{audienceId}/attributes | Update profile attributes for all customers in audience |
IntegrationApi | updateAudienceV2 | PUT /v2/audiences/{audienceId} | Update audience name |
IntegrationApi | updateCustomerProfileAudiences | POST /v2/customer_audiences | Update multiple customer profiles' audiences |
IntegrationApi | updateCustomerProfileV2 | PUT /v2/customer_profiles/{integrationId} | Update customer profile |
IntegrationApi | updateCustomerProfilesV2 | PUT /v2/customer_profiles | Update multiple customer profiles |
IntegrationApi | updateCustomerSessionV2 | PUT /v2/customer_sessions/{customerSessionId} | Update customer session |
ManagementApi | activateUserByEmail | POST /v1/users/activate | Enable user by email address |
ManagementApi | addLoyaltyCardPoints | PUT /v1/loyalty_programs/{loyaltyProgramId}/cards/{loyaltyCardId}/add_points | Add points to card |
ManagementApi | addLoyaltyPoints | PUT /v1/loyalty_programs/{loyaltyProgramId}/profile/{integrationId}/add_points | Add points to customer profile |
ManagementApi | copyCampaignToApplications | POST /v1/applications/{applicationId}/campaigns/{campaignId}/copy | Copy the campaign into the specified Application |
ManagementApi | createAccountCollection | POST /v1/collections | Create account-level collection |
ManagementApi | createAchievement | POST /v1/applications/{applicationId}/campaigns/{campaignId}/achievements | Create achievement |
ManagementApi | createAdditionalCost | POST /v1/additional_costs | Create additional cost |
ManagementApi | createAttribute | POST /v1/attributes | Create custom attribute |
ManagementApi | createBatchLoyaltyCards | POST /v1/loyalty_programs/{loyaltyProgramId}/cards/batch | Create loyalty cards |
ManagementApi | createCampaignFromTemplate | POST /v1/applications/{applicationId}/create_campaign_from_template | Create campaign from campaign template |
ManagementApi | createCollection | POST /v1/applications/{applicationId}/campaigns/{campaignId}/collections | Create campaign-level collection |
ManagementApi | createCoupons | POST /v1/applications/{applicationId}/campaigns/{campaignId}/coupons | Create coupons |
ManagementApi | createCouponsAsync | POST /v1/applications/{applicationId}/campaigns/{campaignId}/coupons_async | Create coupons asynchronously |
ManagementApi | createCouponsDeletionJob | POST /v1/applications/{applicationId}/campaigns/{campaignId}/coupons_deletion_jobs | Creates a coupon deletion job |
ManagementApi | createCouponsForMultipleRecipients | POST /v1/applications/{applicationId}/campaigns/{campaignId}/coupons_with_recipients | Create coupons for multiple recipients |
ManagementApi | createInviteEmail | POST /v1/invite_emails | Resend invitation email |
ManagementApi | createInviteV2 | POST /v2/invites | Invite user |
ManagementApi | createPasswordRecoveryEmail | POST /v1/password_recovery_emails | Request a password reset |
ManagementApi | createSession | POST /v1/sessions | Create session |
ManagementApi | createStore | POST /v1/applications/{applicationId}/stores | Create store |
ManagementApi | deactivateUserByEmail | POST /v1/users/deactivate | Disable user by email address |
ManagementApi | deductLoyaltyCardPoints | PUT /v1/loyalty_programs/{loyaltyProgramId}/cards/{loyaltyCardId}/deduct_points | Deduct points from card |
ManagementApi | deleteAccountCollection | DELETE /v1/collections/{collectionId} | Delete account-level collection |
ManagementApi | deleteAchievement | DELETE /v1/applications/{applicationId}/campaigns/{campaignId}/achievements/{achievementId} | Delete achievement |
ManagementApi | deleteCampaign | DELETE /v1/applications/{applicationId}/campaigns/{campaignId} | Delete campaign |
ManagementApi | deleteCollection | DELETE /v1/applications/{applicationId}/campaigns/{campaignId}/collections/{collectionId} | Delete campaign-level collection |
ManagementApi | deleteCoupon | DELETE /v1/applications/{applicationId}/campaigns/{campaignId}/coupons/{couponId} | Delete coupon |
ManagementApi | deleteCoupons | DELETE /v1/applications/{applicationId}/campaigns/{campaignId}/coupons | Delete coupons |
ManagementApi | deleteLoyaltyCard | DELETE /v1/loyalty_programs/{loyaltyProgramId}/cards/{loyaltyCardId} | Delete loyalty card |
ManagementApi | deleteReferral | DELETE /v1/applications/{applicationId}/campaigns/{campaignId}/referrals/{referralId} | Delete referral |
ManagementApi | deleteStore | DELETE /v1/applications/{applicationId}/stores/{storeId} | Delete store |
ManagementApi | deleteUser | DELETE /v1/users/{userId} | Delete user |
ManagementApi | deleteUserByEmail | POST /v1/users/delete | Delete user by email address |
ManagementApi | destroySession | DELETE /v1/sessions | Destroy session |
ManagementApi | disconnectCampaignStores | DELETE /v1/applications/{applicationId}/campaigns/{campaignId}/stores | Disconnect stores |
ManagementApi | exportAccountCollectionItems | GET /v1/collections/{collectionId}/export | Export account-level collection's items |
ManagementApi | exportAchievements | GET /v1/applications/{applicationId}/campaigns/{campaignId}/achievements/{achievementId}/export | Export achievement customer data |
ManagementApi | exportAudiencesMemberships | GET /v1/audiences/{audienceId}/memberships/export | Export audience members |
ManagementApi | exportCampaignStores | GET /v1/applications/{applicationId}/campaigns/{campaignId}/stores/export | Export stores |
ManagementApi | exportCollectionItems | GET /v1/applications/{applicationId}/campaigns/{campaignId}/collections/{collectionId}/export | Export campaign-level collection's items |
ManagementApi | exportCoupons | GET /v1/applications/{applicationId}/export_coupons | Export coupons |
ManagementApi | exportCustomerSessions | GET /v1/applications/{applicationId}/export_customer_sessions | Export customer sessions |
ManagementApi | exportCustomersTiers | GET /v1/loyalty_programs/{loyaltyProgramId}/export_customers_tiers | Export customers' tier data |
ManagementApi | exportEffects | GET /v1/applications/{applicationId}/export_effects | Export triggered effects |
ManagementApi | exportLoyaltyBalance | GET /v1/loyalty_programs/{loyaltyProgramId}/export_customer_balance | Export customer loyalty balance to CSV |
ManagementApi | exportLoyaltyBalances | GET /v1/loyalty_programs/{loyaltyProgramId}/export_customer_balances | Export customer loyalty balances |
ManagementApi | exportLoyaltyCardBalances | GET /v1/loyalty_programs/{loyaltyProgramId}/export_card_balances | Export all card transaction logs |
ManagementApi | exportLoyaltyCardLedger | GET /v1/loyalty_programs/{loyaltyProgramId}/cards/{loyaltyCardId}/export_log | Export card's ledger log |
ManagementApi | exportLoyaltyCards | GET /v1/loyalty_programs/{loyaltyProgramId}/cards/export | Export loyalty cards |
ManagementApi | exportLoyaltyLedger | GET /v1/loyalty_programs/{loyaltyProgramId}/profile/{integrationId}/export_log | Export customer's transaction logs |
ManagementApi | exportPoolGiveaways | GET /v1/giveaways/pools/{poolId}/export | Export giveaway codes of a giveaway pool |
ManagementApi | exportReferrals | GET /v1/applications/{applicationId}/export_referrals | Export referrals |
ManagementApi | getAccessLogsWithoutTotalCount | GET /v1/applications/{applicationId}/access_logs/no_total | Get access logs for Application |
ManagementApi | getAccount | GET /v1/accounts/{accountId} | Get account details |
ManagementApi | getAccountAnalytics | GET /v1/accounts/{accountId}/analytics | Get account analytics |
ManagementApi | getAccountCollection | GET /v1/collections/{collectionId} | Get account-level collection |
ManagementApi | getAchievement | GET /v1/applications/{applicationId}/campaigns/{campaignId}/achievements/{achievementId} | Get achievement |
ManagementApi | getAdditionalCost | GET /v1/additional_costs/{additionalCostId} | Get additional cost |
ManagementApi | getAdditionalCosts | GET /v1/additional_costs | List additional costs |
ManagementApi | getAllAccessLogs | GET /v1/access_logs | List access logs |
ManagementApi | getApplication | GET /v1/applications/{applicationId} | Get Application |
ManagementApi | getApplicationApiHealth | GET /v1/applications/{applicationId}/health_report | Get Application health |
ManagementApi | getApplicationCustomer | GET /v1/applications/{applicationId}/customers/{customerId} | Get application's customer |
ManagementApi | getApplicationCustomerFriends | GET /v1/applications/{applicationId}/profile/{integrationId}/friends | List friends referred by customer profile |
ManagementApi | getApplicationCustomers | GET /v1/applications/{applicationId}/customers | List application's customers |
ManagementApi | getApplicationCustomersByAttributes | POST /v1/applications/{applicationId}/customer_search | List application customers matching the given attributes |
ManagementApi | getApplicationEventTypes | GET /v1/applications/{applicationId}/event_types | List Applications event types |
ManagementApi | getApplicationEventsWithoutTotalCount | GET /v1/applications/{applicationId}/events/no_total | List Applications events |
ManagementApi | getApplicationSession | GET /v1/applications/{applicationId}/sessions/{sessionId} | Get Application session |
ManagementApi | getApplicationSessions | GET /v1/applications/{applicationId}/sessions | List Application sessions |
ManagementApi | getApplications | GET /v1/applications | List Applications |
ManagementApi | getAttribute | GET /v1/attributes/{attributeId} | Get custom attribute |
ManagementApi | getAttributes | GET /v1/attributes | List custom attributes |
ManagementApi | getAudienceMemberships | GET /v1/audiences/{audienceId}/memberships | List audience members |
ManagementApi | getAudiences | GET /v1/audiences | List audiences |
ManagementApi | getAudiencesAnalytics | GET /v1/audiences/analytics | List audience analytics |
ManagementApi | getCampaign | GET /v1/applications/{applicationId}/campaigns/{campaignId} | Get campaign |
ManagementApi | getCampaignAnalytics | GET /v1/applications/{applicationId}/campaigns/{campaignId}/analytics | Get analytics of campaigns |
ManagementApi | getCampaignByAttributes | POST /v1/applications/{applicationId}/campaigns_search | List campaigns that match the given attributes |
ManagementApi | getCampaignGroup | GET /v1/campaign_groups/{campaignGroupId} | Get campaign access group |
ManagementApi | getCampaignGroups | GET /v1/campaign_groups | List campaign access groups |
ManagementApi | getCampaignTemplates | GET /v1/campaign_templates | List campaign templates |
ManagementApi | getCampaigns | GET /v1/applications/{applicationId}/campaigns | List campaigns |
ManagementApi | getChanges | GET /v1/changes | Get audit logs for an account |
ManagementApi | getCollection | GET /v1/applications/{applicationId}/campaigns/{campaignId}/collections/{collectionId} | Get campaign-level collection |
ManagementApi | getCollectionItems | GET /v1/collections/{collectionId}/items | Get collection items |
ManagementApi | getCouponsWithoutTotalCount | GET /v1/applications/{applicationId}/campaigns/{campaignId}/coupons/no_total | List coupons |
ManagementApi | getCustomerActivityReport | GET /v1/applications/{applicationId}/customer_activity_reports/{customerId} | Get customer's activity report |
ManagementApi | getCustomerActivityReportsWithoutTotalCount | GET /v1/applications/{applicationId}/customer_activity_reports/no_total | Get Activity Reports for Application Customers |
ManagementApi | getCustomerAnalytics | GET /v1/applications/{applicationId}/customers/{customerId}/analytics | Get customer's analytics report |
ManagementApi | getCustomerProfile | GET /v1/customers/{customerId} | Get customer profile |
ManagementApi | getCustomerProfileAchievementProgress | GET /v1/applications/{applicationId}/achievement_progress/{integrationId} | List customer achievements |
ManagementApi | getCustomerProfiles | GET /v1/customers/no_total | List customer profiles |
ManagementApi | getCustomersByAttributes | POST /v1/customer_search/no_total | List customer profiles matching the given attributes |
ManagementApi | getEventTypes | GET /v1/event_types | List event types |
ManagementApi | getExports | GET /v1/exports | Get exports |
ManagementApi | getLoyaltyCard | GET /v1/loyalty_programs/{loyaltyProgramId}/cards/{loyaltyCardId} | Get loyalty card |
ManagementApi | getLoyaltyCardTransactionLogs | GET /v1/loyalty_programs/{loyaltyProgramId}/cards/{loyaltyCardId}/logs | List card's transactions |
ManagementApi | getLoyaltyCards | GET /v1/loyalty_programs/{loyaltyProgramId}/cards | List loyalty cards |
ManagementApi | getLoyaltyPoints | GET /v1/loyalty_programs/{loyaltyProgramId}/profile/{integrationId} | Get customer's full loyalty ledger |
ManagementApi | getLoyaltyProgram | GET /v1/loyalty_programs/{loyaltyProgramId} | Get loyalty program |
ManagementApi | getLoyaltyProgramTransactions | GET /v1/loyalty_programs/{loyaltyProgramId}/transactions | List loyalty program transactions |
ManagementApi | getLoyaltyPrograms | GET /v1/loyalty_programs | List loyalty programs |
ManagementApi | getLoyaltyStatistics | GET /v1/loyalty_programs/{loyaltyProgramId}/statistics | Get loyalty program statistics |
ManagementApi | getReferralsWithoutTotalCount | GET /v1/applications/{applicationId}/campaigns/{campaignId}/referrals/no_total | List referrals |
ManagementApi | getRoleV2 | GET /v2/roles/{roleId} | Get role |
ManagementApi | getRuleset | GET /v1/applications/{applicationId}/campaigns/{campaignId}/rulesets/{rulesetId} | Get ruleset |
ManagementApi | getRulesets | GET /v1/applications/{applicationId}/campaigns/{campaignId}/rulesets | List campaign rulesets |
ManagementApi | getStore | GET /v1/applications/{applicationId}/stores/{storeId} | Get store |
ManagementApi | getUser | GET /v1/users/{userId} | Get user |
ManagementApi | getUsers | GET /v1/users | List users in account |
ManagementApi | getWebhook | GET /v1/webhooks/{webhookId} | Get webhook |
ManagementApi | getWebhookActivationLogs | GET /v1/webhook_activation_logs | List webhook activation log entries |
ManagementApi | getWebhookLogs | GET /v1/webhook_logs | List webhook log entries |
ManagementApi | getWebhooks | GET /v1/webhooks | List webhooks |
ManagementApi | importAccountCollection | POST /v1/collections/{collectionId}/import | Import data into existing account-level collection |
ManagementApi | importAllowedList | POST /v1/attributes/{attributeId}/allowed_list/import | Import allowed values for attribute |
ManagementApi | importAudiencesMemberships | POST /v1/audiences/{audienceId}/memberships/import | Import audience members |
ManagementApi | importCampaignStores | POST /v1/applications/{applicationId}/campaigns/{campaignId}/stores/import | Import stores |
ManagementApi | importCollection | POST /v1/applications/{applicationId}/campaigns/{campaignId}/collections/{collectionId}/import | Import data into existing campaign-level collection |
ManagementApi | importCoupons | POST /v1/applications/{applicationId}/campaigns/{campaignId}/import_coupons | Import coupons |
ManagementApi | importLoyaltyCards | POST /v1/loyalty_programs/{loyaltyProgramId}/import_cards | Import loyalty cards |
ManagementApi | importLoyaltyCustomersTiers | POST /v1/loyalty_programs/{loyaltyProgramId}/import_customers_tiers | Import customers into loyalty tiers |
ManagementApi | importLoyaltyPoints | POST /v1/loyalty_programs/{loyaltyProgramId}/import_points | Import loyalty points |
ManagementApi | importPoolGiveaways | POST /v1/giveaways/pools/{poolId}/import | Import giveaway codes into a giveaway pool |
ManagementApi | importReferrals | POST /v1/applications/{applicationId}/campaigns/{campaignId}/import_referrals | Import referrals |
ManagementApi | inviteUserExternal | POST /v1/users/invite | Invite user from identity provider |
ManagementApi | listAccountCollections | GET /v1/collections | List collections in account |
ManagementApi | listAchievements | GET /v1/applications/{applicationId}/campaigns/{campaignId}/achievements | List achievements |
ManagementApi | listAllRolesV2 | GET /v2/roles | List roles |
ManagementApi | listCatalogItems | GET /v1/catalogs/{catalogId}/items | List items in a catalog |
ManagementApi | listCollections | GET /v1/applications/{applicationId}/campaigns/{campaignId}/collections | List collections in campaign |
ManagementApi | listCollectionsInApplication | GET /v1/applications/{applicationId}/collections | List collections in Application |
ManagementApi | listStores | GET /v1/applications/{applicationId}/stores | List stores |
ManagementApi | notificationActivation | PUT /v1/notifications/{notificationId}/activation | Activate or deactivate notification |
ManagementApi | oktaEventHandlerChallenge | GET /v1/provisioning/okta | Validate Okta API ownership |
ManagementApi | postAddedDeductedPointsNotification | POST /v1/loyalty_programs/{loyaltyProgramId}/notifications/added_deducted_points | Create notification about added or deducted loyalty points |
ManagementApi | postCatalogsStrikethroughNotification | POST /v1/applications/{applicationId}/catalogs/notifications/strikethrough | Create strikethrough notification |
ManagementApi | postPendingPointsNotification | POST /v1/loyalty_programs/{loyaltyProgramId}/notifications/pending_points | Create notification about pending loyalty points |
ManagementApi | removeLoyaltyPoints | PUT /v1/loyalty_programs/{loyaltyProgramId}/profile/{integrationId}/deduct_points | Deduct points from customer profile |
ManagementApi | resetPassword | POST /v1/reset_password | Reset password |
ManagementApi | scimCreateUser | POST /v1/provisioning/scim/Users | Create SCIM user |
ManagementApi | scimDeleteUser | DELETE /v1/provisioning/scim/Users/{userId} | Delete SCIM user |
ManagementApi | scimGetResourceTypes | GET /v1/provisioning/scim/ResourceTypes | List supported SCIM resource types |
ManagementApi | scimGetSchemas | GET /v1/provisioning/scim/Schemas | List supported SCIM schemas |
ManagementApi | scimGetServiceProviderConfig | GET /v1/provisioning/scim/ServiceProviderConfig | Get SCIM service provider configuration |
ManagementApi | scimGetUser | GET /v1/provisioning/scim/Users/{userId} | Get SCIM user |
ManagementApi | scimGetUsers | GET /v1/provisioning/scim/Users | List SCIM users |
ManagementApi | scimPatchUser | PATCH /v1/provisioning/scim/Users/{userId} | Update SCIM user attributes |
ManagementApi | scimReplaceUserAttributes | PUT /v1/provisioning/scim/Users/{userId} | Update SCIM user |
ManagementApi | searchCouponsAdvancedApplicationWideWithoutTotalCount | POST /v1/applications/{applicationId}/coupons_search_advanced/no_total | List coupons that match the given attributes (without total count) |
ManagementApi | searchCouponsAdvancedWithoutTotalCount | POST /v1/applications/{applicationId}/campaigns/{campaignId}/coupons_search_advanced/no_total | List coupons that match the given attributes in campaign (without total count) |
ManagementApi | transferLoyaltyCard | PUT /v1/loyalty_programs/{loyaltyProgramId}/cards/{loyaltyCardId}/transfer | Transfer card data |
ManagementApi | updateAccountCollection | PUT /v1/collections/{collectionId} | Update account-level collection |
ManagementApi | updateAchievement | PUT /v1/applications/{applicationId}/campaigns/{campaignId}/achievements/{achievementId} | Update achievement |
ManagementApi | updateAdditionalCost | PUT /v1/additional_costs/{additionalCostId} | Update additional cost |
ManagementApi | updateAttribute | PUT /v1/attributes/{attributeId} | Update custom attribute |
ManagementApi | updateCampaign | PUT /v1/applications/{applicationId}/campaigns/{campaignId} | Update campaign |
ManagementApi | updateCollection | PUT /v1/applications/{applicationId}/campaigns/{campaignId}/collections/{collectionId} | Update campaign-level collection's description |
ManagementApi | updateCoupon | PUT /v1/applications/{applicationId}/campaigns/{campaignId}/coupons/{couponId} | Update coupon |
ManagementApi | updateCouponBatch | PUT /v1/applications/{applicationId}/campaigns/{campaignId}/coupons | Update coupons |
ManagementApi | updateLoyaltyCard | PUT /v1/loyalty_programs/{loyaltyProgramId}/cards/{loyaltyCardId} | Update loyalty card status |
ManagementApi | updateReferral | PUT /v1/applications/{applicationId}/campaigns/{campaignId}/referrals/{referralId} | Update referral |
ManagementApi | updateRoleV2 | PUT /v2/roles/{roleId} | Update role |
ManagementApi | updateStore | PUT /v1/applications/{applicationId}/stores/{storeId} | Update store |
ManagementApi | updateUser | PUT /v1/users/{userId} | Update user |
- APIError
- AcceptCouponEffectProps
- AcceptReferralEffectProps
- AccessLogEntry
- Account
- AccountAdditionalCost
- AccountAnalytics
- AccountDashboardStatistic
- AccountDashboardStatisticCampaigns
- AccountDashboardStatisticDiscount
- AccountDashboardStatisticLoyaltyPoints
- AccountDashboardStatisticReferrals
- AccountDashboardStatisticRevenue
- AccountEntity
- AccountLimits
- Achievement
- AchievementAdditionalProperties
- AchievementProgress
- AddFreeItemEffectProps
- AddItemCatalogAction
- AddLoyaltyPoints
- AddLoyaltyPointsEffectProps
- AddToAudienceEffectProps
- AddedDeductedPointsNotificationPolicy
- AdditionalCampaignProperties
- AdditionalCost
- AnalyticsDataPoint
- AnalyticsDataPointWithTrend
- AnalyticsDataPointWithTrendAndInfluencedRate
- AnalyticsDataPointWithTrendAndUplift
- Application
- ApplicationAPIKey
- ApplicationAnalyticsDataPoint
- ApplicationApiHealth
- ApplicationCIF
- ApplicationCIFExpression
- ApplicationCampaignAnalytics
- ApplicationCampaignStats
- ApplicationCustomer
- ApplicationCustomerEntity
- ApplicationEntity
- ApplicationEvent
- ApplicationNotification
- ApplicationReferee
- ApplicationSession
- ApplicationSessionEntity
- ApplicationStoreEntity
- AsyncCouponCreationResponse
- AsyncCouponDeletionJobResponse
- Attribute
- AttributesMandatory
- AttributesSettings
- Audience
- AudienceAnalytics
- AudienceCustomer
- AudienceIntegrationID
- AudienceMembership
- AwardGiveawayEffectProps
- BaseCampaign
- BaseLoyaltyProgram
- BaseNotification
- BaseNotificationEntity
- BaseNotificationWebhook
- BaseNotifications
- BaseSamlConnection
- Binding
- BulkApplicationNotification
- BulkCampaignNotification
- BulkOperationOnCampaigns
- Campaign
- CampaignActivationRequest
- CampaignAnalytics
- CampaignBudget
- CampaignCollection
- CampaignCollectionEditedNotification
- CampaignCollectionWithoutPayload
- CampaignCopy
- CampaignCreatedNotification
- CampaignDeletedNotification
- CampaignEditedNotification
- CampaignEntity
- CampaignEvaluationGroup
- CampaignEvaluationPosition
- CampaignEvaluationTreeChangedNotification
- CampaignGroup
- CampaignGroupEntity
- CampaignNotification
- CampaignNotificationPolicy
- CampaignRulesetChangedNotification
- CampaignSearch
- CampaignSet
- CampaignSetBranchNode
- CampaignSetLeafNode
- CampaignSetNode
- CampaignStateChangedNotification
- CampaignStoreBudget
- CampaignTemplate
- CampaignTemplateCollection
- CampaignTemplateCouponReservationSettings
- CampaignTemplateParams
- CampaignVersions
- CardAddedDeductedPointsNotificationPolicy
- CardExpiringPointsNotificationPolicy
- CardExpiringPointsNotificationTrigger
- CardLedgerPointsEntryIntegrationAPI
- CardLedgerTransactionLogEntry
- CardLedgerTransactionLogEntryIntegrationAPI
- CartItem
- Catalog
- CatalogAction
- CatalogActionFilter
- CatalogItem
- CatalogSyncRequest
- CatalogsStrikethroughNotificationPolicy
- Change
- ChangeLoyaltyTierLevelEffectProps
- ChangeProfilePassword
- CodeGeneratorSettings
- Collection
- CollectionItem
- CollectionWithoutPayload
- Coupon
- CouponConstraints
- CouponCreatedEffectProps
- CouponCreationJob
- CouponDeletionFilters
- CouponDeletionJob
- CouponLimitConfigs
- CouponRejectionReason
- CouponReservations
- CouponSearch
- CouponValue
- CouponsNotificationPolicy
- CreateAchievement
- CreateApplicationAPIKey
- CreateManagementKey
- CreateTemplateCampaign
- CreateTemplateCampaignResponse
- CustomEffect
- CustomEffectProps
- CustomerActivityReport
- CustomerAnalytics
- CustomerInventory
- CustomerProfile
- CustomerProfileAudienceRequest
- CustomerProfileAudienceRequestItem
- CustomerProfileIntegrationRequestV2
- CustomerProfileIntegrationResponseV2
- CustomerProfileSearchQuery
- CustomerProfileUpdateV2Response
- CustomerSession
- CustomerSessionV2
- DeactivateUserRequest
- DeductLoyaltyPoints
- DeductLoyaltyPointsEffectProps
- Effect
- EffectEntity
- EmailEntity
- Endpoint
- Entity
- EntityWithTalangVisibleID
- Environment
- ErrorEffectProps
- ErrorResponse
- ErrorResponseWithStatus
- ErrorSource
- EvaluableCampaignIds
- Event
- EventType
- EventV2
- ExpiringCouponsNotificationPolicy
- ExpiringCouponsNotificationTrigger
- ExpiringPointsNotificationPolicy
- ExpiringPointsNotificationTrigger
- Export
- FeatureFlag
- FeaturesFeed
- FuncArgDef
- FunctionDef
- GenerateCampaignDescription
- GenerateCampaignTags
- GenerateItemFilterDescription
- GenerateLoyaltyCard
- GenerateRuleTitle
- GenerateRuleTitleRule
- GetIntegrationCouponRequest
- Giveaway
- GiveawaysPool
- IdentifiableEntity
- ImportEntity
- IncreaseAchievementProgressEffectProps
- InlineResponse200
- InlineResponse2001
- InlineResponse20010
- InlineResponse20011
- InlineResponse20012
- InlineResponse20013
- InlineResponse20014
- InlineResponse20015
- InlineResponse20016
- InlineResponse20017
- InlineResponse20018
- InlineResponse20019
- InlineResponse2002
- InlineResponse20020
- InlineResponse20021
- InlineResponse20022
- InlineResponse20023
- InlineResponse20024
- InlineResponse20025
- InlineResponse20026
- InlineResponse20027
- InlineResponse20028
- InlineResponse20029
- InlineResponse2003
- InlineResponse20030
- InlineResponse20031
- InlineResponse20032
- InlineResponse20033
- InlineResponse20034
- InlineResponse20035
- InlineResponse20036
- InlineResponse20037
- InlineResponse20038
- InlineResponse20039
- InlineResponse2004
- InlineResponse20040
- InlineResponse20041
- InlineResponse20042
- InlineResponse20043
- InlineResponse20044
- InlineResponse20045
- InlineResponse20046
- InlineResponse20047
- InlineResponse2005
- InlineResponse2006
- InlineResponse2007
- InlineResponse2008
- InlineResponse2009
- InlineResponse201
- IntegrationCoupon
- IntegrationCustomerSessionResponse
- IntegrationEntity
- IntegrationEvent
- IntegrationEventV2Request
- IntegrationProfileEntity
- IntegrationRequest
- IntegrationState
- IntegrationStateV2
- IntegrationStoreEntity
- InventoryCoupon
- InventoryReferral
- ItemAttribute
- LedgerEntry
- LedgerInfo
- LedgerPointsEntryIntegrationAPI
- LedgerTransactionLogEntryIntegrationAPI
- LibraryAttribute
- LimitConfig
- LimitCounter
- ListCampaignStoreBudgets
- ListCampaignStoreBudgetsStore
- LoginParams
- Loyalty
- LoyaltyBalance
- LoyaltyBalanceWithTier
- LoyaltyBalances
- LoyaltyBalancesWithTiers
- LoyaltyCard
- LoyaltyCardBalances
- LoyaltyCardBatch
- LoyaltyCardBatchResponse
- LoyaltyCardProfileRegistration
- LoyaltyCardRegistration
- LoyaltyDashboardData
- LoyaltyDashboardPointsBreakdown
- LoyaltyLedger
- LoyaltyLedgerEntry
- LoyaltyLedgerTransactions
- LoyaltyMembership
- LoyaltyProgram
- LoyaltyProgramBalance
- LoyaltyProgramEntity
- LoyaltyProgramLedgers
- LoyaltyProgramTransaction
- LoyaltySubLedger
- LoyaltyTier
- ManagementKey
- ManagerConfig
- MessageLogEntries
- MessageLogEntry
- MessageLogRequest
- MessageLogResponse
- Meta
- ModelImport
- ModelReturn
- MultiApplicationEntity
- MultipleAttribute
- MultipleAudiences
- MultipleAudiencesItem
- MultipleCustomerProfileIntegrationRequest
- MultipleCustomerProfileIntegrationRequestItem
- MultipleCustomerProfileIntegrationResponseV2
- MultipleNewAttribute
- MultipleNewAudiences
- MutableEntity
- NewAccount
- NewAccountSignUp
- NewAdditionalCost
- NewAppWideCouponDeletionJob
- NewApplication
- NewApplicationAPIKey
- NewApplicationCIF
- NewApplicationCIFExpression
- NewAttribute
- NewAudience
- NewBaseNotification
- NewCampaign
- NewCampaignCollection
- NewCampaignEvaluationGroup
- NewCampaignGroup
- NewCampaignSet
- NewCampaignStoreBudget
- NewCampaignStoreBudgetStoreLimit
- NewCampaignTemplate
- NewCatalog
- NewCollection
- NewCouponCreationJob
- NewCouponDeletionJob
- NewCoupons
- NewCouponsForMultipleRecipients
- NewCustomEffect
- NewCustomerProfile
- NewCustomerSession
- NewCustomerSessionV2
- NewEvent
- NewEventType
- NewExternalInvitation
- NewGiveawaysPool
- NewInternalAudience
- NewInvitation
- NewInviteEmail
- NewLoyaltyProgram
- NewLoyaltyTier
- NewManagementKey
- NewMultipleAudiencesItem
- NewNotificationTest
- NewNotificationWebhook
- NewOutgoingIntegrationWebhook
- NewPassword
- NewPasswordEmail
- NewPicklist
- NewReferral
- NewReferralsForMultipleAdvocates
- NewReturn
- NewRevisionVersion
- NewRole
- NewRoleV2
- NewRuleset
- NewSamlConnection
- NewStore
- NewTemplateDef
- NewUser
- NewWebhook
- Notification
- NotificationActivation
- NotificationListItem
- NotificationTest
- OktaEvent
- OktaEventPayload
- OktaEventPayloadData
- OktaEventTarget
- OneTimeCode
- OutgoingIntegrationBrazePolicy
- OutgoingIntegrationCleverTapPolicy
- OutgoingIntegrationConfiguration
- OutgoingIntegrationIterablePolicy
- OutgoingIntegrationMoEngagePolicy
- OutgoingIntegrationTemplate
- OutgoingIntegrationTemplateWithConfigurationDetails
- OutgoingIntegrationTemplates
- OutgoingIntegrationType
- OutgoingIntegrationTypes
- PatchItemCatalogAction
- PatchManyItemsCatalogAction
- PendingPointsNotificationPolicy
- Picklist
- Product
- ProfileAudiencesChanges
- ProjectedTier
- RedeemReferralEffectProps
- Referral
- ReferralConstraints
- ReferralCreatedEffectProps
- ReferralRejectionReason
- RejectCouponEffectProps
- RejectReferralEffectProps
- RemoveFromAudienceEffectProps
- RemoveItemCatalogAction
- RemoveManyItemsCatalogAction
- ReopenSessionResponse
- ReserveCouponEffectProps
- ReturnIntegrationRequest
- ReturnedCartItem
- Revision
- RevisionActivation
- RevisionVersion
- Role
- RoleAssign
- RoleMembership
- RoleV2
- RoleV2ApplicationDetails
- RoleV2Base
- RoleV2PermissionSet
- RoleV2Permissions
- RoleV2RolesGroup
- RollbackAddedLoyaltyPointsEffectProps
- RollbackCouponEffectProps
- RollbackDeductedLoyaltyPointsEffectProps
- RollbackDiscountEffectProps
- RollbackIncreasedAchievementProgressEffectProps
- RollbackReferralEffectProps
- Rule
- RuleFailureReason
- Ruleset
- SSOConfig
- SamlConnection
- SamlConnectionInternal
- SamlConnectionMetadata
- SamlLoginEndpoint
- ScimBaseUser
- ScimBaseUserName
- ScimNewUser
- ScimPatchOperation
- ScimPatchRequest
- ScimResource
- ScimResourceTypesListResponse
- ScimSchemaResource
- ScimSchemasListResponse
- ScimServiceProviderConfigResponse
- ScimServiceProviderConfigResponseBulk
- ScimServiceProviderConfigResponseChangePassword
- ScimServiceProviderConfigResponseFilter
- ScimServiceProviderConfigResponsePatch
- ScimServiceProviderConfigResponseSort
- ScimUser
- ScimUsersListResponse
- Session
- SetDiscountEffectProps
- SetDiscountPerAdditionalCostEffectProps
- SetDiscountPerAdditionalCostPerItemEffectProps
- SetDiscountPerItemEffectProps
- ShowBundleMetadataEffectProps
- ShowNotificationEffectProps
- SlotDef
- Store
- StrikethroughChangedItem
- StrikethroughCustomEffectPerItemProps
- StrikethroughEffect
- StrikethroughLabelingNotification
- StrikethroughSetDiscountPerItemEffectProps
- StrikethroughTrigger
- SummaryCampaignStoreBudget
- TalangAttribute
- TalangAttributeVisibility
- TemplateArgDef
- TemplateDef
- TemplateLimitConfig
- Tier
- TierDowngradeNotificationPolicy
- TierUpgradeNotificationPolicy
- TierWillDowngradeNotificationPolicy
- TierWillDowngradeNotificationTrigger
- TimePoint
- TrackEventV2Response
- TransferLoyaltyCard
- TriggerWebhookEffectProps
- TwoFAConfig
- UpdateAccount
- UpdateAchievement
- UpdateApplication
- UpdateApplicationAPIKey
- UpdateApplicationCIF
- UpdateAttributeEffectProps
- UpdateAudience
- UpdateCampaign
- UpdateCampaignCollection
- UpdateCampaignEvaluationGroup
- UpdateCampaignGroup
- UpdateCampaignTemplate
- UpdateCatalog
- UpdateCollection
- UpdateCoupon
- UpdateCouponBatch
- UpdateLoyaltyCard
- UpdateLoyaltyProgram
- UpdateLoyaltyProgramTier
- UpdatePicklist
- UpdateReferral
- UpdateReferralBatch
- UpdateRole
- UpdateStore
- UpdateUser
- User
- UserEntity
- Webhook
- WebhookActivationLogEntry
- WebhookLogEntry
- WebhookWithOutgoingIntegrationDetails
- WillAwardGiveawayEffectProps
Authentication schemes defined for the API:
- Type: API key
- API key parameter name: Authorization
- Location: HTTP header
- Type: API key
- API key parameter name: Authorization
- Location: HTTP header
- Type: API key
- API key parameter name: Authorization
- Location: HTTP header
It's recommended to create an instance of ApiClient
per thread in a multithreaded environment to avoid any potential issues.