Skip to content

Files

Latest commit

 

History

History
6940 lines (4084 loc) · 307 KB

ManagementApi.md

File metadata and controls

6940 lines (4084 loc) · 307 KB

\ManagementApi

All URLs are relative to https://yourbaseurl.talon.one.

Method HTTP request Description
ActivateUserByEmail Post /v1/users/activate Enable user by email address
AddLoyaltyCardPoints Put /v1/loyalty_programs/{loyaltyProgramId}/cards/{loyaltyCardId}/add_points Add points to card
AddLoyaltyPoints Put /v1/loyalty_programs/{loyaltyProgramId}/profile/{integrationId}/add_points Add points to customer profile
CopyCampaignToApplications Post /v1/applications/{applicationId}/campaigns/{campaignId}/copy Copy the campaign into the specified Application
CreateAccountCollection Post /v1/collections Create account-level collection
CreateAchievement Post /v1/applications/{applicationId}/campaigns/{campaignId}/achievements Create achievement
CreateAdditionalCost Post /v1/additional_costs Create additional cost
CreateAttribute Post /v1/attributes Create custom attribute
CreateBatchLoyaltyCards Post /v1/loyalty_programs/{loyaltyProgramId}/cards/batch Create loyalty cards
CreateCampaignFromTemplate Post /v1/applications/{applicationId}/create_campaign_from_template Create campaign from campaign template
CreateCollection Post /v1/applications/{applicationId}/campaigns/{campaignId}/collections Create campaign-level collection
CreateCoupons Post /v1/applications/{applicationId}/campaigns/{campaignId}/coupons Create coupons
CreateCouponsAsync Post /v1/applications/{applicationId}/campaigns/{campaignId}/coupons_async Create coupons asynchronously
CreateCouponsDeletionJob Post /v1/applications/{applicationId}/campaigns/{campaignId}/coupons_deletion_jobs Creates a coupon deletion job
CreateCouponsForMultipleRecipients Post /v1/applications/{applicationId}/campaigns/{campaignId}/coupons_with_recipients Create coupons for multiple recipients
CreateInviteEmail Post /v1/invite_emails Resend invitation email
CreateInviteV2 Post /v2/invites Invite user
CreatePasswordRecoveryEmail Post /v1/password_recovery_emails Request a password reset
CreateSession Post /v1/sessions Create session
CreateStore Post /v1/applications/{applicationId}/stores Create store
DeactivateUserByEmail Post /v1/users/deactivate Disable user by email address
DeductLoyaltyCardPoints Put /v1/loyalty_programs/{loyaltyProgramId}/cards/{loyaltyCardId}/deduct_points Deduct points from card
DeleteAccountCollection Delete /v1/collections/{collectionId} Delete account-level collection
DeleteAchievement Delete /v1/applications/{applicationId}/campaigns/{campaignId}/achievements/{achievementId} Delete achievement
DeleteCampaign Delete /v1/applications/{applicationId}/campaigns/{campaignId} Delete campaign
DeleteCollection Delete /v1/applications/{applicationId}/campaigns/{campaignId}/collections/{collectionId} Delete campaign-level collection
DeleteCoupon Delete /v1/applications/{applicationId}/campaigns/{campaignId}/coupons/{couponId} Delete coupon
DeleteCoupons Delete /v1/applications/{applicationId}/campaigns/{campaignId}/coupons Delete coupons
DeleteLoyaltyCard Delete /v1/loyalty_programs/{loyaltyProgramId}/cards/{loyaltyCardId} Delete loyalty card
DeleteReferral Delete /v1/applications/{applicationId}/campaigns/{campaignId}/referrals/{referralId} Delete referral
DeleteStore Delete /v1/applications/{applicationId}/stores/{storeId} Delete store
DeleteUser Delete /v1/users/{userId} Delete user
DeleteUserByEmail Post /v1/users/delete Delete user by email address
DestroySession Delete /v1/sessions Destroy session
DisconnectCampaignStores Delete /v1/applications/{applicationId}/campaigns/{campaignId}/stores Disconnect stores
ExportAccountCollectionItems Get /v1/collections/{collectionId}/export Export account-level collection's items
ExportAchievements Get /v1/applications/{applicationId}/campaigns/{campaignId}/achievements/{achievementId}/export Export achievement customer data
ExportAudiencesMemberships Get /v1/audiences/{audienceId}/memberships/export Export audience members
ExportCampaignStores Get /v1/applications/{applicationId}/campaigns/{campaignId}/stores/export Export stores
ExportCollectionItems Get /v1/applications/{applicationId}/campaigns/{campaignId}/collections/{collectionId}/export Export campaign-level collection's items
ExportCoupons Get /v1/applications/{applicationId}/export_coupons Export coupons
ExportCustomerSessions Get /v1/applications/{applicationId}/export_customer_sessions Export customer sessions
ExportCustomersTiers Get /v1/loyalty_programs/{loyaltyProgramId}/export_customers_tiers Export customers' tier data
ExportEffects Get /v1/applications/{applicationId}/export_effects Export triggered effects
ExportLoyaltyBalance Get /v1/loyalty_programs/{loyaltyProgramId}/export_customer_balance Export customer loyalty balance to CSV
ExportLoyaltyBalances Get /v1/loyalty_programs/{loyaltyProgramId}/export_customer_balances Export customer loyalty balances
ExportLoyaltyCardBalances Get /v1/loyalty_programs/{loyaltyProgramId}/export_card_balances Export all card transaction logs
ExportLoyaltyCardLedger Get /v1/loyalty_programs/{loyaltyProgramId}/cards/{loyaltyCardId}/export_log Export card's ledger log
ExportLoyaltyCards Get /v1/loyalty_programs/{loyaltyProgramId}/cards/export Export loyalty cards
ExportLoyaltyLedger Get /v1/loyalty_programs/{loyaltyProgramId}/profile/{integrationId}/export_log Export customer's transaction logs
ExportPoolGiveaways Get /v1/giveaways/pools/{poolId}/export Export giveaway codes of a giveaway pool
ExportReferrals Get /v1/applications/{applicationId}/export_referrals Export referrals
GetAccessLogsWithoutTotalCount Get /v1/applications/{applicationId}/access_logs/no_total Get access logs for Application
GetAccount Get /v1/accounts/{accountId} Get account details
GetAccountAnalytics Get /v1/accounts/{accountId}/analytics Get account analytics
GetAccountCollection Get /v1/collections/{collectionId} Get account-level collection
GetAchievement Get /v1/applications/{applicationId}/campaigns/{campaignId}/achievements/{achievementId} Get achievement
GetAdditionalCost Get /v1/additional_costs/{additionalCostId} Get additional cost
GetAdditionalCosts Get /v1/additional_costs List additional costs
GetApplication Get /v1/applications/{applicationId} Get Application
GetApplicationApiHealth Get /v1/applications/{applicationId}/health_report Get Application health
GetApplicationCustomer Get /v1/applications/{applicationId}/customers/{customerId} Get application's customer
GetApplicationCustomerFriends Get /v1/applications/{applicationId}/profile/{integrationId}/friends List friends referred by customer profile
GetApplicationCustomers Get /v1/applications/{applicationId}/customers List application's customers
GetApplicationCustomersByAttributes Post /v1/applications/{applicationId}/customer_search List application customers matching the given attributes
GetApplicationEventTypes Get /v1/applications/{applicationId}/event_types List Applications event types
GetApplicationEventsWithoutTotalCount Get /v1/applications/{applicationId}/events/no_total List Applications events
GetApplicationSession Get /v1/applications/{applicationId}/sessions/{sessionId} Get Application session
GetApplicationSessions Get /v1/applications/{applicationId}/sessions List Application sessions
GetApplications Get /v1/applications List Applications
GetAttribute Get /v1/attributes/{attributeId} Get custom attribute
GetAttributes Get /v1/attributes List custom attributes
GetAudienceMemberships Get /v1/audiences/{audienceId}/memberships List audience members
GetAudiences Get /v1/audiences List audiences
GetAudiencesAnalytics Get /v1/audiences/analytics List audience analytics
GetCampaign Get /v1/applications/{applicationId}/campaigns/{campaignId} Get campaign
GetCampaignAnalytics Get /v1/applications/{applicationId}/campaigns/{campaignId}/analytics Get analytics of campaigns
GetCampaignByAttributes Post /v1/applications/{applicationId}/campaigns_search List campaigns that match the given attributes
GetCampaignGroup Get /v1/campaign_groups/{campaignGroupId} Get campaign access group
GetCampaignGroups Get /v1/campaign_groups List campaign access groups
GetCampaignTemplates Get /v1/campaign_templates List campaign templates
GetCampaigns Get /v1/applications/{applicationId}/campaigns List campaigns
GetChanges Get /v1/changes Get audit logs for an account
GetCollection Get /v1/applications/{applicationId}/campaigns/{campaignId}/collections/{collectionId} Get campaign-level collection
GetCollectionItems Get /v1/collections/{collectionId}/items Get collection items
GetCouponsWithoutTotalCount Get /v1/applications/{applicationId}/campaigns/{campaignId}/coupons/no_total List coupons
GetCustomerActivityReport Get /v1/applications/{applicationId}/customer_activity_reports/{customerId} Get customer's activity report
GetCustomerActivityReportsWithoutTotalCount Get /v1/applications/{applicationId}/customer_activity_reports/no_total Get Activity Reports for Application Customers
GetCustomerAnalytics Get /v1/applications/{applicationId}/customers/{customerId}/analytics Get customer's analytics report
GetCustomerProfile Get /v1/customers/{customerId} Get customer profile
GetCustomerProfileAchievementProgress Get /v1/applications/{applicationId}/achievement_progress/{integrationId} List customer achievements
GetCustomerProfiles Get /v1/customers/no_total List customer profiles
GetCustomersByAttributes Post /v1/customer_search/no_total List customer profiles matching the given attributes
GetEventTypes Get /v1/event_types List event types
GetExports Get /v1/exports Get exports
GetLoyaltyCard Get /v1/loyalty_programs/{loyaltyProgramId}/cards/{loyaltyCardId} Get loyalty card
GetLoyaltyCardTransactionLogs Get /v1/loyalty_programs/{loyaltyProgramId}/cards/{loyaltyCardId}/logs List card's transactions
GetLoyaltyCards Get /v1/loyalty_programs/{loyaltyProgramId}/cards List loyalty cards
GetLoyaltyPoints Get /v1/loyalty_programs/{loyaltyProgramId}/profile/{integrationId} Get customer's full loyalty ledger
GetLoyaltyProgram Get /v1/loyalty_programs/{loyaltyProgramId} Get loyalty program
GetLoyaltyProgramTransactions Get /v1/loyalty_programs/{loyaltyProgramId}/transactions List loyalty program transactions
GetLoyaltyPrograms Get /v1/loyalty_programs List loyalty programs
GetLoyaltyStatistics Get /v1/loyalty_programs/{loyaltyProgramId}/statistics Get loyalty program statistics
GetReferralsWithoutTotalCount Get /v1/applications/{applicationId}/campaigns/{campaignId}/referrals/no_total List referrals
GetRoleV2 Get /v2/roles/{roleId} Get role
GetRuleset Get /v1/applications/{applicationId}/campaigns/{campaignId}/rulesets/{rulesetId} Get ruleset
GetRulesets Get /v1/applications/{applicationId}/campaigns/{campaignId}/rulesets List campaign rulesets
GetStore Get /v1/applications/{applicationId}/stores/{storeId} Get store
GetUser Get /v1/users/{userId} Get user
GetUsers Get /v1/users List users in account
GetWebhook Get /v1/webhooks/{webhookId} Get webhook
GetWebhookActivationLogs Get /v1/webhook_activation_logs List webhook activation log entries
GetWebhookLogs Get /v1/webhook_logs List webhook log entries
GetWebhooks Get /v1/webhooks List webhooks
ImportAccountCollection Post /v1/collections/{collectionId}/import Import data into existing account-level collection
ImportAllowedList Post /v1/attributes/{attributeId}/allowed_list/import Import allowed values for attribute
ImportAudiencesMemberships Post /v1/audiences/{audienceId}/memberships/import Import audience members
ImportCampaignStores Post /v1/applications/{applicationId}/campaigns/{campaignId}/stores/import Import stores
ImportCollection Post /v1/applications/{applicationId}/campaigns/{campaignId}/collections/{collectionId}/import Import data into existing campaign-level collection
ImportCoupons Post /v1/applications/{applicationId}/campaigns/{campaignId}/import_coupons Import coupons
ImportLoyaltyCards Post /v1/loyalty_programs/{loyaltyProgramId}/import_cards Import loyalty cards
ImportLoyaltyCustomersTiers Post /v1/loyalty_programs/{loyaltyProgramId}/import_customers_tiers Import customers into loyalty tiers
ImportLoyaltyPoints Post /v1/loyalty_programs/{loyaltyProgramId}/import_points Import loyalty points
ImportPoolGiveaways Post /v1/giveaways/pools/{poolId}/import Import giveaway codes into a giveaway pool
ImportReferrals Post /v1/applications/{applicationId}/campaigns/{campaignId}/import_referrals Import referrals
InviteUserExternal Post /v1/users/invite Invite user from identity provider
ListAccountCollections Get /v1/collections List collections in account
ListAchievements Get /v1/applications/{applicationId}/campaigns/{campaignId}/achievements List achievements
ListAllRolesV2 Get /v2/roles List roles
ListCatalogItems Get /v1/catalogs/{catalogId}/items List items in a catalog
ListCollections Get /v1/applications/{applicationId}/campaigns/{campaignId}/collections List collections in campaign
ListCollectionsInApplication Get /v1/applications/{applicationId}/collections List collections in Application
ListStores Get /v1/applications/{applicationId}/stores List stores
NotificationActivation Put /v1/notifications/{notificationId}/activation Activate or deactivate notification
OktaEventHandlerChallenge Get /v1/provisioning/okta Validate Okta API ownership
PostAddedDeductedPointsNotification Post /v1/loyalty_programs/{loyaltyProgramId}/notifications/added_deducted_points Create notification about added or deducted loyalty points
PostCatalogsStrikethroughNotification Post /v1/applications/{applicationId}/catalogs/notifications/strikethrough Create strikethrough notification
PostPendingPointsNotification Post /v1/loyalty_programs/{loyaltyProgramId}/notifications/pending_points Create notification about pending loyalty points
RemoveLoyaltyPoints Put /v1/loyalty_programs/{loyaltyProgramId}/profile/{integrationId}/deduct_points Deduct points from customer profile
ResetPassword Post /v1/reset_password Reset password
ScimCreateUser Post /v1/provisioning/scim/Users Create SCIM user
ScimDeleteUser Delete /v1/provisioning/scim/Users/{userId} Delete SCIM user
ScimGetResourceTypes Get /v1/provisioning/scim/ResourceTypes List supported SCIM resource types
ScimGetSchemas Get /v1/provisioning/scim/Schemas List supported SCIM schemas
ScimGetServiceProviderConfig Get /v1/provisioning/scim/ServiceProviderConfig Get SCIM service provider configuration
ScimGetUser Get /v1/provisioning/scim/Users/{userId} Get SCIM user
ScimGetUsers Get /v1/provisioning/scim/Users List SCIM users
ScimPatchUser Patch /v1/provisioning/scim/Users/{userId} Update SCIM user attributes
ScimReplaceUserAttributes Put /v1/provisioning/scim/Users/{userId} Update SCIM user
SearchCouponsAdvancedApplicationWideWithoutTotalCount Post /v1/applications/{applicationId}/coupons_search_advanced/no_total List coupons that match the given attributes (without total count)
SearchCouponsAdvancedWithoutTotalCount Post /v1/applications/{applicationId}/campaigns/{campaignId}/coupons_search_advanced/no_total List coupons that match the given attributes in campaign (without total count)
TransferLoyaltyCard Put /v1/loyalty_programs/{loyaltyProgramId}/cards/{loyaltyCardId}/transfer Transfer card data
UpdateAccountCollection Put /v1/collections/{collectionId} Update account-level collection
UpdateAchievement Put /v1/applications/{applicationId}/campaigns/{campaignId}/achievements/{achievementId} Update achievement
UpdateAdditionalCost Put /v1/additional_costs/{additionalCostId} Update additional cost
UpdateAttribute Put /v1/attributes/{attributeId} Update custom attribute
UpdateCampaign Put /v1/applications/{applicationId}/campaigns/{campaignId} Update campaign
UpdateCollection Put /v1/applications/{applicationId}/campaigns/{campaignId}/collections/{collectionId} Update campaign-level collection's description
UpdateCoupon Put /v1/applications/{applicationId}/campaigns/{campaignId}/coupons/{couponId} Update coupon
UpdateCouponBatch Put /v1/applications/{applicationId}/campaigns/{campaignId}/coupons Update coupons
UpdateLoyaltyCard Put /v1/loyalty_programs/{loyaltyProgramId}/cards/{loyaltyCardId} Update loyalty card status
UpdateReferral Put /v1/applications/{applicationId}/campaigns/{campaignId}/referrals/{referralId} Update referral
UpdateRoleV2 Put /v2/roles/{roleId} Update role
UpdateStore Put /v1/applications/{applicationId}/stores/{storeId} Update store
UpdateUser Put /v1/users/{userId} Update user

ActivateUserByEmail

ActivateUserByEmail(ctx, body)

Enable user by email address

Enable a disabled user by their email address.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
body DeactivateUserRequest body

Return type

(empty response body)

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: application/json
  • Accept: Not defined

[Back to top] [Back to API list] [Back to Model list] [Back to README]

AddLoyaltyCardPoints

AddLoyaltyCardPoints(ctx, loyaltyProgramId, loyaltyCardId, body)

Add points to card

Add points to the given loyalty card in the specified card-based loyalty program.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
loyaltyProgramId int32 Identifier of the card-based loyalty program containing the loyalty card. You can get the ID with the List loyalty programs endpoint.
loyaltyCardId string Identifier of the loyalty card. You can get the identifier with the List loyalty cards endpoint.
body AddLoyaltyPoints body

Return type

(empty response body)

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

AddLoyaltyPoints

AddLoyaltyPoints(ctx, loyaltyProgramId, integrationId, body)

Add points to customer profile

Add points in the specified loyalty program for the given customer. To get the integrationId of the profile from a sessionId, use the Update customer session endpoint.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
loyaltyProgramId string The identifier for the loyalty program.
integrationId string The identifier of the profile.
body AddLoyaltyPoints body

Return type

(empty response body)

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

CopyCampaignToApplications

InlineResponse2006 CopyCampaignToApplications(ctx, applicationId, campaignId, body)

Copy the campaign into the specified Application

Copy the campaign into all specified Applications.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
applicationId int32 The ID of the Application. It is displayed in your Talon.One deployment URL.
campaignId int32 The ID of the campaign. It is displayed in your Talon.One deployment URL.
body CampaignCopy body

Return type

InlineResponse2006

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

CreateAccountCollection

Collection CreateAccountCollection(ctx, body)

Create account-level collection

Create an account-level collection.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
body NewCollection body

Return type

Collection

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

CreateAchievement

Achievement CreateAchievement(ctx, applicationId, campaignId, body)

Create achievement

Create a new achievement in a specific campaign.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
applicationId int32 The ID of the Application. It is displayed in your Talon.One deployment URL.
campaignId int32 The ID of the campaign. It is displayed in your Talon.One deployment URL.
body CreateAchievement body

Return type

Achievement

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

CreateAdditionalCost

AccountAdditionalCost CreateAdditionalCost(ctx, body)

Create additional cost

Create an additional cost. These additional costs are shared across all applications in your account, and are never required.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
body NewAdditionalCost body

Return type

AccountAdditionalCost

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

CreateAttribute

Attribute CreateAttribute(ctx, body)

Create custom attribute

Create a custom attribute in this account. Custom attributes allow you to add data to Talon.One domain entities like campaigns, coupons, customers and so on. These attributes can then be given values when creating/updating these entities, and these values can be used in your campaign rules. For example, you could define a zipCode field for customer sessions, and add a rule to your campaign that only allows certain ZIP codes. These attributes are shared across all Applications in your account and are never required.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
body NewAttribute body

Return type

Attribute

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

CreateBatchLoyaltyCards

LoyaltyCardBatchResponse CreateBatchLoyaltyCards(ctx, loyaltyProgramId, body)

Create loyalty cards

Create a batch of loyalty cards in a specified card-based loyalty program. Customers can use loyalty cards to collect and spend loyalty points. Important: - The specified card-based loyalty program must have a defined card code format that is used to generate the loyalty card codes. - Trying to create more than 20,000 loyalty cards in a single request returns an error message with a 400 status code.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
loyaltyProgramId int32 Identifier of the card-based loyalty program containing the loyalty card. You can get the ID with the List loyalty programs endpoint.
body LoyaltyCardBatch body

Return type

LoyaltyCardBatchResponse

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

CreateCampaignFromTemplate

CreateTemplateCampaignResponse CreateCampaignFromTemplate(ctx, applicationId, body)

Create campaign from campaign template

Use the campaign template referenced in the request body to create a new campaign in one of the connected Applications. If the template was created from a campaign with rules referencing campaign collections, the corresponding collections for the new campaign are created automatically.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
applicationId int32 The ID of the Application. It is displayed in your Talon.One deployment URL.
body CreateTemplateCampaign body

Return type

CreateTemplateCampaignResponse

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

CreateCollection

Collection CreateCollection(ctx, applicationId, campaignId, body)

Create campaign-level collection

Create a campaign-level collection in a given campaign.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
applicationId int32 The ID of the Application. It is displayed in your Talon.One deployment URL.
campaignId int32 The ID of the campaign. It is displayed in your Talon.One deployment URL.
body NewCampaignCollection body

Return type

Collection

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

CreateCoupons

InlineResponse2008 CreateCoupons(ctx, applicationId, campaignId, body, optional)

Create coupons

Create coupons according to some pattern. Up to 20.000 coupons can be created without a unique prefix. When a unique prefix is provided, up to 200.000 coupons can be created.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
applicationId int32 The ID of the Application. It is displayed in your Talon.One deployment URL.
campaignId int32 The ID of the campaign. It is displayed in your Talon.One deployment URL.
body NewCoupons body
optional *CreateCouponsOpts optional parameters nil if no parameters

Optional Parameters

Optional parameters are passed through a pointer to a CreateCouponsOpts struct

Name Type Description Notes

silent | optional.| Possible values: `yes` or `no`. - `yes`: Increases the perfomance of the API call by returning a 204 response. - `no`: Returns a 200 response that contains the updated customer profiles. | [default to yes]

Return type

InlineResponse2008

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

CreateCouponsAsync

AsyncCouponCreationResponse CreateCouponsAsync(ctx, applicationId, campaignId, body)

Create coupons asynchronously

Create up to 5,000,000 coupons asynchronously. You should typically use this enpdoint when you create at least 20,001 coupons. You receive an email when the creation is complete. If you want to create less than 20,001 coupons, you can use the Create coupons endpoint.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
applicationId int32 The ID of the Application. It is displayed in your Talon.One deployment URL.
campaignId int32 The ID of the campaign. It is displayed in your Talon.One deployment URL.
body NewCouponCreationJob body

Return type

AsyncCouponCreationResponse

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

CreateCouponsDeletionJob

AsyncCouponDeletionJobResponse CreateCouponsDeletionJob(ctx, applicationId, campaignId, body)

Creates a coupon deletion job

This endpoint handles creating a job to delete coupons asynchronously.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
applicationId int32 The ID of the Application. It is displayed in your Talon.One deployment URL.
campaignId int32 The ID of the campaign. It is displayed in your Talon.One deployment URL.
body NewCouponDeletionJob body

Return type

AsyncCouponDeletionJobResponse

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

CreateCouponsForMultipleRecipients

InlineResponse2008 CreateCouponsForMultipleRecipients(ctx, applicationId, campaignId, body, optional)

Create coupons for multiple recipients

Create coupons according to some pattern for up to 1000 recipients.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
applicationId int32 The ID of the Application. It is displayed in your Talon.One deployment URL.
campaignId int32 The ID of the campaign. It is displayed in your Talon.One deployment URL.
body NewCouponsForMultipleRecipients body
optional *CreateCouponsForMultipleRecipientsOpts optional parameters nil if no parameters

Optional Parameters

Optional parameters are passed through a pointer to a CreateCouponsForMultipleRecipientsOpts struct

Name Type Description Notes

silent | optional.| Possible values: `yes` or `no`. - `yes`: Increases the perfomance of the API call by returning a 204 response. - `no`: Returns a 200 response that contains the updated customer profiles. | [default to yes]

Return type

InlineResponse2008

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

CreateInviteEmail

NewInviteEmail CreateInviteEmail(ctx, body)

Resend invitation email

Resend an email invitation to an existing user. Note: The invitation token is valid for 24 hours after the email has been sent.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
body NewInviteEmail body

Return type

NewInviteEmail

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

CreateInviteV2

User CreateInviteV2(ctx, body)

Invite user

Create a new user in the account and send an invitation to their email address. Note: The invitation token is valid for 24 hours after the email has been sent. You can resend an invitation to a user with the Resend invitation email endpoint.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
body NewInvitation body

Return type

User

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

CreatePasswordRecoveryEmail

NewPasswordEmail CreatePasswordRecoveryEmail(ctx, body)

Request a password reset

Send an email with a password recovery link to the email address of an existing account. Note: The password recovery link expires 30 minutes after this endpoint is triggered.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
body NewPasswordEmail body

Return type

NewPasswordEmail

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

CreateSession

Session CreateSession(ctx, body)

Create session

Create a session to use the Management API endpoints. Use the value of the token property provided in the response as bearer token in other API calls. A token is valid for 3 months. In accordance with best pratices, use your generated token for all your API requests. Do not regenerate a token for each request. This endpoint has a rate limit of 3 to 6 requests per second per account, depending on your setup. <div class="redoc-section"> <p class="title">Granular API key

Instead of using a session, you can also use the <a href="https://docs.talon.one/docs/product/account/dev-tools/managing-mapi-keys\">Management API key feature in the Campaign Manager to decide which endpoints can be used with a given key.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
body LoginParams body

Return type

Session

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

CreateStore

Store CreateStore(ctx, applicationId, body)

Create store

Create a new store in a specific Application.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
applicationId int32 The ID of the Application. It is displayed in your Talon.One deployment URL.
body NewStore body

Return type

Store

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

DeactivateUserByEmail

DeactivateUserByEmail(ctx, body)

Disable user by email address

Disable a specific user by their email address.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
body DeactivateUserRequest body

Return type

(empty response body)

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: application/json
  • Accept: Not defined

[Back to top] [Back to API list] [Back to Model list] [Back to README]

DeductLoyaltyCardPoints

DeductLoyaltyCardPoints(ctx, loyaltyProgramId, loyaltyCardId, body)

Deduct points from card

Deduct points from the given loyalty card in the specified card-based loyalty program.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
loyaltyProgramId int32 Identifier of the card-based loyalty program containing the loyalty card. You can get the ID with the List loyalty programs endpoint.
loyaltyCardId string Identifier of the loyalty card. You can get the identifier with the List loyalty cards endpoint.
body DeductLoyaltyPoints body

Return type

(empty response body)

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

DeleteAccountCollection

DeleteAccountCollection(ctx, collectionId)

Delete account-level collection

Delete a given account-level collection.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
collectionId int32 The ID of the collection. You can get it with the List collections in account endpoint.

Return type

(empty response body)

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

DeleteAchievement

DeleteAchievement(ctx, applicationId, campaignId, achievementId)

Delete achievement

Delete the specified achievement.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
applicationId int32 The ID of the Application. It is displayed in your Talon.One deployment URL.
campaignId int32 The ID of the campaign. It is displayed in your Talon.One deployment URL.
achievementId int32 The ID of the achievement. You can get this ID with the List achievement endpoint.

Return type

(empty response body)

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

DeleteCampaign

DeleteCampaign(ctx, applicationId, campaignId)

Delete campaign

Delete the given campaign.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
applicationId int32 The ID of the Application. It is displayed in your Talon.One deployment URL.
campaignId int32 The ID of the campaign. It is displayed in your Talon.One deployment URL.

Return type

(empty response body)

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: Not defined

[Back to top] [Back to API list] [Back to Model list] [Back to README]

DeleteCollection

DeleteCollection(ctx, applicationId, campaignId, collectionId)

Delete campaign-level collection

Delete a given campaign-level collection.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
applicationId int32 The ID of the Application. It is displayed in your Talon.One deployment URL.
campaignId int32 The ID of the campaign. It is displayed in your Talon.One deployment URL.
collectionId int32 The ID of the collection. You can get it with the List collections in Application endpoint.

Return type

(empty response body)

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

DeleteCoupon

DeleteCoupon(ctx, applicationId, campaignId, couponId)

Delete coupon

Delete the specified coupon.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
applicationId int32 The ID of the Application. It is displayed in your Talon.One deployment URL.
campaignId int32 The ID of the campaign. It is displayed in your Talon.One deployment URL.
couponId string The internal ID of the coupon code. You can find this value in the `id` property from the List coupons endpoint response.

Return type

(empty response body)

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: Not defined

[Back to top] [Back to API list] [Back to Model list] [Back to README]

DeleteCoupons

DeleteCoupons(ctx, applicationId, campaignId, optional)

Delete coupons

Deletes all the coupons matching the specified criteria.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
applicationId int32 The ID of the Application. It is displayed in your Talon.One deployment URL.
campaignId int32 The ID of the campaign. It is displayed in your Talon.One deployment URL.
optional *DeleteCouponsOpts optional parameters nil if no parameters

Optional Parameters

Optional parameters are passed through a pointer to a DeleteCouponsOpts struct

Name Type Description Notes

value | optional.| Filter results performing case-insensitive matching against the coupon code. Both the code and the query are folded to remove all non-alpha-numeric characters. | createdBefore | optional.| Filter results comparing the parameter value, expected to be an RFC3339 timestamp string, to the coupon creation timestamp. You can use any time zone setting. Talon.One will convert to UTC internally. | createdAfter | optional.| Filter results comparing the parameter value, expected to be an RFC3339 timestamp string, to the coupon creation timestamp. You can use any time zone setting. Talon.One will convert to UTC internally. | startsAfter | optional.| Filter results comparing the parameter value, expected to be an RFC3339 timestamp string, to the coupon start date timestamp. You can use any time zone setting. Talon.One will convert to UTC internally. | startsBefore | optional.| Filter results comparing the parameter value, expected to be an RFC3339 timestamp string, to the coupon start date timestamp. You can use any time zone setting. Talon.One will convert to UTC internally. | expiresAfter | optional.| Filter results comparing the parameter value, expected to be an RFC3339 timestamp string, to the coupon expiration date timestamp. You can use any time zone setting. Talon.One will convert to UTC internally. | expiresBefore | optional.| Filter results comparing the parameter value, expected to be an RFC3339 timestamp string, to the coupon expiration date timestamp. You can use any time zone setting. Talon.One will convert to UTC internally. | valid | optional.| - `expired`: Matches coupons in which the expiration date is set and in the past. - `validNow`: Matches coupons in which start date is null or in the past and expiration date is null or in the future. - `validFuture`: Matches coupons in which start date is set and in the future. | batchId | optional.| Filter results by batches of coupons | usable | optional.| - `true`: only coupons where `usageCounter < usageLimit` will be returned. - `false`: only coupons where `usageCounter >= usageLimit` will be returned. | referralId | optional.| Filter the results by matching them with the ID of a referral. This filter shows the coupons created by redeeming a referral code. | recipientIntegrationId | optional.| Filter results by match with a profile ID specified in the coupon's `RecipientIntegrationId` field. | exactMatch | optional.| Filter results to an exact case-insensitive matching against the coupon code | [default to false]

Return type

(empty response body)

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: Not defined

[Back to top] [Back to API list] [Back to Model list] [Back to README]

DeleteLoyaltyCard

DeleteLoyaltyCard(ctx, loyaltyProgramId, loyaltyCardId)

Delete loyalty card

Delete the given loyalty card.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
loyaltyProgramId int32 Identifier of the card-based loyalty program containing the loyalty card. You can get the ID with the List loyalty programs endpoint.
loyaltyCardId string Identifier of the loyalty card. You can get the identifier with the List loyalty cards endpoint.

Return type

(empty response body)

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

DeleteReferral

DeleteReferral(ctx, applicationId, campaignId, referralId)

Delete referral

Delete the specified referral.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
applicationId int32 The ID of the Application. It is displayed in your Talon.One deployment URL.
campaignId int32 The ID of the campaign. It is displayed in your Talon.One deployment URL.
referralId string The ID of the referral code.

Return type

(empty response body)

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: Not defined

[Back to top] [Back to API list] [Back to Model list] [Back to README]

DeleteStore

DeleteStore(ctx, applicationId, storeId)

Delete store

Delete the specified store.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
applicationId int32 The ID of the Application. It is displayed in your Talon.One deployment URL.
storeId string The ID of the store. You can get this ID with the List stores endpoint.

Return type

(empty response body)

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

DeleteUser

DeleteUser(ctx, userId)

Delete user

Delete a specific user.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
userId int32 The ID of the user.

Return type

(empty response body)

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: Not defined

[Back to top] [Back to API list] [Back to Model list] [Back to README]

DeleteUserByEmail

DeleteUserByEmail(ctx, body)

Delete user by email address

Delete a specific user by their email address.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
body DeactivateUserRequest body

Return type

(empty response body)

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: application/json
  • Accept: Not defined

[Back to top] [Back to API list] [Back to Model list] [Back to README]

DestroySession

DestroySession(ctx, )

Destroy session

Destroys the session.

Required Parameters

This endpoint does not need any parameter.

Return type

(empty response body)

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: Not defined

[Back to top] [Back to API list] [Back to Model list] [Back to README]

DisconnectCampaignStores

DisconnectCampaignStores(ctx, applicationId, campaignId)

Disconnect stores

Disconnect the stores linked to a specific campaign.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
applicationId int32 The ID of the Application. It is displayed in your Talon.One deployment URL.
campaignId int32 The ID of the campaign. It is displayed in your Talon.One deployment URL.

Return type

(empty response body)

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

ExportAccountCollectionItems

string ExportAccountCollectionItems(ctx, collectionId)

Export account-level collection's items

Download a CSV file containing items from a given account-level collection. Tip: If the exported CSV file is too large to view, you can split it into multiple files.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
collectionId int32 The ID of the collection. You can get it with the List collections in account endpoint.

Return type

string

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/csv

[Back to top] [Back to API list] [Back to Model list] [Back to README]

ExportAchievements

string ExportAchievements(ctx, applicationId, campaignId, achievementId)

Export achievement customer data

Download a CSV file containing a list of all the customers who have participated in and are currently participating in the given achievement. The CSV file contains the following columns: - profileIntegrationID: The integration ID of the customer profile participating in the achievement. - title: The display name of the achievement in the Campaign Manager. - target: The required number of actions or the transactional milestone to complete the achievement. - progress: The current progress of the customer in the achievement. - status: The status of the achievement. Can be one of: ['inprogress', 'completed', 'expired']. - startDate: The date on which the customer profile started the achievement in RFC3339. - endDate: The date on which the achievement ends and resets for the customer profile in RFC3339. - completionDate: The date on which the customer profile completed the achievement in RFC3339.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
applicationId int32 The ID of the Application. It is displayed in your Talon.One deployment URL.
campaignId int32 The ID of the campaign. It is displayed in your Talon.One deployment URL.
achievementId int32 The ID of the achievement. You can get this ID with the List achievement endpoint.

Return type

string

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/csv

[Back to top] [Back to API list] [Back to Model list] [Back to README]

ExportAudiencesMemberships

string ExportAudiencesMemberships(ctx, audienceId)

Export audience members

Download a CSV file containing the integration IDs of the members of an audience. Tip: If the exported CSV file is too large to view, you can split it into multiple files. The file contains the following column: - profileintegrationid: The integration ID of the customer profile.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
audienceId int32 The ID of the audience.

Return type

string

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/csv

[Back to top] [Back to API list] [Back to Model list] [Back to README]

ExportCampaignStores

string ExportCampaignStores(ctx, applicationId, campaignId)

Export stores

Download a CSV file containing the stores linked to a specific campaign. Tip: If the exported CSV file is too large to view, you can split it into multiple files. The CSV file contains the following column: - store_integration_id: The identifier of the store.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
applicationId int32 The ID of the Application. It is displayed in your Talon.One deployment URL.
campaignId int32 The ID of the campaign. It is displayed in your Talon.One deployment URL.

Return type

string

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/csv

[Back to top] [Back to API list] [Back to Model list] [Back to README]

ExportCollectionItems

string ExportCollectionItems(ctx, applicationId, campaignId, collectionId)

Export campaign-level collection's items

Download a CSV file containing items from a given campaign-level collection. Tip: If the exported CSV file is too large to view, you can split it into multiple files.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
applicationId int32 The ID of the Application. It is displayed in your Talon.One deployment URL.
campaignId int32 The ID of the campaign. It is displayed in your Talon.One deployment URL.
collectionId int32 The ID of the collection. You can get it with the List collections in Application endpoint.

Return type

string

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/csv

[Back to top] [Back to API list] [Back to Model list] [Back to README]

ExportCoupons

string ExportCoupons(ctx, applicationId, optional)

Export coupons

Download a CSV file containing the coupons that match the given properties. Tip: If the exported CSV file is too large to view, you can split it into multiple files. The CSV file can contain the following columns: - accountid: The ID of your deployment. - applicationid: The ID of the Application this coupon is related to. - attributes: A json object describing custom referral attribute names and their values. - batchid: The ID of the batch this coupon is part of. - campaignid: The ID of the campaign this coupon is related to. - counter: The number of times this coupon has been redeemed. - created: The creation date in RFC3339 of the coupon code. - deleted: Whether the coupon code is deleted. - deleted_changelogid: The ID of the delete event in the logs. - discount_counter: The amount of discount given by this coupon. - discount_limitval: The maximum discount amount that can be given be this coupon. - expirydate: The end date in RFC3339 of the code redemption period. - id: The internal ID of the coupon code. - importid: The ID of the import job that created this coupon. - is_reservation_mandatory: Whether this coupon requires a reservation to be redeemed. - limits: The limits set on this coupon. - limitval: The maximum number of redemptions of this code. - recipientintegrationid: The integration ID of the recipient of the coupon. Only the customer with this integration ID can redeem this code. Available only for personal codes. - referralid: The ID of the referral code that triggered the creation of this coupon (create coupon effect). - reservation: Whether the coupon can be reserved for multiple customers. - reservation_counter: How many times this coupon has been reserved. - reservation_limitval: The maximum of number of reservations this coupon can have. - startdate: The start date in RFC3339 of the code redemption period. - value: The coupon code.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
applicationId int32 The ID of the Application. It is displayed in your Talon.One deployment URL.
optional *ExportCouponsOpts optional parameters nil if no parameters

Optional Parameters

Optional parameters are passed through a pointer to a ExportCouponsOpts struct

Name Type Description Notes

campaignId | optional.| Filter results by campaign ID. | sort | optional.| The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. Note: This parameter works only with numeric fields. | value | optional.| Filter results performing case-insensitive matching against the coupon code. Both the code and the query are folded to remove all non-alpha-numeric characters. | createdBefore | optional.| Filter results comparing the parameter value, expected to be an RFC3339 timestamp string, to the coupon creation timestamp. You can use any time zone setting. Talon.One will convert to UTC internally. | createdAfter | optional.| Filter results comparing the parameter value, expected to be an RFC3339 timestamp string, to the coupon creation timestamp. You can use any time zone setting. Talon.One will convert to UTC internally. | valid | optional.| Either &quot;expired&quot;, &quot;validNow&quot;, or &quot;validFuture&quot;. The first option matches coupons in which the expiration date is set and in the past. The second matches coupons in which start date is null or in the past and expiration date is null or in the future, the third matches coupons in which start date is set and in the future. | usable | optional.| Either &quot;true&quot; or &quot;false&quot;. If &quot;true&quot;, only coupons where `usageCounter < usageLimit` will be returned, &quot;false&quot; will return only coupons where `usageCounter >= usageLimit`. | referralId | optional.| Filter the results by matching them with the ID of a referral. This filter shows the coupons created by redeeming a referral code. | recipientIntegrationId | optional.| Filter results by match with a profile id specified in the coupon's RecipientIntegrationId field. | batchId | optional.| Filter results by batches of coupons | exactMatch | optional.| Filter results to an exact case-insensitive matching against the coupon code. | [default to false] dateFormat | optional.| Determines the format of dates in the export document. | campaignState | optional.| Filter results by the state of the campaign. - `enabled`: Campaigns that are scheduled, running (activated), or expired. - `running`: Campaigns that are running (activated). - `disabled`: Campaigns that are disabled. - `expired`: Campaigns that are expired. - `archived`: Campaigns that are archived. | valuesOnly | optional.| Filter results to only return the coupon codes (`value` column) without the associated coupon data. | [default to false]

Return type

string

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/csv

[Back to top] [Back to API list] [Back to Model list] [Back to README]

ExportCustomerSessions

string ExportCustomerSessions(ctx, applicationId, optional)

Export customer sessions

Download a CSV file containing the customer sessions that match the request. Important: Archived sessions cannot be exported. See the retention policy. Tip: If the exported CSV file is too large to view, you can split it into multiple files. - id: The internal ID of the session. - firstsession: Whether this is a first session. - integrationid: The integration ID of the session. - applicationid: The ID of the Application. - profileid: The internal ID of the customer profile. - profileintegrationid: The integration ID of the customer profile. - created: The timestamp when the session was created. - state: The state of the session. - cartitems: The cart items in the session. - discounts: The discounts in the session. - total: The total value of cart items and additional costs in the session, before any discounts are applied. - attributes: The attributes set in the session. - closedat: Timestamp when the session was closed. - cancelledat: Timestamp when the session was cancelled. - referral: The referral code in the session. - identifiers: The identifiers in the session. - additional_costs: The additional costs in the session. - updated: Timestamp of the last session update. - store_integration_id: The integration ID of the store. - coupons: Coupon codes in the session.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
applicationId int32 The ID of the Application. It is displayed in your Talon.One deployment URL.
optional *ExportCustomerSessionsOpts optional parameters nil if no parameters

Optional Parameters

Optional parameters are passed through a pointer to a ExportCustomerSessionsOpts struct

Name Type Description Notes

createdBefore | optional.| Filter results comparing the parameter value, expected to be an RFC3339 timestamp string. | createdAfter | optional.| Filter results comparing the parameter value, expected to be an RFC3339 timestamp string. | profileIntegrationId | optional.| Only return sessions for the customer that matches this customer integration ID. | dateFormat | optional.| Determines the format of dates in the export document. | customerSessionState | optional.| Filter results by state. |

Return type

string

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/csv

[Back to top] [Back to API list] [Back to Model list] [Back to README]

ExportCustomersTiers

string ExportCustomersTiers(ctx, loyaltyProgramId, optional)

Export customers' tier data

Download a CSV file containing the tier information for customers of the specified loyalty program. The generated file contains the following columns: - programid: The identifier of the loyalty program. It is displayed in your Talon.One deployment URL. - subledgerid: The ID of the subledger associated with the loyalty program. This column is empty if the loyalty program has no subledger. In this case, refer to the export file name to get the ID of the loyalty program. - customerprofileid: The ID used to integrate customer profiles with the loyalty program. - tiername: The name of the tier. - startdate: The tier start date in RFC3339. - expirydate: The tier expiry date in RFC3339. You can filter the results by providing the following optional input parameters: - subledgerIds (optional): Filter results by an array of subledger IDs. If no value is provided, all subledger data for the specified loyalty program will be exported. - tierNames (optional): Filter results by an array of tier names. If no value is provided, all tier data for the specified loyalty program will be exported.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
loyaltyProgramId string The identifier for the loyalty program.
optional *ExportCustomersTiersOpts optional parameters nil if no parameters

Optional Parameters

Optional parameters are passed through a pointer to a ExportCustomersTiersOpts struct

Name Type Description Notes

subledgerIds | optional.Interface of []string| An array of subledgers IDs to filter the export by. | tierNames | optional.Interface of []string| An array of tier names to filter the export by. |

Return type

string

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/csv

[Back to top] [Back to API list] [Back to Model list] [Back to README]

ExportEffects

string ExportEffects(ctx, applicationId, optional)

Export triggered effects

Download a CSV file containing the triggered effects that match the given attributes. Tip: If the exported CSV file is too large to view, you can split it into multiple files. The generated file can contain the following columns: - applicationid: The ID of the Application. - campaignid: The ID of the campaign. - couponid: The ID of the coupon, when applicable to the effect. - created: The timestamp of the effect. - event_type: The name of the event. See the docs. - eventid: The internal ID of the effect. - name: The effect name. See the docs. - profileintegrationid: The ID of the customer profile, when applicable. - props: The properties of the effect. - ruleindex: The index of the rule. - rulesetid: The ID of the rule set. - sessionid: The internal ID of the session that triggered the effect. - profileid: The internal ID of the customer profile. - sessionintegrationid: The integration ID of the session. - total_revenue: The total revenue. - store_integration_id: The integration ID of the store. You choose this ID when you create a store.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
applicationId int32 The ID of the Application. It is displayed in your Talon.One deployment URL.
optional *ExportEffectsOpts optional parameters nil if no parameters

Optional Parameters

Optional parameters are passed through a pointer to a ExportEffectsOpts struct

Name Type Description Notes

campaignId | optional.| Filter results by campaign ID. | createdBefore | optional.| Filter results comparing the parameter value, expected to be an RFC3339 timestamp string. You can use any time zone setting. Talon.One will convert to UTC internally. | createdAfter | optional.| Filter results comparing the parameter value, expected to be an RFC3339 timestamp string. You can use any time zone setting. Talon.One will convert to UTC internally. | dateFormat | optional.| Determines the format of dates in the export document. |

Return type

string

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/csv

[Back to top] [Back to API list] [Back to Model list] [Back to README]

ExportLoyaltyBalance

string ExportLoyaltyBalance(ctx, loyaltyProgramId, optional)

Export customer loyalty balance to CSV

⚠️ Deprecation notice: Support for requests to this endpoint will end soon. To export customer loyalty balances to CSV, use the Export customer loyalty balances to CSV endpoint. Download a CSV file containing the balance of each customer in the loyalty program. Tip: If the exported CSV file is too large to view, you can split it into multiple files.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
loyaltyProgramId string The identifier for the loyalty program.
optional *ExportLoyaltyBalanceOpts optional parameters nil if no parameters

Optional Parameters

Optional parameters are passed through a pointer to a ExportLoyaltyBalanceOpts struct

Name Type Description Notes

endDate | optional.| Used to return expired, active, and pending loyalty balances before this timestamp. You can enter any past, present, or future timestamp value. Note: - It must be an RFC3339 timestamp string. - You can include a time component in your string, for example, `T23:59:59` to specify the end of the day. The time zone setting considered is `UTC`. If you do not include a time component, a default time value of `T00:00:00` (midnight) in `UTC` is considered. |

Return type

string

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/csv

[Back to top] [Back to API list] [Back to Model list] [Back to README]

ExportLoyaltyBalances

string ExportLoyaltyBalances(ctx, loyaltyProgramId, optional)

Export customer loyalty balances

Download a CSV file containing the balance of each customer in the loyalty program. Tip: If the exported CSV file is too large to view, you can split it into multiple files. The generated file can contain the following columns: - loyaltyProgramID: The ID of the loyalty program. - loyaltySubledger: The name of the subdleger, when applicatble. - profileIntegrationID: The integration ID of the customer profile. - currentBalance: The current point balance. - pendingBalance: The number of pending points. - expiredBalance: The number of expired points. - spentBalance: The number of spent points. - currentTier: The tier that the customer is in at the time of the export.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
loyaltyProgramId string The identifier for the loyalty program.
optional *ExportLoyaltyBalancesOpts optional parameters nil if no parameters

Optional Parameters

Optional parameters are passed through a pointer to a ExportLoyaltyBalancesOpts struct

Name Type Description Notes

endDate | optional.| Used to return expired, active, and pending loyalty balances before this timestamp. You can enter any past, present, or future timestamp value. Note: - It must be an RFC3339 timestamp string. - You can include a time component in your string, for example, `T23:59:59` to specify the end of the day. The time zone setting considered is `UTC`. If you do not include a time component, a default time value of `T00:00:00` (midnight) in `UTC` is considered. |

Return type

string

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/csv

[Back to top] [Back to API list] [Back to Model list] [Back to README]

ExportLoyaltyCardBalances

string ExportLoyaltyCardBalances(ctx, loyaltyProgramId, optional)

Export all card transaction logs

Download a CSV file containing the balances of all cards in the loyalty program. Tip: If the exported CSV file is too large to view, you can split it into multiple files. The CSV file contains the following columns: - loyaltyProgramID: The ID of the loyalty program. - loyaltySubledger: The name of the subdleger, when applicatble. - cardIdentifier: The alphanumeric identifier of the loyalty card. - cardState:The state of the loyalty card. It can be active or inactive. - currentBalance: The current point balance. - pendingBalance: The number of pending points. - expiredBalance: The number of expired points. - spentBalance: The number of spent points.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
loyaltyProgramId int32 Identifier of the card-based loyalty program containing the loyalty card. You can get the ID with the List loyalty programs endpoint.
optional *ExportLoyaltyCardBalancesOpts optional parameters nil if no parameters

Optional Parameters

Optional parameters are passed through a pointer to a ExportLoyaltyCardBalancesOpts struct

Name Type Description Notes

endDate | optional.| Used to return expired, active, and pending loyalty balances before this timestamp. You can enter any past, present, or future timestamp value. Note: - It must be an RFC3339 timestamp string. - You can include a time component in your string, for example, `T23:59:59` to specify the end of the day. The time zone setting considered is `UTC`. If you do not include a time component, a default time value of `T00:00:00` (midnight) in `UTC` is considered. |

Return type

string

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/csv

[Back to top] [Back to API list] [Back to Model list] [Back to README]

ExportLoyaltyCardLedger

string ExportLoyaltyCardLedger(ctx, loyaltyProgramId, loyaltyCardId, rangeStart, rangeEnd, optional)

Export card's ledger log

Download a CSV file containing a loyalty card ledger log of the loyalty program. Tip: If the exported CSV file is too large to view, you can split it into multiple files.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
loyaltyProgramId int32 Identifier of the card-based loyalty program containing the loyalty card. You can get the ID with the List loyalty programs endpoint.
loyaltyCardId string Identifier of the loyalty card. You can get the identifier with the List loyalty cards endpoint.
rangeStart time.Time Only return results from after this timestamp. Note: - This must be an RFC3339 timestamp string. - You can include a time component in your string, for example, `T23:59:59` to specify the end of the day. The time zone setting considered is `UTC`. If you do not include a time component, a default time value of `T00:00:00` (midnight) in `UTC` is considered.
rangeEnd time.Time Only return results from before this timestamp. Note: - This must be an RFC3339 timestamp string. - You can include a time component in your string, for example, `T23:59:59` to specify the end of the day. The time zone setting considered is `UTC`. If you do not include a time component, a default time value of `T00:00:00` (midnight) in `UTC` is considered.
optional *ExportLoyaltyCardLedgerOpts optional parameters nil if no parameters

Optional Parameters

Optional parameters are passed through a pointer to a ExportLoyaltyCardLedgerOpts struct

Name Type Description Notes

dateFormat | optional.| Determines the format of dates in the export document. |

Return type

string

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/csv

[Back to top] [Back to API list] [Back to Model list] [Back to README]

ExportLoyaltyCards

string ExportLoyaltyCards(ctx, loyaltyProgramId, optional)

Export loyalty cards

Download a CSV file containing the loyalty cards from a specified loyalty program. Tip: If the exported CSV file is too large to view, you can split it into multiple files. The CSV file contains the following columns: - identifier: The unique identifier of the loyalty card. - created: The date and time the loyalty card was created. - status: The status of the loyalty card. - userpercardlimit: The maximum number of customer profiles that can be linked to the card. - customerprofileids: Integration IDs of the customer profiles linked to the card. - blockreason: The reason for transferring and blocking the loyalty card. - generated: An indicator of whether the loyalty card was generated. - batchid: The ID of the batch the loyalty card is in.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
loyaltyProgramId int32 Identifier of the card-based loyalty program containing the loyalty card. You can get the ID with the List loyalty programs endpoint.
optional *ExportLoyaltyCardsOpts optional parameters nil if no parameters

Optional Parameters

Optional parameters are passed through a pointer to a ExportLoyaltyCardsOpts struct

Name Type Description Notes

batchId | optional.| Filter results by loyalty card batch ID. | dateFormat | optional.| Determines the format of dates in the export document. |

Return type

string

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/csv

[Back to top] [Back to API list] [Back to Model list] [Back to README]

ExportLoyaltyLedger

string ExportLoyaltyLedger(ctx, rangeStart, rangeEnd, loyaltyProgramId, integrationId, optional)

Export customer's transaction logs

Download a CSV file containing a customer's transaction logs in the loyalty program. Tip: If the exported CSV file is too large to view, you can split it into multiple files. The generated file can contain the following columns: - customerprofileid: The ID of the profile. - customersessionid: The ID of the customer session. - rulesetid: The ID of the rule set. - rulename: The name of the rule. - programid: The ID of the loyalty program. - type: The transaction type, such as addition or subtraction. - name: The reason for the transaction. - subledgerid: The ID of the subledger, when applicable. - startdate: The start date of the program. - expirydate: The expiration date of the program. - id: The ID of the transaction. - created: The timestamp of the creation of the loyalty program. - amount: The number of points in that transaction. - archived: Whether the session related to the transaction is archived. - campaignid: The ID of the campaign.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
rangeStart time.Time Only return results from after this timestamp. Note: - This must be an RFC3339 timestamp string. - You can include a time component in your string, for example, `T23:59:59` to specify the end of the day. The time zone setting considered is `UTC`. If you do not include a time component, a default time value of `T00:00:00` (midnight) in `UTC` is considered.
rangeEnd time.Time Only return results from before this timestamp. Note: - This must be an RFC3339 timestamp string. - You can include a time component in your string, for example, `T23:59:59` to specify the end of the day. The time zone setting considered is `UTC`. If you do not include a time component, a default time value of `T00:00:00` (midnight) in `UTC` is considered.
loyaltyProgramId string The identifier for the loyalty program.
integrationId string The identifier of the profile.
optional *ExportLoyaltyLedgerOpts optional parameters nil if no parameters

Optional Parameters

Optional parameters are passed through a pointer to a ExportLoyaltyLedgerOpts struct

Name Type Description Notes

dateFormat | optional.| Determines the format of dates in the export document. |

Return type

string

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/csv

[Back to top] [Back to API list] [Back to Model list] [Back to README]

ExportPoolGiveaways

string ExportPoolGiveaways(ctx, poolId, optional)

Export giveaway codes of a giveaway pool

Download a CSV file containing the giveaway codes of a specific giveaway pool. Tip: If the exported CSV file is too large to view, you can split it into multiple files. The CSV file contains the following columns: - id: The internal ID of the giveaway. - poolid: The internal ID of the giveaway pool. - code: The giveaway code. - startdate: The validity start date in RFC3339 of the giveaway (can be empty). - enddate: The validity end date in RFC3339 of the giveaway (can be empty). - attributes: Any custom attributes associated with the giveaway code (can be empty). - used: An indication of whether the giveaway is already awarded. - importid: The ID of the import which created the giveaway. - created: The creation time of the giveaway code. - profileintegrationid: The third-party integration ID of the customer profile that was awarded the giveaway. Can be empty if the giveaway was not awarded. - profileid: The internal ID of the customer profile that was awarded the giveaway. Can be empty if the giveaway was not awarded or an internal ID does not exist.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
poolId int32 The ID of the pool. You can find it in the Campaign Manager, in the Giveaways section.
optional *ExportPoolGiveawaysOpts optional parameters nil if no parameters

Optional Parameters

Optional parameters are passed through a pointer to a ExportPoolGiveawaysOpts struct

Name Type Description Notes

createdBefore | optional.| Timestamp that filters the results to only contain giveaways created before this date. Must be an RFC3339 timestamp string. | createdAfter | optional.| Timestamp that filters the results to only contain giveaways created after this date. Must be an RFC3339 timestamp string. |

Return type

string

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/csv

[Back to top] [Back to API list] [Back to Model list] [Back to README]

ExportReferrals

string ExportReferrals(ctx, applicationId, optional)

Export referrals

Download a CSV file containing the referrals that match the given parameters. Tip: If the exported CSV file is too large to view, you can split it into multiple files. The CSV file contains the following columns: - code: The referral code. - advocateprofileintegrationid: The profile ID of the advocate. - startdate: The start date in RFC3339 of the code redemption period. - expirydate: The end date in RFC3339 of the code redemption period. - limitval: The maximum number of redemptions of this code. Defaults to 1 when left blank. - attributes: A json object describing custom referral attribute names and their values.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
applicationId int32 The ID of the Application. It is displayed in your Talon.One deployment URL.
optional *ExportReferralsOpts optional parameters nil if no parameters

Optional Parameters

Optional parameters are passed through a pointer to a ExportReferralsOpts struct

Name Type Description Notes

campaignId | optional.| Filter results by campaign ID. | createdBefore | optional.| Filter results comparing the parameter value, expected to be an RFC3339 timestamp string, to the referral creation timestamp. You can use any time zone setting. Talon.One will convert to UTC internally. | createdAfter | optional.| Filter results comparing the parameter value, expected to be an RFC3339 timestamp string, to the referral creation timestamp. You can use any time zone setting. Talon.One will convert to UTC internally. | valid | optional.| - `expired`: Matches referrals in which the expiration date is set and in the past. - `validNow`: Matches referrals in which start date is null or in the past and expiration date is null or in the future. - `validFuture`: Matches referrals in which start date is set and in the future. | usable | optional.| - `true`, only referrals where `usageCounter < usageLimit` will be returned. - `false`, only referrals where `usageCounter >= usageLimit` will be returned. | batchId | optional.| Filter results by batches of referrals | dateFormat | optional.| Determines the format of dates in the export document. |

Return type

string

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/csv

[Back to top] [Back to API list] [Back to Model list] [Back to README]

GetAccessLogsWithoutTotalCount

InlineResponse20019 GetAccessLogsWithoutTotalCount(ctx, applicationId, rangeStart, rangeEnd, optional)

Get access logs for Application

Retrieve the list of API calls sent to the specified Application.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
applicationId int32 The ID of the Application. It is displayed in your Talon.One deployment URL.
rangeStart time.Time Only return results from after this timestamp. Note: - This must be an RFC3339 timestamp string. - You can include a time component in your string, for example, `T23:59:59` to specify the end of the day. The time zone setting considered is `UTC`. If you do not include a time component, a default time value of `T00:00:00` (midnight) in `UTC` is considered.
rangeEnd time.Time Only return results from before this timestamp. Note: - This must be an RFC3339 timestamp string. - You can include a time component in your string, for example, `T23:59:59` to specify the end of the day. The time zone setting considered is `UTC`. If you do not include a time component, a default time value of `T00:00:00` (midnight) in `UTC` is considered.
optional *GetAccessLogsWithoutTotalCountOpts optional parameters nil if no parameters

Optional Parameters

Optional parameters are passed through a pointer to a GetAccessLogsWithoutTotalCountOpts struct

Name Type Description Notes

path | optional.| Only return results where the request path matches the given regular expression. | method | optional.| Only return results where the request method matches the given regular expression. | status | optional.| Filter results by HTTP status codes. | pageSize | optional.| The number of items in the response. | [default to 1000] skip | optional.| The number of items to skip when paging through large result sets. | sort | optional.| The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. Note: This parameter works only with numeric fields. |

Return type

InlineResponse20019

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

GetAccount

Account GetAccount(ctx, accountId)

Get account details

Return the details of your companies Talon.One account.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
accountId int32 The identifier of the account. Retrieve it via the List users in account endpoint in the `accountId` property.

Return type

Account

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

GetAccountAnalytics

AccountAnalytics GetAccountAnalytics(ctx, accountId)

Get account analytics

Return the analytics of your Talon.One account.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
accountId int32 The identifier of the account. Retrieve it via the List users in account endpoint in the `accountId` property.

Return type

AccountAnalytics

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

GetAccountCollection

Collection GetAccountCollection(ctx, collectionId)

Get account-level collection

Retrieve a given account-level collection.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
collectionId int32 The ID of the collection. You can get it with the List collections in account endpoint.

Return type

Collection

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

GetAchievement

Achievement GetAchievement(ctx, applicationId, campaignId, achievementId)

Get achievement

Get the details of a specific achievement.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
applicationId int32 The ID of the Application. It is displayed in your Talon.One deployment URL.
campaignId int32 The ID of the campaign. It is displayed in your Talon.One deployment URL.
achievementId int32 The ID of the achievement. You can get this ID with the List achievement endpoint.

Return type

Achievement

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

GetAdditionalCost

AccountAdditionalCost GetAdditionalCost(ctx, additionalCostId)

Get additional cost

Returns the additional cost.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
additionalCostId int32 The ID of the additional cost. You can find the ID the the Campaign Manager's URL when you display the details of the cost in Account > Tools > Additional costs.

Return type

AccountAdditionalCost

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

GetAdditionalCosts

InlineResponse20035 GetAdditionalCosts(ctx, optional)

List additional costs

Returns all the defined additional costs for the account.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
optional *GetAdditionalCostsOpts optional parameters nil if no parameters

Optional Parameters

Optional parameters are passed through a pointer to a GetAdditionalCostsOpts struct

Name Type Description Notes
pageSize optional. The number of items in the response. [default to 1000]
skip optional. The number of items to skip when paging through large result sets.
sort optional. The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. Note: This parameter works only with numeric fields.

Return type

InlineResponse20035

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

GetApplication

Application GetApplication(ctx, applicationId)

Get Application

Get the application specified by the ID.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
applicationId int32 The ID of the Application. It is displayed in your Talon.One deployment URL.

Return type

Application

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

GetApplicationApiHealth

ApplicationApiHealth GetApplicationApiHealth(ctx, applicationId)

Get Application health

Display the health of the Application and show the last time the Application was used. You can also find this information in the Campaign Manager. In your Application, click Settings > Integration API Keys. See the docs.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
applicationId int32 The ID of the Application. It is displayed in your Talon.One deployment URL.

Return type

ApplicationApiHealth

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

GetApplicationCustomer

ApplicationCustomer GetApplicationCustomer(ctx, applicationId, customerId)

Get application's customer

Retrieve the customers of the specified application.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
applicationId int32 The ID of the Application. It is displayed in your Talon.One deployment URL.
customerId int32 The value of the `id` property of a customer profile. Get it with the List Application's customers endpoint.

Return type

ApplicationCustomer

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

GetApplicationCustomerFriends

InlineResponse20032 GetApplicationCustomerFriends(ctx, applicationId, integrationId, optional)

List friends referred by customer profile

List the friends referred by the specified customer profile in this Application.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
applicationId int32 The ID of the Application. It is displayed in your Talon.One deployment URL.
integrationId string The Integration ID of the Advocate's Profile.
optional *GetApplicationCustomerFriendsOpts optional parameters nil if no parameters

Optional Parameters

Optional parameters are passed through a pointer to a GetApplicationCustomerFriendsOpts struct

Name Type Description Notes

pageSize | optional.| The number of items in the response. | [default to 1000] skip | optional.| The number of items to skip when paging through large result sets. | sort | optional.| The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. Note: This parameter works only with numeric fields. | withTotalResultSize | optional.| When this flag is set, the result includes the total size of the result, across all pages. This might decrease performance on large data sets. - When `true`: `hasMore` is true when there is a next page. `totalResultSize` is always zero. - When `false`: `hasMore` is always false. `totalResultSize` contains the total number of results for this query. |

Return type

InlineResponse20032

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

GetApplicationCustomers

InlineResponse20021 GetApplicationCustomers(ctx, applicationId, optional)

List application's customers

List all the customers of the specified application.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
applicationId int32 The ID of the Application. It is displayed in your Talon.One deployment URL.
optional *GetApplicationCustomersOpts optional parameters nil if no parameters

Optional Parameters

Optional parameters are passed through a pointer to a GetApplicationCustomersOpts struct

Name Type Description Notes

integrationId | optional.| Filter results performing an exact matching against the profile integration identifier. | pageSize | optional.| The number of items in the response. | [default to 1000] skip | optional.| The number of items to skip when paging through large result sets. | withTotalResultSize | optional.| When this flag is set, the result includes the total size of the result, across all pages. This might decrease performance on large data sets. - When `true`: `hasMore` is true when there is a next page. `totalResultSize` is always zero. - When `false`: `hasMore` is always false. `totalResultSize` contains the total number of results for this query. |

Return type

InlineResponse20021

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

GetApplicationCustomersByAttributes

InlineResponse20022 GetApplicationCustomersByAttributes(ctx, applicationId, body, optional)

List application customers matching the given attributes

Get a list of the application customers matching the provided criteria. The match is successful if all the attributes of the request are found in a profile, even if the profile has more attributes that are not present on the request.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
applicationId int32 The ID of the Application. It is displayed in your Talon.One deployment URL.
body CustomerProfileSearchQuery body
optional *GetApplicationCustomersByAttributesOpts optional parameters nil if no parameters

Optional Parameters

Optional parameters are passed through a pointer to a GetApplicationCustomersByAttributesOpts struct

Name Type Description Notes

pageSize | optional.| The number of items in the response. | [default to 1000] skip | optional.| The number of items to skip when paging through large result sets. | withTotalResultSize | optional.| When this flag is set, the result includes the total size of the result, across all pages. This might decrease performance on large data sets. - When `true`: `hasMore` is true when there is a next page. `totalResultSize` is always zero. - When `false`: `hasMore` is always false. `totalResultSize` contains the total number of results for this query. |

Return type

InlineResponse20022

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

GetApplicationEventTypes

InlineResponse20028 GetApplicationEventTypes(ctx, applicationId, optional)

List Applications event types

Get all of the distinct values of the Event type property for events recorded in the application. See also: Track an event

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
applicationId int32 The ID of the Application. It is displayed in your Talon.One deployment URL.
optional *GetApplicationEventTypesOpts optional parameters nil if no parameters

Optional Parameters

Optional parameters are passed through a pointer to a GetApplicationEventTypesOpts struct

Name Type Description Notes

pageSize | optional.| The number of items in the response. | [default to 1000] skip | optional.| The number of items to skip when paging through large result sets. | sort | optional.| The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. Note: This parameter works only with numeric fields. |

Return type

InlineResponse20028

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

GetApplicationEventsWithoutTotalCount

InlineResponse20027 GetApplicationEventsWithoutTotalCount(ctx, applicationId, optional)

List Applications events

Lists all events recorded for an application. Instead of having the total number of results in the response, this endpoint only mentions whether there are more results.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
applicationId int32 The ID of the Application. It is displayed in your Talon.One deployment URL.
optional *GetApplicationEventsWithoutTotalCountOpts optional parameters nil if no parameters

Optional Parameters

Optional parameters are passed through a pointer to a GetApplicationEventsWithoutTotalCountOpts struct

Name Type Description Notes

pageSize | optional.| The number of items in the response. | [default to 1000] skip | optional.| The number of items to skip when paging through large result sets. | sort | optional.| The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. Note: This parameter works only with numeric fields. | type_ | optional.| Comma-separated list of types by which to filter events. Must be exact match(es). | createdBefore | optional.| Only return events created before this date. You can use any time zone setting. Talon.One will convert to UTC internally. | createdAfter | optional.| Only return events created after this date. You can use any time zone setting. Talon.One will convert to UTC internally. | session | optional.| Session integration ID filter for events. Must be exact match. | profile | optional.| Profile integration ID filter for events. Must be exact match. | customerName | optional.| Customer name filter for events. Will match substrings case-insensitively. | customerEmail | optional.| Customer e-mail address filter for events. Will match substrings case-insensitively. | couponCode | optional.| Coupon code | referralCode | optional.| Referral code | ruleQuery | optional.| Rule name filter for events | campaignQuery | optional.| Campaign name filter for events |

Return type

InlineResponse20027

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

GetApplicationSession

ApplicationSession GetApplicationSession(ctx, applicationId, sessionId)

Get Application session

Get the details of the given session. You can list the sessions with the List Application sessions endpoint.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
applicationId int32 The ID of the Application. It is displayed in your Talon.One deployment URL.
sessionId int32 The internal ID of the session. You can get the ID with the List Application sessions endpoint.

Return type

ApplicationSession

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

GetApplicationSessions

InlineResponse20026 GetApplicationSessions(ctx, applicationId, optional)

List Application sessions

List all the sessions of the specified Application.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
applicationId int32 The ID of the Application. It is displayed in your Talon.One deployment URL.
optional *GetApplicationSessionsOpts optional parameters nil if no parameters

Optional Parameters

Optional parameters are passed through a pointer to a GetApplicationSessionsOpts struct

Name Type Description Notes

pageSize | optional.| The number of items in the response. | [default to 1000] skip | optional.| The number of items to skip when paging through large result sets. | sort | optional.| The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. Note: This parameter works only with numeric fields. | profile | optional.| Profile integration ID filter for sessions. Must be exact match. | state | optional.| Filter by sessions with this state. Must be exact match. | createdBefore | optional.| Only return events created before this date. You can use any time zone setting. Talon.One will convert to UTC internally. | createdAfter | optional.| Only return events created after this date. You can use any time zone setting. Talon.One will convert to UTC internally. | coupon | optional.| Filter by sessions with this coupon. Must be exact match. | referral | optional.| Filter by sessions with this referral. Must be exact match. | integrationId | optional.| Filter by sessions with this integration ID. Must be exact match. | storeIntegrationId | optional.| The integration ID of the store. You choose this ID when you create a store. |

Return type

InlineResponse20026

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

GetApplications

InlineResponse2005 GetApplications(ctx, optional)

List Applications

List all applications in the current account.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
optional *GetApplicationsOpts optional parameters nil if no parameters

Optional Parameters

Optional parameters are passed through a pointer to a GetApplicationsOpts struct

Name Type Description Notes
pageSize optional. The number of items in the response. [default to 1000]
skip optional. The number of items to skip when paging through large result sets.
sort optional. The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. Note: This parameter works only with numeric fields.

Return type

InlineResponse2005

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

GetAttribute

Attribute GetAttribute(ctx, attributeId)

Get custom attribute

Retrieve the specified custom attribute.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
attributeId int32 The ID of the attribute. You can find the ID in the Campaign Manager's URL when you display the details of an attribute in Account > Tools > Attributes.

Return type

Attribute

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

GetAttributes

InlineResponse20033 GetAttributes(ctx, optional)

List custom attributes

Return all the custom attributes for the account.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
optional *GetAttributesOpts optional parameters nil if no parameters

Optional Parameters

Optional parameters are passed through a pointer to a GetAttributesOpts struct

Name Type Description Notes
pageSize optional. The number of items in the response. [default to 1000]
skip optional. The number of items to skip when paging through large result sets.
sort optional. The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. Note: This parameter works only with numeric fields.
entity optional. Returned attributes will be filtered by supplied entity.

Return type

InlineResponse20033

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

GetAudienceMemberships

InlineResponse20031 GetAudienceMemberships(ctx, audienceId, optional)

List audience members

Get a paginated list of the customer profiles in a given audience. A maximum of 1000 customer profiles per page is allowed.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
audienceId int32 The ID of the audience.
optional *GetAudienceMembershipsOpts optional parameters nil if no parameters

Optional Parameters

Optional parameters are passed through a pointer to a GetAudienceMembershipsOpts struct

Name Type Description Notes

pageSize | optional.| The number of items in the response. | [default to 1000] skip | optional.| The number of items to skip when paging through large result sets. | sort | optional.| The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. Note: This parameter works only with numeric fields. | profileQuery | optional.| The filter to select a profile. |

Return type

InlineResponse20031

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

GetAudiences

InlineResponse20029 GetAudiences(ctx, optional)

List audiences

Get all audiences created in the account. To create an audience, use Create audience.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
optional *GetAudiencesOpts optional parameters nil if no parameters

Optional Parameters

Optional parameters are passed through a pointer to a GetAudiencesOpts struct

Name Type Description Notes
pageSize optional. The number of items in the response. [default to 1000]
skip optional. The number of items to skip when paging through large result sets.
sort optional. The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. Note: This parameter works only with numeric fields.
withTotalResultSize optional. When this flag is set, the result includes the total size of the result, across all pages. This might decrease performance on large data sets. - When `true`: `hasMore` is true when there is a next page. `totalResultSize` is always zero. - When `false`: `hasMore` is always false. `totalResultSize` contains the total number of results for this query.

Return type

InlineResponse20029

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

GetAudiencesAnalytics

InlineResponse20030 GetAudiencesAnalytics(ctx, audienceIds, optional)

List audience analytics

Get a list of audience IDs and their member count.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
audienceIds string The IDs of one or more audiences, separated by commas, by which to filter results.
optional *GetAudiencesAnalyticsOpts optional parameters nil if no parameters

Optional Parameters

Optional parameters are passed through a pointer to a GetAudiencesAnalyticsOpts struct

Name Type Description Notes

sort | optional.| The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. Note: This parameter works only with numeric fields. |

Return type

InlineResponse20030

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

GetCampaign

Campaign GetCampaign(ctx, applicationId, campaignId)

Get campaign

Retrieve the given campaign.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
applicationId int32 The ID of the Application. It is displayed in your Talon.One deployment URL.
campaignId int32 The ID of the campaign. It is displayed in your Talon.One deployment URL.

Return type

Campaign

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

GetCampaignAnalytics

InlineResponse20020 GetCampaignAnalytics(ctx, applicationId, campaignId, rangeStart, rangeEnd, optional)

Get analytics of campaigns

Retrieve statistical data about the performance of the given campaign.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
applicationId int32 The ID of the Application. It is displayed in your Talon.One deployment URL.
campaignId int32 The ID of the campaign. It is displayed in your Talon.One deployment URL.
rangeStart time.Time Only return results from after this timestamp. Note: - This must be an RFC3339 timestamp string. - You can include a time component in your string, for example, `T23:59:59` to specify the end of the day. The time zone setting considered is `UTC`. If you do not include a time component, a default time value of `T00:00:00` (midnight) in `UTC` is considered.
rangeEnd time.Time Only return results from before this timestamp. Note: - This must be an RFC3339 timestamp string. - You can include a time component in your string, for example, `T23:59:59` to specify the end of the day. The time zone setting considered is `UTC`. If you do not include a time component, a default time value of `T00:00:00` (midnight) in `UTC` is considered.
optional *GetCampaignAnalyticsOpts optional parameters nil if no parameters

Optional Parameters

Optional parameters are passed through a pointer to a GetCampaignAnalyticsOpts struct

Name Type Description Notes

granularity | optional.| The time interval between the results in the returned time-series. |

Return type

InlineResponse20020

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

GetCampaignByAttributes

InlineResponse2006 GetCampaignByAttributes(ctx, applicationId, body, optional)

List campaigns that match the given attributes

Get a list of all the campaigns that match a set of attributes.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
applicationId int32 The ID of the Application. It is displayed in your Talon.One deployment URL.
body CampaignSearch body
optional *GetCampaignByAttributesOpts optional parameters nil if no parameters

Optional Parameters

Optional parameters are passed through a pointer to a GetCampaignByAttributesOpts struct

Name Type Description Notes

pageSize | optional.| The number of items in the response. | [default to 1000] skip | optional.| The number of items to skip when paging through large result sets. | sort | optional.| The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. Note: This parameter works only with numeric fields. | campaignState | optional.| Filter results by the state of the campaign. - `enabled`: Campaigns that are scheduled, running (activated), or expired. - `running`: Campaigns that are running (activated). - `disabled`: Campaigns that are disabled. - `expired`: Campaigns that are expired. - `archived`: Campaigns that are archived. |

Return type

InlineResponse2006

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

GetCampaignGroup

CampaignGroup GetCampaignGroup(ctx, campaignGroupId)

Get campaign access group

Get a campaign access group specified by its ID.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
campaignGroupId int32 The ID of the campaign access group.

Return type

CampaignGroup

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

GetCampaignGroups

InlineResponse20011 GetCampaignGroups(ctx, optional)

List campaign access groups

List the campaign access groups in the current account.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
optional *GetCampaignGroupsOpts optional parameters nil if no parameters

Optional Parameters

Optional parameters are passed through a pointer to a GetCampaignGroupsOpts struct

Name Type Description Notes
pageSize optional. The number of items in the response. [default to 1000]
skip optional. The number of items to skip when paging through large result sets.
sort optional. The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. Note: This parameter works only with numeric fields.

Return type

InlineResponse20011

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

GetCampaignTemplates

InlineResponse20012 GetCampaignTemplates(ctx, optional)

List campaign templates

Retrieve a list of campaign templates.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
optional *GetCampaignTemplatesOpts optional parameters nil if no parameters

Optional Parameters

Optional parameters are passed through a pointer to a GetCampaignTemplatesOpts struct

Name Type Description Notes
pageSize optional. The number of items in the response. [default to 1000]
skip optional. The number of items to skip when paging through large result sets.
sort optional. The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. Note: This parameter works only with numeric fields.
state optional. Filter results by the state of the campaign template.
name optional. Filter results performing case-insensitive matching against the name of the campaign template.
tags optional. Filter results performing case-insensitive matching against the tags of the campaign template. When used in conjunction with the &quot;name&quot; query parameter, a logical OR will be performed to search both tags and name for the provided values.
userId optional. Filter results by user ID.

Return type

InlineResponse20012

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

GetCampaigns

InlineResponse2006 GetCampaigns(ctx, applicationId, optional)

List campaigns

List the campaigns of the specified application that match your filter criteria.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
applicationId int32 The ID of the Application. It is displayed in your Talon.One deployment URL.
optional *GetCampaignsOpts optional parameters nil if no parameters

Optional Parameters

Optional parameters are passed through a pointer to a GetCampaignsOpts struct

Name Type Description Notes

pageSize | optional.| The number of items in the response. | [default to 1000] skip | optional.| The number of items to skip when paging through large result sets. | sort | optional.| The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. Note: This parameter works only with numeric fields. | campaignState | optional.| Filter results by the state of the campaign. - `enabled`: Campaigns that are scheduled, running (activated), or expired. - `running`: Campaigns that are running (activated). - `disabled`: Campaigns that are disabled. - `expired`: Campaigns that are expired. - `archived`: Campaigns that are archived. | name | optional.| Filter results performing case-insensitive matching against the name of the campaign. | tags | optional.| Filter results performing case-insensitive matching against the tags of the campaign. When used in conjunction with the &quot;name&quot; query parameter, a logical OR will be performed to search both tags and name for the provided values | createdBefore | optional.| Filter results comparing the parameter value, expected to be an RFC3339 timestamp string, to the campaign creation timestamp. You can use any time zone setting. Talon.One will convert to UTC internally. | createdAfter | optional.| Filter results comparing the parameter value, expected to be an RFC3339 timestamp string, to the campaign creation timestamp. You can use any time zone setting. Talon.One will convert to UTC internally. | campaignGroupId | optional.| Filter results to campaigns owned by the specified campaign access group ID. | templateId | optional.| The ID of the campaign template this campaign was created from. | storeId | optional.| Filter results to campaigns linked to the specified store ID. |

Return type

InlineResponse2006

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

GetChanges

InlineResponse20041 GetChanges(ctx, optional)

Get audit logs for an account

Retrieve the audit logs displayed in Accounts > Audit logs.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
optional *GetChangesOpts optional parameters nil if no parameters

Optional Parameters

Optional parameters are passed through a pointer to a GetChangesOpts struct

Name Type Description Notes
pageSize optional. The number of items in the response. [default to 1000]
skip optional. The number of items to skip when paging through large result sets.
sort optional. The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. Note: This parameter works only with numeric fields.
applicationId optional. Filter results by Application ID.
entityPath optional. Filter results on a case insensitive matching of the url path of the entity
userId optional. Filter results by user ID.
createdBefore optional. Filter results comparing the parameter value, expected to be an RFC3339 timestamp string, to the change creation timestamp. You can use any time zone setting. Talon.One will convert to UTC internally.
createdAfter optional. Filter results comparing the parameter value, expected to be an RFC3339 timestamp string, to the change creation timestamp. You can use any time zone setting. Talon.One will convert to UTC internally.
withTotalResultSize optional. When this flag is set, the result includes the total size of the result, across all pages. This might decrease performance on large data sets. - When `true`: `hasMore` is true when there is a next page. `totalResultSize` is always zero. - When `false`: `hasMore` is always false. `totalResultSize` contains the total number of results for this query.
managementKeyId optional. Filter results that match the given management key ID.
includeOld optional. When this flag is set to false, the state without the change will not be returned. The default value is true.

Return type

InlineResponse20041

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

GetCollection

Collection GetCollection(ctx, applicationId, campaignId, collectionId)

Get campaign-level collection

Retrieve a given campaign-level collection.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
applicationId int32 The ID of the Application. It is displayed in your Talon.One deployment URL.
campaignId int32 The ID of the campaign. It is displayed in your Talon.One deployment URL.
collectionId int32 The ID of the collection. You can get it with the List collections in Application endpoint.

Return type

Collection

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

GetCollectionItems

InlineResponse20018 GetCollectionItems(ctx, collectionId, optional)

Get collection items

Retrieve items from a given collection. You can retrieve items from both account-level collections and campaign-level collections using this endpoint.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
collectionId int32 The ID of the collection. You can get it with the List collections in account endpoint.
optional *GetCollectionItemsOpts optional parameters nil if no parameters

Optional Parameters

Optional parameters are passed through a pointer to a GetCollectionItemsOpts struct

Name Type Description Notes

pageSize | optional.| The number of items in the response. | [default to 1000] skip | optional.| The number of items to skip when paging through large result sets. |

Return type

InlineResponse20018

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

GetCouponsWithoutTotalCount

InlineResponse2009 GetCouponsWithoutTotalCount(ctx, applicationId, campaignId, optional)

List coupons

List all the coupons matching the specified criteria.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
applicationId int32 The ID of the Application. It is displayed in your Talon.One deployment URL.
campaignId int32 The ID of the campaign. It is displayed in your Talon.One deployment URL.
optional *GetCouponsWithoutTotalCountOpts optional parameters nil if no parameters

Optional Parameters

Optional parameters are passed through a pointer to a GetCouponsWithoutTotalCountOpts struct

Name Type Description Notes

pageSize | optional.| The number of items in the response. | [default to 1000] skip | optional.| The number of items to skip when paging through large result sets. | sort | optional.| The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. Note: This parameter works only with numeric fields. | value | optional.| Filter results performing case-insensitive matching against the coupon code. Both the code and the query are folded to remove all non-alpha-numeric characters. | createdBefore | optional.| Filter results comparing the parameter value, expected to be an RFC3339 timestamp string, to the coupon creation timestamp. You can use any time zone setting. Talon.One will convert to UTC internally. | createdAfter | optional.| Filter results comparing the parameter value, expected to be an RFC3339 timestamp string, to the coupon creation timestamp. You can use any time zone setting. Talon.One will convert to UTC internally. | valid | optional.| Either &quot;expired&quot;, &quot;validNow&quot;, or &quot;validFuture&quot;. The first option matches coupons in which the expiration date is set and in the past. The second matches coupons in which start date is null or in the past and expiration date is null or in the future, the third matches coupons in which start date is set and in the future. | usable | optional.| Either &quot;true&quot; or &quot;false&quot;. If &quot;true&quot;, only coupons where `usageCounter < usageLimit` will be returned, &quot;false&quot; will return only coupons where `usageCounter >= usageLimit`. | redeemed | optional.| - `true`: only coupons where `usageCounter > 0` will be returned. - `false`: only coupons where `usageCounter = 0` will be returned. - This field cannot be used in conjunction with the `usable` query parameter. | referralId | optional.| Filter the results by matching them with the ID of a referral. This filter shows the coupons created by redeeming a referral code. | recipientIntegrationId | optional.| Filter results by match with a profile ID specified in the coupon's RecipientIntegrationId field. | batchId | optional.| Filter results by batches of coupons | exactMatch | optional.| Filter results to an exact case-insensitive matching against the coupon code. | [default to false] expiresBefore | optional.| Filter results comparing the parameter value, expected to be an RFC3339 timestamp string, to the coupon expiration date timestamp. You can use any time zone setting. Talon.One will convert to UTC internally. | expiresAfter | optional.| Filter results comparing the parameter value, expected to be an RFC3339 timestamp string, to the coupon expiration date timestamp. You can use any time zone setting. Talon.One will convert to UTC internally. | startsBefore | optional.| Filter results comparing the parameter value, expected to be an RFC3339 timestamp string, to the coupon start date timestamp. You can use any time zone setting. Talon.One will convert to UTC internally. | startsAfter | optional.| Filter results comparing the parameter value, expected to be an RFC3339 timestamp string, to the coupon start date timestamp. You can use any time zone setting. Talon.One will convert to UTC internally. | valuesOnly | optional.| Filter results to only return the coupon codes (`value` column) without the associated coupon data. | [default to false]

Return type

InlineResponse2009

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

GetCustomerActivityReport

CustomerActivityReport GetCustomerActivityReport(ctx, rangeStart, rangeEnd, applicationId, customerId, optional)

Get customer's activity report

Fetch the summary report of a given customer in the given application, in a time range.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
rangeStart time.Time Only return results from after this timestamp. Note: - This must be an RFC3339 timestamp string. - You can include a time component in your string, for example, `T23:59:59` to specify the end of the day. The time zone setting considered is `UTC`. If you do not include a time component, a default time value of `T00:00:00` (midnight) in `UTC` is considered.
rangeEnd time.Time Only return results from before this timestamp. Note: - This must be an RFC3339 timestamp string. - You can include a time component in your string, for example, `T23:59:59` to specify the end of the day. The time zone setting considered is `UTC`. If you do not include a time component, a default time value of `T00:00:00` (midnight) in `UTC` is considered.
applicationId int32 The ID of the Application. It is displayed in your Talon.One deployment URL.
customerId int32 The value of the `id` property of a customer profile. Get it with the List Application's customers endpoint.
optional *GetCustomerActivityReportOpts optional parameters nil if no parameters

Optional Parameters

Optional parameters are passed through a pointer to a GetCustomerActivityReportOpts struct

Name Type Description Notes

pageSize | optional.| The number of items in the response. | [default to 1000] skip | optional.| The number of items to skip when paging through large result sets. |

Return type

CustomerActivityReport

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

GetCustomerActivityReportsWithoutTotalCount

InlineResponse20025 GetCustomerActivityReportsWithoutTotalCount(ctx, rangeStart, rangeEnd, applicationId, optional)

Get Activity Reports for Application Customers

Fetch summary reports for all application customers based on a time range. Instead of having the total number of results in the response, this endpoint only mentions whether there are more results.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
rangeStart time.Time Only return results from after this timestamp. Note: - This must be an RFC3339 timestamp string. - You can include a time component in your string, for example, `T23:59:59` to specify the end of the day. The time zone setting considered is `UTC`. If you do not include a time component, a default time value of `T00:00:00` (midnight) in `UTC` is considered.
rangeEnd time.Time Only return results from before this timestamp. Note: - This must be an RFC3339 timestamp string. - You can include a time component in your string, for example, `T23:59:59` to specify the end of the day. The time zone setting considered is `UTC`. If you do not include a time component, a default time value of `T00:00:00` (midnight) in `UTC` is considered.
applicationId int32 The ID of the Application. It is displayed in your Talon.One deployment URL.
optional *GetCustomerActivityReportsWithoutTotalCountOpts optional parameters nil if no parameters

Optional Parameters

Optional parameters are passed through a pointer to a GetCustomerActivityReportsWithoutTotalCountOpts struct

Name Type Description Notes

pageSize | optional.| The number of items in the response. | [default to 1000] skip | optional.| The number of items to skip when paging through large result sets. | sort | optional.| The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. Note: This parameter works only with numeric fields. | name | optional.| Only return reports matching the customer name. | integrationId | optional.| Filter results performing an exact matching against the profile integration identifier. | campaignName | optional.| Only return reports matching the campaign name. | advocateName | optional.| Only return reports matching the current customer referrer name. |

Return type

InlineResponse20025

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

GetCustomerAnalytics

CustomerAnalytics GetCustomerAnalytics(ctx, applicationId, customerId, optional)

Get customer's analytics report

Fetch analytics for a given customer in the given application.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
applicationId int32 The ID of the Application. It is displayed in your Talon.One deployment URL.
customerId int32 The value of the `id` property of a customer profile. Get it with the List Application's customers endpoint.
optional *GetCustomerAnalyticsOpts optional parameters nil if no parameters

Optional Parameters

Optional parameters are passed through a pointer to a GetCustomerAnalyticsOpts struct

Name Type Description Notes

pageSize | optional.| The number of items in the response. | [default to 1000] skip | optional.| The number of items to skip when paging through large result sets. | sort | optional.| The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. Note: This parameter works only with numeric fields. |

Return type

CustomerAnalytics

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

GetCustomerProfile

CustomerProfile GetCustomerProfile(ctx, customerId)

Get customer profile

Return the details of the specified customer profile. <div class="redoc-section"> <p class="title">Performance tips

You can retrieve the same information via the Integration API, which can save you extra API requests. consider these options: - Request the customer profile to be part of the response content using Update Customer Session. - Send an empty update with the Update Customer Profile endpoint with runRuleEngine=false.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
customerId int32 The value of the `id` property of a customer profile. Get it with the List Application's customers endpoint.

Return type

CustomerProfile

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

GetCustomerProfileAchievementProgress

InlineResponse20046 GetCustomerProfileAchievementProgress(ctx, applicationId, integrationId, optional)

List customer achievements

For the given customer profile, list all the achievements that match your filter criteria.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
applicationId int32 The ID of the Application. It is displayed in your Talon.One deployment URL.
integrationId string The identifier of the profile.
optional *GetCustomerProfileAchievementProgressOpts optional parameters nil if no parameters

Optional Parameters

Optional parameters are passed through a pointer to a GetCustomerProfileAchievementProgressOpts struct

Name Type Description Notes

pageSize | optional.| The number of items in the response. | [default to 50] skip | optional.| The number of items to skip when paging through large result sets. | achievementId | optional.| The ID of the achievement. You can get this ID with the List achievement endpoint. | title | optional.| Filter results by the `title` of an achievement. |

Return type

InlineResponse20046

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

GetCustomerProfiles

InlineResponse20024 GetCustomerProfiles(ctx, optional)

List customer profiles

List all customer profiles.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
optional *GetCustomerProfilesOpts optional parameters nil if no parameters

Optional Parameters

Optional parameters are passed through a pointer to a GetCustomerProfilesOpts struct

Name Type Description Notes
pageSize optional. The number of items in the response. [default to 1000]
skip optional. The number of items to skip when paging through large result sets.
sandbox optional. Indicates whether you are pointing to a sandbox or live customer. [default to false]

Return type

InlineResponse20024

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

GetCustomersByAttributes

InlineResponse20023 GetCustomersByAttributes(ctx, body, optional)

List customer profiles matching the given attributes

Get a list of the customer profiles matching the provided criteria. The match is successful if all the attributes of the request are found in a profile, even if the profile has more attributes that are not present on the request.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
body CustomerProfileSearchQuery body
optional *GetCustomersByAttributesOpts optional parameters nil if no parameters

Optional Parameters

Optional parameters are passed through a pointer to a GetCustomersByAttributesOpts struct

Name Type Description Notes

pageSize | optional.| The number of items in the response. | [default to 1000] skip | optional.| The number of items to skip when paging through large result sets. | sandbox | optional.| Indicates whether you are pointing to a sandbox or live customer. | [default to false]

Return type

InlineResponse20023

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

GetEventTypes

InlineResponse20039 GetEventTypes(ctx, optional)

List event types

Fetch all event type definitions for your account.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
optional *GetEventTypesOpts optional parameters nil if no parameters

Optional Parameters

Optional parameters are passed through a pointer to a GetEventTypesOpts struct

Name Type Description Notes
name optional. Filter results to event types with the given name. This parameter implies `includeOldVersions`.
includeOldVersions optional. Include all versions of every event type. [default to false]
pageSize optional. The number of items in the response. [default to 1000]
skip optional. The number of items to skip when paging through large result sets.
sort optional. The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. Note: This parameter works only with numeric fields.

Return type

InlineResponse20039

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

GetExports

InlineResponse20042 GetExports(ctx, optional)

Get exports

List all past exports

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
optional *GetExportsOpts optional parameters nil if no parameters

Optional Parameters

Optional parameters are passed through a pointer to a GetExportsOpts struct

Name Type Description Notes
pageSize optional. The number of items in the response. [default to 1000]
skip optional. The number of items to skip when paging through large result sets.
applicationId optional. Filter results by Application ID.
campaignId optional. Filter by the campaign ID on which the limit counters are used.
entity optional. The name of the entity type that was exported.

Return type

InlineResponse20042

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

GetLoyaltyCard

LoyaltyCard GetLoyaltyCard(ctx, loyaltyProgramId, loyaltyCardId)

Get loyalty card

Get the given loyalty card.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
loyaltyProgramId int32 Identifier of the card-based loyalty program containing the loyalty card. You can get the ID with the List loyalty programs endpoint.
loyaltyCardId string Identifier of the loyalty card. You can get the identifier with the List loyalty cards endpoint.

Return type

LoyaltyCard

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

GetLoyaltyCardTransactionLogs

InlineResponse20016 GetLoyaltyCardTransactionLogs(ctx, loyaltyProgramId, loyaltyCardId, optional)

List card's transactions

Retrieve the transaction logs for the given loyalty card within the specified card-based loyalty program with filtering options applied. If no filtering options are applied, the last 50 loyalty transactions for the given loyalty card are returned.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
loyaltyProgramId int32 Identifier of the card-based loyalty program containing the loyalty card. You can get the ID with the List loyalty programs endpoint.
loyaltyCardId string Identifier of the loyalty card. You can get the identifier with the List loyalty cards endpoint.
optional *GetLoyaltyCardTransactionLogsOpts optional parameters nil if no parameters

Optional Parameters

Optional parameters are passed through a pointer to a GetLoyaltyCardTransactionLogsOpts struct

Name Type Description Notes

startDate | optional.| Date and time from which results are returned. Results are filtered by transaction creation date. Note: - It must be an RFC3339 timestamp string. - You can include a time component in your string, for example, `T23:59:59` to specify the end of the day. The time zone setting considered is `UTC`. If you do not include a time component, a default time value of `T00:00:00` (midnight) in `UTC` is considered. | endDate | optional.| Date and time by which results are returned. Results are filtered by transaction creation date. Note: - It must be an RFC3339 timestamp string. - You can include a time component in your string, for example, `T23:59:59` to specify the end of the day. The time zone setting considered is `UTC`. If you do not include a time component, a default time value of `T00:00:00` (midnight) in `UTC` is considered. | pageSize | optional.| The number of items in the response. | [default to 1000] skip | optional.| The number of items to skip when paging through large result sets. | subledgerId | optional.| The ID of the subledger by which we filter the data. |

Return type

InlineResponse20016

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

GetLoyaltyCards

InlineResponse20015 GetLoyaltyCards(ctx, loyaltyProgramId, optional)

List loyalty cards

For the given card-based loyalty program, list the loyalty cards that match your filter criteria.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
loyaltyProgramId int32 Identifier of the card-based loyalty program containing the loyalty card. You can get the ID with the List loyalty programs endpoint.
optional *GetLoyaltyCardsOpts optional parameters nil if no parameters

Optional Parameters

Optional parameters are passed through a pointer to a GetLoyaltyCardsOpts struct

Name Type Description Notes

pageSize | optional.| The number of items in the response. | [default to 1000] skip | optional.| The number of items to skip when paging through large result sets. | sort | optional.| The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. Note: This parameter works only with numeric fields. | identifier | optional.| The card code by which to filter loyalty cards in the response. | profileId | optional.| Filter results by customer profile ID. | batchId | optional.| Filter results by loyalty card batch ID. |

Return type

InlineResponse20015

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

GetLoyaltyPoints

LoyaltyLedger GetLoyaltyPoints(ctx, loyaltyProgramId, integrationId)

Get customer's full loyalty ledger

Get the loyalty ledger for this profile integration ID. To get the integrationId of the profile from a sessionId, use the Update customer session endpoint. Important: To get loyalty transaction logs for a given Integration ID in a loyalty program, we recommend using the Integration API's Get customer's loyalty logs.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
loyaltyProgramId string The identifier for the loyalty program.
integrationId string The identifier of the profile.

Return type

LoyaltyLedger

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

GetLoyaltyProgram

LoyaltyProgram GetLoyaltyProgram(ctx, loyaltyProgramId)

Get loyalty program

Get the specified loyalty program. To list all loyalty programs in your Application, use List loyalty programs. To list the loyalty programs that a customer profile is part of, use the List customer data

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
loyaltyProgramId int32 Identifier of the loyalty program. You can get the ID with the List loyalty programs endpoint.

Return type

LoyaltyProgram

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

GetLoyaltyProgramTransactions

InlineResponse20014 GetLoyaltyProgramTransactions(ctx, loyaltyProgramId, optional)

List loyalty program transactions

Retrieve loyalty program transaction logs in a given loyalty program with filtering options applied. Manual and imported transactions are also included. Note: If no filters are applied, the last 50 loyalty transactions for the given loyalty program are returned. Important: To get loyalty transaction logs for a given Integration ID in a loyalty program, we recommend using the Integration API's Get customer's loyalty logs.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
loyaltyProgramId int32 Identifier of the loyalty program. You can get the ID with the List loyalty programs endpoint.
optional *GetLoyaltyProgramTransactionsOpts optional parameters nil if no parameters

Optional Parameters

Optional parameters are passed through a pointer to a GetLoyaltyProgramTransactionsOpts struct

Name Type Description Notes

loyaltyTransactionType | optional.| Filter results by loyalty transaction type: - `manual`: Loyalty transaction that was done manually. - `session`: Loyalty transaction that resulted from a customer session. - `import`: Loyalty transaction that was imported from a CSV file. | subledgerId | optional.| The ID of the subledger by which we filter the data. | startDate | optional.| Date and time from which results are returned. Results are filtered by transaction creation date. Note: - It must be an RFC3339 timestamp string. - You can include a time component in your string, for example, `T23:59:59` to specify the end of the day. The time zone setting considered is `UTC`. If you do not include a time component, a default time value of `T00:00:00` (midnight) in `UTC` is considered. | endDate | optional.| Date and time by which results are returned. Results are filtered by transaction creation date. Note: - It must be an RFC3339 timestamp string. - You can include a time component in your string, for example, `T23:59:59` to specify the end of the day. The time zone setting considered is `UTC`. If you do not include a time component, a default time value of `T00:00:00` (midnight) in `UTC` is considered. | pageSize | optional.| The number of items in the response. | [default to 50] skip | optional.| The number of items to skip when paging through large result sets. |

Return type

InlineResponse20014

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

GetLoyaltyPrograms

InlineResponse20013 GetLoyaltyPrograms(ctx, )

List loyalty programs

List the loyalty programs of the account.

Required Parameters

This endpoint does not need any parameter.

Return type

InlineResponse20013

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

GetLoyaltyStatistics

LoyaltyDashboardData GetLoyaltyStatistics(ctx, loyaltyProgramId)

Get loyalty program statistics

Retrieve the statistics of the specified loyalty program such as the total active points, pending points, spent points, and expired points. Important: The returned data does not include the current day. All statistics are updated daily at 11:59 PM in the loyalty program time zone.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
loyaltyProgramId int32 Identifier of the loyalty program. You can get the ID with the List loyalty programs endpoint.

Return type

LoyaltyDashboardData

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

GetReferralsWithoutTotalCount

InlineResponse20010 GetReferralsWithoutTotalCount(ctx, applicationId, campaignId, optional)

List referrals

List all referrals of the specified campaign.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
applicationId int32 The ID of the Application. It is displayed in your Talon.One deployment URL.
campaignId int32 The ID of the campaign. It is displayed in your Talon.One deployment URL.
optional *GetReferralsWithoutTotalCountOpts optional parameters nil if no parameters

Optional Parameters

Optional parameters are passed through a pointer to a GetReferralsWithoutTotalCountOpts struct

Name Type Description Notes

pageSize | optional.| The number of items in the response. | [default to 1000] skip | optional.| The number of items to skip when paging through large result sets. | sort | optional.| The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. Note: This parameter works only with numeric fields. | code | optional.| Filter results performing case-insensitive matching against the referral code. Both the code and the query are folded to remove all non-alpha-numeric characters. | createdBefore | optional.| Filter results comparing the parameter value, expected to be an RFC3339 timestamp string, to the referral creation timestamp. You can use any time zone setting. Talon.One will convert to UTC internally. | createdAfter | optional.| Filter results comparing the parameter value, expected to be an RFC3339 timestamp string, to the referral creation timestamp. You can use any time zone setting. Talon.One will convert to UTC internally. | valid | optional.| Either &quot;expired&quot;, &quot;validNow&quot;, or &quot;validFuture&quot;. The first option matches referrals in which the expiration date is set and in the past. The second matches referrals in which start date is null or in the past and expiration date is null or in the future, the third matches referrals in which start date is set and in the future. | usable | optional.| Either &quot;true&quot; or &quot;false&quot;. If &quot;true&quot;, only referrals where `usageCounter < usageLimit` will be returned, &quot;false&quot; will return only referrals where `usageCounter >= usageLimit`. | advocate | optional.| Filter results by match with a profile ID specified in the referral's AdvocateProfileIntegrationId field. |

Return type

InlineResponse20010

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

GetRoleV2

RoleV2 GetRoleV2(ctx, roleId)

Get role

Get the details of a specific role. To see all the roles, use the List roles endpoint.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
roleId int32 The ID of role. Note: To find the ID of a role, use the List roles endpoint.

Return type

RoleV2

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

GetRuleset

Ruleset GetRuleset(ctx, applicationId, campaignId, rulesetId)

Get ruleset

Retrieve the specified ruleset.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
applicationId int32 The ID of the Application. It is displayed in your Talon.One deployment URL.
campaignId int32 The ID of the campaign. It is displayed in your Talon.One deployment URL.
rulesetId int32 The ID of the ruleset.

Return type

Ruleset

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

GetRulesets

InlineResponse2007 GetRulesets(ctx, applicationId, campaignId, optional)

List campaign rulesets

List all rulesets of this campaign. A ruleset is a revision of the rules of a campaign. Important: The response also includes deleted rules. You should only consider the latest revision of the returned rulesets.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
applicationId int32 The ID of the Application. It is displayed in your Talon.One deployment URL.
campaignId int32 The ID of the campaign. It is displayed in your Talon.One deployment URL.
optional *GetRulesetsOpts optional parameters nil if no parameters

Optional Parameters

Optional parameters are passed through a pointer to a GetRulesetsOpts struct

Name Type Description Notes

pageSize | optional.| The number of items in the response. | [default to 1000] skip | optional.| The number of items to skip when paging through large result sets. | sort | optional.| The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. Note: This parameter works only with numeric fields. |

Return type

InlineResponse2007

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

GetStore

Store GetStore(ctx, applicationId, storeId)

Get store

Get store details for a specific store ID.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
applicationId int32 The ID of the Application. It is displayed in your Talon.One deployment URL.
storeId string The ID of the store. You can get this ID with the List stores endpoint.

Return type

Store

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

GetUser

User GetUser(ctx, userId)

Get user

Retrieve the data (including an invitation code) for a user. Non-admin users can only get their own profile.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
userId int32 The ID of the user.

Return type

User

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

GetUsers

InlineResponse20040 GetUsers(ctx, optional)

List users in account

Retrieve all users in your account.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
optional *GetUsersOpts optional parameters nil if no parameters

Optional Parameters

Optional parameters are passed through a pointer to a GetUsersOpts struct

Name Type Description Notes
pageSize optional. The number of items in the response. [default to 1000]
skip optional. The number of items to skip when paging through large result sets.
sort optional. The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. Note: This parameter works only with numeric fields.

Return type

InlineResponse20040

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

GetWebhook

Webhook GetWebhook(ctx, webhookId)

Get webhook

Returns a webhook by its id.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
webhookId int32 The ID of the webhook. You can find the ID in the Campaign Manager's URL when you display the details of the webhook in Account > Webhooks.

Return type

Webhook

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

GetWebhookActivationLogs

InlineResponse20037 GetWebhookActivationLogs(ctx, optional)

List webhook activation log entries

Webhook activation log entries are created as soon as an integration request triggers a webhook effect. See the docs.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
optional *GetWebhookActivationLogsOpts optional parameters nil if no parameters

Optional Parameters

Optional parameters are passed through a pointer to a GetWebhookActivationLogsOpts struct

Name Type Description Notes
pageSize optional. The number of items in the response. [default to 1000]
skip optional. The number of items to skip when paging through large result sets.
sort optional. The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. Note: This parameter works only with numeric fields.
integrationRequestUuid optional. Filter results by integration request UUID.
webhookId optional. Filter results by webhook id.
applicationId optional. Filter results by Application ID.
campaignId optional. Filter results by campaign ID.
createdBefore optional. Only return events created before this date. You can use any time zone setting. Talon.One will convert to UTC internally.
createdAfter optional. Only return events created after this date. You can use any time zone setting. Talon.One will convert to UTC internally.

Return type

InlineResponse20037

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

GetWebhookLogs

InlineResponse20038 GetWebhookLogs(ctx, optional)

List webhook log entries

Retrieve all webhook log entries.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
optional *GetWebhookLogsOpts optional parameters nil if no parameters

Optional Parameters

Optional parameters are passed through a pointer to a GetWebhookLogsOpts struct

Name Type Description Notes
pageSize optional. The number of items in the response. [default to 1000]
skip optional. The number of items to skip when paging through large result sets.
sort optional. The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. Note: This parameter works only with numeric fields.
status optional. Filter results by HTTP status codes.
webhookId optional. Filter results by webhook id.
applicationId optional. Filter results by Application ID.
campaignId optional. Filter results by campaign ID.
requestUuid optional. Filter results by request UUID.
createdBefore optional. Filter results where request and response times to return entries before parameter value, expected to be an RFC3339 timestamp string. You can use any time zone setting. Talon.One will convert to UTC internally.
createdAfter optional. Filter results where request and response times to return entries after parameter value, expected to be an RFC3339 timestamp string. You can use any time zone setting. Talon.One will convert to UTC internally.

Return type

InlineResponse20038

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

GetWebhooks

InlineResponse20036 GetWebhooks(ctx, optional)

List webhooks

List all webhooks.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
optional *GetWebhooksOpts optional parameters nil if no parameters

Optional Parameters

Optional parameters are passed through a pointer to a GetWebhooksOpts struct

Name Type Description Notes
applicationIds optional. Checks if the given catalog or its attributes are referenced in the specified Application ID. Note: If no Application ID is provided, we check for all connected Applications.
sort optional. The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. Note: This parameter works only with numeric fields.
pageSize optional. The number of items in the response. [default to 1000]
skip optional. The number of items to skip when paging through large result sets.
creationType optional. Filter results by creation type.
visibility optional. Filter results by visibility.
outgoingIntegrationsTypeId optional. Filter results by outgoing integration type ID.
title optional. Filter results performing case-insensitive matching against the webhook title.

Return type

InlineResponse20036

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

ImportAccountCollection

Import ImportAccountCollection(ctx, collectionId, optional)

Import data into existing account-level collection

Upload a CSV file containing the collection of string values that should be attached as payload for collection. The file should be sent as multipart data. The import replaces the initial content of the collection. The CSV file must only contain the following column: - item: the values in your collection. A collection is limited to 500,000 items. Example: item Addidas Nike Asics Note: Before sending a request to this endpoint, ensure the data in the CSV to import is different from the data currently stored in the collection.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
collectionId int32 The ID of the collection. You can get it with the List collections in account endpoint.
optional *ImportAccountCollectionOpts optional parameters nil if no parameters

Optional Parameters

Optional parameters are passed through a pointer to a ImportAccountCollectionOpts struct

Name Type Description Notes

upFile | optional.| The file containing the data that is being imported. |

Return type

Import

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: multipart/form-data
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

ImportAllowedList

Import ImportAllowedList(ctx, attributeId, optional)

Import allowed values for attribute

Upload a CSV file containing a list of picklist values for the specified attribute. The file should be sent as multipart data. The import replaces the previous list of allowed values for this attribute, if any. The CSV file must only contain the following column: - item (required): the values in your allowed list, for example a list of SKU's. An allowed list is limited to 500,000 items. Example: text item CS-VG-04032021-UP-50D-10 CS-DV-04042021-UP-49D-12 CS-DG-02082021-UP-50G-07

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
attributeId int32 The ID of the attribute. You can find the ID in the Campaign Manager's URL when you display the details of an attribute in Account > Tools > Attributes.
optional *ImportAllowedListOpts optional parameters nil if no parameters

Optional Parameters

Optional parameters are passed through a pointer to a ImportAllowedListOpts struct

Name Type Description Notes

upFile | optional.| The file containing the data that is being imported. |

Return type

Import

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: multipart/form-data
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

ImportAudiencesMemberships

Import ImportAudiencesMemberships(ctx, audienceId, optional)

Import audience members

Upload a CSV file containing the integration IDs of the members you want to add to an audience. The file should be sent as multipart data and should contain only the following column (required): - profileintegrationid: The integration ID of the customer profile. The import replaces the previous list of audience members. Note: We recommend limiting your file size to 500MB. Example: text profileintegrationid charles alexa

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
audienceId int32 The ID of the audience.
optional *ImportAudiencesMembershipsOpts optional parameters nil if no parameters

Optional Parameters

Optional parameters are passed through a pointer to a ImportAudiencesMembershipsOpts struct

Name Type Description Notes

upFile | optional.| The file containing the data that is being imported. |

Return type

Import

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: multipart/form-data
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

ImportCampaignStores

Import ImportCampaignStores(ctx, applicationId, campaignId, optional)

Import stores

Upload a CSV file containing the stores you want to link to a specific campaign. Send the file as multipart data. The CSV file must only contain the following column: - store_integration_id: The identifier of the store. The import replaces the previous list of stores linked to the campaign.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
applicationId int32 The ID of the Application. It is displayed in your Talon.One deployment URL.
campaignId int32 The ID of the campaign. It is displayed in your Talon.One deployment URL.
optional *ImportCampaignStoresOpts optional parameters nil if no parameters

Optional Parameters

Optional parameters are passed through a pointer to a ImportCampaignStoresOpts struct

Name Type Description Notes

upFile | optional.| The file containing the data that is being imported. |

Return type

Import

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: multipart/form-data
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

ImportCollection

Import ImportCollection(ctx, applicationId, campaignId, collectionId, optional)

Import data into existing campaign-level collection

Upload a CSV file containing the collection of string values that should be attached as payload for collection. The file should be sent as multipart data. The import replaces the initial content of the collection. The CSV file must only contain the following column: - item: the values in your collection. A collection is limited to 500,000 items. Example: item Addidas Nike Asics Note: Before sending a request to this endpoint, ensure the data in the CSV to import is different from the data currently stored in the collection.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
applicationId int32 The ID of the Application. It is displayed in your Talon.One deployment URL.
campaignId int32 The ID of the campaign. It is displayed in your Talon.One deployment URL.
collectionId int32 The ID of the collection. You can get it with the List collections in Application endpoint.
optional *ImportCollectionOpts optional parameters nil if no parameters

Optional Parameters

Optional parameters are passed through a pointer to a ImportCollectionOpts struct

Name Type Description Notes

upFile | optional.| The file containing the data that is being imported. |

Return type

Import

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: multipart/form-data
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

ImportCoupons

Import ImportCoupons(ctx, applicationId, campaignId, optional)

Import coupons

Upload a CSV file containing the coupons that should be created. The file should be sent as multipart data. The CSV file contains the following columns: - value (required): The coupon code. - expirydate: The end date in RFC3339 of the code redemption period. - startdate: The start date in RFC3339 of the code redemption period. - recipientintegrationid: The integration ID of the recipient of the coupon. Only the customer with this integration ID can redeem this code. Available only for personal codes. - limitval: The maximum number of redemptions of this code. For unlimited redemptions, use 0. Defaults to 1 when not provided. - discountlimit: The total discount value that the code can give. This is typically used to represent a gift card value. - attributes: A JSON object describing custom coupon attribute names and their values, enclosed with double quotation marks. For example, if you created a custom attribute called category associated with the coupon entity, the object in the CSV file, when opened in a text editor, must be: \"{\"category\": \"10_off\"}\". You can use the time zone of your choice. It is converted to UTC internally by Talon.One. Note: We recommend limiting your file size to 500MB. Example: text \"value\",\"expirydate\",\"startdate\",\"recipientintegrationid\",\"limitval\",\"attributes\",\"discountlimit\" COUP1,2018-07-01T04:00:00Z,2018-05-01T04:00:00Z,cust123,1,\"{\"\"Category\"\": \"\"10_off\"\"}\",2.4 Once imported, you can find the batchId in the Campaign Manager or by using List coupons.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
applicationId int32 The ID of the Application. It is displayed in your Talon.One deployment URL.
campaignId int32 The ID of the campaign. It is displayed in your Talon.One deployment URL.
optional *ImportCouponsOpts optional parameters nil if no parameters

Optional Parameters

Optional parameters are passed through a pointer to a ImportCouponsOpts struct

Name Type Description Notes

skipDuplicates | optional.| An indicator of whether to skip duplicate coupon values instead of causing an error. Duplicate values are ignored when `skipDuplicates=true`. | upFile | optional.| The file containing the data that is being imported. |

Return type

Import

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: multipart/form-data
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

ImportLoyaltyCards

Import ImportLoyaltyCards(ctx, loyaltyProgramId, optional)

Import loyalty cards

Upload a CSV file containing the loyalty cards that you want to use in your card-based loyalty program. Send the file as multipart data. It contains the following columns for each card: - identifier (required): The alphanumeric identifier of the loyalty card. - state (required): The state of the loyalty card. It can be active or inactive. - customerprofileids (optional): An array of strings representing the identifiers of the customer profiles linked to the loyalty card. The identifiers should be separated with a semicolon (;). Note: We recommend limiting your file size to 500MB. Example: csv identifier,state,customerprofileids 123-456-789AT,active,Alexa001;UserA

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
loyaltyProgramId int32 Identifier of the card-based loyalty program containing the loyalty card. You can get the ID with the List loyalty programs endpoint.
optional *ImportLoyaltyCardsOpts optional parameters nil if no parameters

Optional Parameters

Optional parameters are passed through a pointer to a ImportLoyaltyCardsOpts struct

Name Type Description Notes

upFile | optional.| The file containing the data that is being imported. |

Return type

Import

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: multipart/form-data
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

ImportLoyaltyCustomersTiers

Import ImportLoyaltyCustomersTiers(ctx, loyaltyProgramId, optional)

Import customers into loyalty tiers

Upload a CSV file containing existing customers to be assigned to existing tiers. Send the file as multipart data. Important: This endpoint only works with loyalty programs with advanced tiers (with expiration and downgrade policy) feature enabled. The CSV file should contain the following columns: - subledgerid (optional): The ID of the subledger. If this field is empty, the main ledger will be used. - customerprofileid: The integration ID of the customer profile to whom the tier should be assigned. - tiername: The name of an existing tier to assign to the customer. - expirydate: The expiration date of the tier when the tier is reevaluated. It should be a future date. About customer assignment to a tier: - If the customer isn't already in a tier, the customer is assigned to the specified tier during the tier import. - If the customer is already in the tier that's specified in the CSV file, only the expiration date is updated. Note: We recommend not using this endpoint to update the tier of a customer. To update a customer's tier, you can add or deduct their loyalty points. You can use the time zone of your choice. It is converted to UTC internally by Talon.One. Note: We recommend limiting your file size to 500MB. Example: csv subledgerid,customerprofileid,tiername,expirydate SUB1,alexa,Gold,2024-03-21T07:32:14Z ,george,Silver,2025-04-16T21:12:37Z SUB2,avocado,Bronze,2026-05-03T11:47:01Z

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
loyaltyProgramId int32 Identifier of the loyalty program. You can get the ID with the List loyalty programs endpoint.
optional *ImportLoyaltyCustomersTiersOpts optional parameters nil if no parameters

Optional Parameters

Optional parameters are passed through a pointer to a ImportLoyaltyCustomersTiersOpts struct

Name Type Description Notes

upFile | optional.| The file containing the data that is being imported. |

Return type

Import

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: multipart/form-data
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

ImportLoyaltyPoints

Import ImportLoyaltyPoints(ctx, loyaltyProgramId, optional)

Import loyalty points

Upload a CSV file containing the loyalty points you want to import into a given loyalty program. Send the file as multipart data. Depending on the type of loyalty program, you can import points into a given customer profile or loyalty card. The CSV file contains the following columns: - customerprofileid (optional): For profile-based loyalty programs, the integration ID of the customer profile where the loyalty points are imported. Note: If the customer profile does not exist, it will be created. The profile will not be visible in any Application until a session or profile update is received for that profile. - identifier (optional): For card-based loyalty programs, the identifier of the loyalty card where the loyalty points are imported. - amount: The amount of points to award to the customer profile. - startdate (optional): The earliest date when the points can be redeemed. The points are active from this date until the expiration date. Note: It must be an RFC3339 timestamp string or string immediate. Empty or missing values are considered immediate. - expirydate (optional): The latest date when the points can be redeemed. The points are expired after this date. Note: It must be an RFC3339 timestamp string or string unlimited. Empty or missing values are considered unlimited. - subledgerid (optional): The ID of the subledger that should received the points. - reason (optional): The reason why these points are awarded. You can use the time zone of your choice. It is converted to UTC internally by Talon.One. Note: For existing customer profiles and loyalty cards, the imported points are added to any previous active or pending points, depending on the value provided for startdate. If startdate matches the current date, the imported points are active. If it is later, the points are pending until the date provided for startdate is reached. Note: We recommend limiting your file size to 500MB. Example for profile-based programs: text customerprofileid,amount,startdate,expirydate,subledgerid,reason URNGV8294NV,100,2009-11-10T23:00:00Z,2009-11-11T23:00:00Z,subledger1,appeasement Example for card-based programs: text identifier,amount,startdate,expirydate,subledgerid,reason summer-loyalty-card-0543,100,2009-11-10T23:00:00Z,2009-11-11T23:00:00Z,subledger1,appeasement

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
loyaltyProgramId int32 Identifier of the loyalty program. You can get the ID with the List loyalty programs endpoint.
optional *ImportLoyaltyPointsOpts optional parameters nil if no parameters

Optional Parameters

Optional parameters are passed through a pointer to a ImportLoyaltyPointsOpts struct

Name Type Description Notes

upFile | optional.| The file containing the data that is being imported. |

Return type

Import

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: multipart/form-data
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

ImportPoolGiveaways

Import ImportPoolGiveaways(ctx, poolId, optional)

Import giveaway codes into a giveaway pool

Upload a CSV file containing the giveaway codes that should be created. Send the file as multipart data. The CSV file contains the following columns: - code (required): The code of your giveaway, for instance, a gift card redemption code. - startdate: The start date in RFC3339 of the code redemption period. - enddate: The last date in RFC3339 of the code redemption period. - attributes: A JSON object describing custom giveaway attribute names and their values, enclosed with double quotation marks. For example, if you created a custom attribute called provider associated with the giveaway entity, the object in the CSV file, when opened in a text editor, must be: \"{\"provider\": \"myPartnerCompany\"}\". The startdate and enddate have nothing to do with the validity of the codes. They are only used by the Rule Engine to award the codes or not. You can use the time zone setting of your choice. The values are converted to UTC internally by Talon.One. Note: - We recommend limiting your file size to 500MB. - You can import the same code multiple times. Duplicate codes are treated and distributed to customers as unique codes. Example: text code,startdate,enddate,attributes GIVEAWAY1,2020-11-10T23:00:00Z,2022-11-11T23:00:00Z,\"{\"\"provider\"\": \"\"Amazon\"\"}\" GIVEAWAY2,2020-11-10T23:00:00Z,2022-11-11T23:00:00Z,\"{\"\"provider\"\": \"\"Amazon\"\"}\" GIVEAWAY3,2021-01-10T23:00:00Z,2022-11-11T23:00:00Z,\"{\"\"provider\"\": \"\"Aliexpress\"\"}\"

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
poolId int32 The ID of the pool. You can find it in the Campaign Manager, in the Giveaways section.
optional *ImportPoolGiveawaysOpts optional parameters nil if no parameters

Optional Parameters

Optional parameters are passed through a pointer to a ImportPoolGiveawaysOpts struct

Name Type Description Notes

upFile | optional.| The file containing the data that is being imported. |

Return type

Import

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: multipart/form-data
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

ImportReferrals

Import ImportReferrals(ctx, applicationId, campaignId, optional)

Import referrals

Upload a CSV file containing the referrals that should be created. The file should be sent as multipart data. The CSV file contains the following columns: - code (required): The referral code. - advocateprofileintegrationid (required): The profile ID of the advocate. - startdate: The start date in RFC3339 of the code redemption period. - expirydate: The end date in RFC3339 of the code redemption period. - limitval: The maximum number of redemptions of this code. Defaults to 1 when left blank. - attributes: A JSON object describing custom referral attribute names and their values, enclosed with double quotation marks. For example, if you created a custom attribute called category associated with the referral entity, the object in the CSV file, when opened in a text editor, must be: \"{\"category\": \"10_off\"}\". You can use the time zone of your choice. It is converted to UTC internally by Talon.One. Important: When you import a CSV file with referrals, a customer profile is not automatically created for each advocateprofileintegrationid column value. Use the Update customer profile endpoint or the Update multiple customer profiles endpoint to create the customer profiles. Note: We recommend limiting your file size to 500MB. Example: text code,startdate,expirydate,advocateprofileintegrationid,limitval,attributes REFERRAL_CODE1,2020-11-10T23:00:00Z,2021-11-11T23:00:00Z,integid_4,1,\"{\"\"my_attribute\"\": \"\"10_off\"\"}\" REFERRAL_CODE2,2020-11-10T23:00:00Z,2021-11-11T23:00:00Z,integid1,1,\"{\"\"my_attribute\"\": \"\"20_off\"\"}\"

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
applicationId int32 The ID of the Application. It is displayed in your Talon.One deployment URL.
campaignId int32 The ID of the campaign. It is displayed in your Talon.One deployment URL.
optional *ImportReferralsOpts optional parameters nil if no parameters

Optional Parameters

Optional parameters are passed through a pointer to a ImportReferralsOpts struct

Name Type Description Notes

upFile | optional.| The file containing the data that is being imported. |

Return type

Import

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: multipart/form-data
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

InviteUserExternal

InviteUserExternal(ctx, body)

Invite user from identity provider

Invite a user from an external identity provider to Talon.One by sending an invitation to their email address.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
body NewExternalInvitation body

Return type

(empty response body)

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: application/json
  • Accept: Not defined

[Back to top] [Back to API list] [Back to Model list] [Back to README]

ListAccountCollections

InlineResponse20017 ListAccountCollections(ctx, optional)

List collections in account

List account-level collections in the account.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
optional *ListAccountCollectionsOpts optional parameters nil if no parameters

Optional Parameters

Optional parameters are passed through a pointer to a ListAccountCollectionsOpts struct

Name Type Description Notes
pageSize optional. The number of items in the response. [default to 1000]
skip optional. The number of items to skip when paging through large result sets.
sort optional. The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. Note: This parameter works only with numeric fields.
withTotalResultSize optional. When this flag is set, the result includes the total size of the result, across all pages. This might decrease performance on large data sets. - When `true`: `hasMore` is true when there is a next page. `totalResultSize` is always zero. - When `false`: `hasMore` is always false. `totalResultSize` contains the total number of results for this query.
name optional. Filter by collection name.

Return type

InlineResponse20017

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

ListAchievements

InlineResponse20045 ListAchievements(ctx, applicationId, campaignId, optional)

List achievements

List all the achievements for a specific campaign.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
applicationId int32 The ID of the Application. It is displayed in your Talon.One deployment URL.
campaignId int32 The ID of the campaign. It is displayed in your Talon.One deployment URL.
optional *ListAchievementsOpts optional parameters nil if no parameters

Optional Parameters

Optional parameters are passed through a pointer to a ListAchievementsOpts struct

Name Type Description Notes

pageSize | optional.| The number of items in the response. | [default to 50] skip | optional.| The number of items to skip when paging through large result sets. | title | optional.| Filter by the display name for the achievement in the campaign manager. Note: If no `title` is provided, all the achievements from the campaign are returned. |

Return type

InlineResponse20045

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

ListAllRolesV2

InlineResponse20043 ListAllRolesV2(ctx, )

List roles

List all roles.

Required Parameters

This endpoint does not need any parameter.

Return type

InlineResponse20043

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

ListCatalogItems

InlineResponse20034 ListCatalogItems(ctx, catalogId, optional)

List items in a catalog

Return a paginated list of cart items in the given catalog.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
catalogId int32 The ID of the catalog. You can find the ID in the Campaign Manager in Account > Tools > Cart item catalogs.
optional *ListCatalogItemsOpts optional parameters nil if no parameters

Optional Parameters

Optional parameters are passed through a pointer to a ListCatalogItemsOpts struct

Name Type Description Notes

pageSize | optional.| The number of items in the response. | [default to 1000] skip | optional.| The number of items to skip when paging through large result sets. | withTotalResultSize | optional.| When this flag is set, the result includes the total size of the result, across all pages. This might decrease performance on large data sets. - When `true`: `hasMore` is true when there is a next page. `totalResultSize` is always zero. - When `false`: `hasMore` is always false. `totalResultSize` contains the total number of results for this query. | sku | optional.Interface of []string| Filter results by one or more SKUs. Must be exact match. | productNames | optional.Interface of []string| Filter results by one or more product names. Must be exact match. |

Return type

InlineResponse20034

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

ListCollections

InlineResponse20017 ListCollections(ctx, applicationId, campaignId, optional)

List collections in campaign

List collections in a given campaign.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
applicationId int32 The ID of the Application. It is displayed in your Talon.One deployment URL.
campaignId int32 The ID of the campaign. It is displayed in your Talon.One deployment URL.
optional *ListCollectionsOpts optional parameters nil if no parameters

Optional Parameters

Optional parameters are passed through a pointer to a ListCollectionsOpts struct

Name Type Description Notes

pageSize | optional.| The number of items in the response. | [default to 1000] skip | optional.| The number of items to skip when paging through large result sets. | sort | optional.| The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. Note: This parameter works only with numeric fields. | withTotalResultSize | optional.| When this flag is set, the result includes the total size of the result, across all pages. This might decrease performance on large data sets. - When `true`: `hasMore` is true when there is a next page. `totalResultSize` is always zero. - When `false`: `hasMore` is always false. `totalResultSize` contains the total number of results for this query. | name | optional.| Filter by collection name. |

Return type

InlineResponse20017

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

ListCollectionsInApplication

InlineResponse20017 ListCollectionsInApplication(ctx, applicationId, optional)

List collections in Application

List campaign-level collections from all campaigns in a given Application.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
applicationId int32 The ID of the Application. It is displayed in your Talon.One deployment URL.
optional *ListCollectionsInApplicationOpts optional parameters nil if no parameters

Optional Parameters

Optional parameters are passed through a pointer to a ListCollectionsInApplicationOpts struct

Name Type Description Notes

pageSize | optional.| The number of items in the response. | [default to 1000] skip | optional.| The number of items to skip when paging through large result sets. | sort | optional.| The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. Note: This parameter works only with numeric fields. | withTotalResultSize | optional.| When this flag is set, the result includes the total size of the result, across all pages. This might decrease performance on large data sets. - When `true`: `hasMore` is true when there is a next page. `totalResultSize` is always zero. - When `false`: `hasMore` is always false. `totalResultSize` contains the total number of results for this query. | name | optional.| Filter by collection name. |

Return type

InlineResponse20017

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

ListStores

InlineResponse20044 ListStores(ctx, applicationId, optional)

List stores

List all stores for a specific Application.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
applicationId int32 The ID of the Application. It is displayed in your Talon.One deployment URL.
optional *ListStoresOpts optional parameters nil if no parameters

Optional Parameters

Optional parameters are passed through a pointer to a ListStoresOpts struct

Name Type Description Notes

pageSize | optional.| The number of items in the response. | [default to 1000] skip | optional.| The number of items to skip when paging through large result sets. | sort | optional.| The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. Note: This parameter works only with numeric fields. | withTotalResultSize | optional.| When this flag is set, the result includes the total size of the result, across all pages. This might decrease performance on large data sets. - When `true`: `hasMore` is true when there is a next page. `totalResultSize` is always zero. - When `false`: `hasMore` is always false. `totalResultSize` contains the total number of results for this query. | campaignId | optional.| Filter results by campaign ID. | name | optional.| The name of the store. | integrationId | optional.| The integration ID of the store. | query | optional.| Filter results by `name` or `integrationId`. |

Return type

InlineResponse20044

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

NotificationActivation

NotificationActivation(ctx, notificationId, body)

Activate or deactivate notification

Activate or deactivate the given notification. When enabled is false, updates will no longer be sent for the given notification.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
notificationId int32 The ID of the notification. Get it with the appropriate List notifications endpoint.
body NotificationActivation body

Return type

(empty response body)

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: application/json
  • Accept: Not defined

[Back to top] [Back to API list] [Back to Model list] [Back to README]

OktaEventHandlerChallenge

OktaEventHandlerChallenge(ctx, )

Validate Okta API ownership

Validate the ownership of the API through a challenge-response mechanism. This challenger endpoint is used by Okta to confirm that communication between Talon.One and Okta is correctly configured and accessible for provisioning and deprovisioning of Talon.One users, and that only Talon.One can receive and respond to events from Okta.

Required Parameters

This endpoint does not need any parameter.

Return type

(empty response body)

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: Not defined

[Back to top] [Back to API list] [Back to Model list] [Back to README]

PostAddedDeductedPointsNotification

BaseNotification PostAddedDeductedPointsNotification(ctx, loyaltyProgramId, body)

Create notification about added or deducted loyalty points

Create a notification about added or deducted loyalty points in a given profile-based loyalty program. A notification for added or deducted loyalty points is different from regular webhooks in that it is loyalty program-scoped and has a predefined payload. For more information, see Managing loyalty notifications.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
loyaltyProgramId int32 Identifier of the profile-based loyalty program. You can get the ID with the List loyalty programs endpoint.
body NewBaseNotification body

Return type

BaseNotification

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

PostCatalogsStrikethroughNotification

BaseNotification PostCatalogsStrikethroughNotification(ctx, applicationId, body)

Create strikethrough notification

Create a notification for the in the given Application. For more information, see Managing notifications. See the payload you will receive.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
applicationId int32 The ID of the Application. It is displayed in your Talon.One deployment URL.
body NewBaseNotification body

Return type

BaseNotification

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

PostPendingPointsNotification

BaseNotification PostPendingPointsNotification(ctx, loyaltyProgramId, body)

Create notification about pending loyalty points

Create a notification about pending loyalty points for a given profile-based loyalty program. For more information, see Managing loyalty notifications.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
loyaltyProgramId int32 Identifier of the profile-based loyalty program. You can get the ID with the List loyalty programs endpoint.
body NewBaseNotification body

Return type

BaseNotification

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

RemoveLoyaltyPoints

RemoveLoyaltyPoints(ctx, loyaltyProgramId, integrationId, body)

Deduct points from customer profile

Deduct points from the specified loyalty program and specified customer profile. Important: - Only active points can be deducted. - Only pending points are rolled back when a session is cancelled or reopened. To get the integrationId of the profile from a sessionId, use the Update customer session endpoint.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
loyaltyProgramId string The identifier for the loyalty program.
integrationId string The identifier of the profile.
body DeductLoyaltyPoints body

Return type

(empty response body)

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

ResetPassword

NewPassword ResetPassword(ctx, body)

Reset password

Consumes the supplied password reset token and updates the password for the associated account.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
body NewPassword body

Return type

NewPassword

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

ScimCreateUser

ScimUser ScimCreateUser(ctx, body)

Create SCIM user

Create a new Talon.One user using the SCIM provisioning protocol with an identity provider, for example, Microsoft Entra ID.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
body ScimNewUser body

Return type

ScimUser

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

ScimDeleteUser

ScimDeleteUser(ctx, userId)

Delete SCIM user

Delete a specific Talon.One user created using the SCIM provisioning protocol with an identity provider, for example, Microsoft Entra ID.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
userId int32 The ID of the user.

Return type

(empty response body)

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: Not defined

[Back to top] [Back to API list] [Back to Model list] [Back to README]

ScimGetResourceTypes

ScimResourceTypesListResponse ScimGetResourceTypes(ctx, )

List supported SCIM resource types

Retrieve a list of resource types supported by the SCIM provisioning protocol. Resource types define the various kinds of resources that can be managed via the SCIM API, such as users, groups, or custom-defined resources.

Required Parameters

This endpoint does not need any parameter.

Return type

ScimResourceTypesListResponse

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

ScimGetSchemas

ScimSchemasListResponse ScimGetSchemas(ctx, )

List supported SCIM schemas

Retrieve a list of schemas supported by the SCIM provisioning protocol. Schemas define the structure and attributes of the different resources that can be managed via the SCIM API, such as users, groups, and any custom-defined resources.

Required Parameters

This endpoint does not need any parameter.

Return type

ScimSchemasListResponse

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

ScimGetServiceProviderConfig

ScimServiceProviderConfigResponse ScimGetServiceProviderConfig(ctx, )

Get SCIM service provider configuration

Retrieve the configuration settings of the SCIM service provider. It provides details about the features and capabilities supported by the SCIM API, such as the different operation settings.

Required Parameters

This endpoint does not need any parameter.

Return type

ScimServiceProviderConfigResponse

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

ScimGetUser

ScimUser ScimGetUser(ctx, userId)

Get SCIM user

Retrieve data for a specific Talon.One user created using the SCIM provisioning protocol with an identity provider, for example, Microsoft Entra ID.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
userId int32 The ID of the user.

Return type

ScimUser

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

ScimGetUsers

ScimUsersListResponse ScimGetUsers(ctx, )

List SCIM users

Retrieve a paginated list of users that have been provisioned using the SCIM protocol with an identity provider, for example, Microsoft Entra ID.

Required Parameters

This endpoint does not need any parameter.

Return type

ScimUsersListResponse

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

ScimPatchUser

ScimUser ScimPatchUser(ctx, userId, body)

Update SCIM user attributes

Update certain attributes of a specific Talon.One user created using the SCIM provisioning protocol with an identity provider, for example, Microsoft Entra ID. This endpoint allows for selective adding, removing, or replacing specific attributes while leaving other attributes unchanged.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
userId int32 The ID of the user.
body ScimPatchRequest body

Return type

ScimUser

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

ScimReplaceUserAttributes

ScimUser ScimReplaceUserAttributes(ctx, userId, body)

Update SCIM user

Update the details of a specific Talon.One user created using the SCIM provisioning protocol with an identity provider, for example, Microsoft Entra ID. This endpoint replaces all attributes of the specific user with the attributes provided in the request payload.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
userId int32 The ID of the user.
body ScimNewUser body

Return type

ScimUser

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

SearchCouponsAdvancedApplicationWideWithoutTotalCount

InlineResponse2009 SearchCouponsAdvancedApplicationWideWithoutTotalCount(ctx, applicationId, body, optional)

List coupons that match the given attributes (without total count)

List the coupons whose attributes match the query criteria in all the campaigns of the given Application. The match is successful if all the attributes of the request are found in a coupon, even if the coupon has more attributes that are not present on the request. Note: The total count is not included in the response.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
applicationId int32 The ID of the Application. It is displayed in your Talon.One deployment URL.
body map[string]interface{} body
optional *SearchCouponsAdvancedApplicationWideWithoutTotalCountOpts optional parameters nil if no parameters

Optional Parameters

Optional parameters are passed through a pointer to a SearchCouponsAdvancedApplicationWideWithoutTotalCountOpts struct

Name Type Description Notes

pageSize | optional.| The number of items in the response. | [default to 1000] skip | optional.| The number of items to skip when paging through large result sets. | sort | optional.| The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. Note: This parameter works only with numeric fields. | value | optional.| Filter results performing case-insensitive matching against the coupon code. Both the code and the query are folded to remove all non-alpha-numeric characters. | createdBefore | optional.| Filter results comparing the parameter value, expected to be an RFC3339 timestamp string, to the coupon creation timestamp. You can use any time zone setting. Talon.One will convert to UTC internally. | createdAfter | optional.| Filter results comparing the parameter value, expected to be an RFC3339 timestamp string, to the coupon creation timestamp. You can use any time zone setting. Talon.One will convert to UTC internally. | valid | optional.| Either &quot;expired&quot;, &quot;validNow&quot;, or &quot;validFuture&quot;. The first option matches coupons in which the expiration date is set and in the past. The second matches coupons in which start date is null or in the past and expiration date is null or in the future, the third matches coupons in which start date is set and in the future. | usable | optional.| Either &quot;true&quot; or &quot;false&quot;. If &quot;true&quot;, only coupons where `usageCounter < usageLimit` will be returned, &quot;false&quot; will return only coupons where `usageCounter >= usageLimit`. | referralId | optional.| Filter the results by matching them with the ID of a referral. This filter shows the coupons created by redeeming a referral code. | recipientIntegrationId | optional.| Filter results by match with a profile ID specified in the coupon's RecipientIntegrationId field. | batchId | optional.| Filter results by batches of coupons | exactMatch | optional.| Filter results to an exact case-insensitive matching against the coupon code. | [default to false] campaignState | optional.| Filter results by the state of the campaign. - `enabled`: Campaigns that are scheduled, running (activated), or expired. - `running`: Campaigns that are running (activated). - `disabled`: Campaigns that are disabled. - `expired`: Campaigns that are expired. - `archived`: Campaigns that are archived. |

Return type

InlineResponse2009

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

SearchCouponsAdvancedWithoutTotalCount

InlineResponse2009 SearchCouponsAdvancedWithoutTotalCount(ctx, applicationId, campaignId, body, optional)

List coupons that match the given attributes in campaign (without total count)

List the coupons whose attributes match the query criteria in the given campaign. The match is successful if all the attributes of the request are found in a coupon, even if the coupon has more attributes that are not present on the request. Note: The total count is not included in the response.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
applicationId int32 The ID of the Application. It is displayed in your Talon.One deployment URL.
campaignId int32 The ID of the campaign. It is displayed in your Talon.One deployment URL.
body map[string]interface{} body
optional *SearchCouponsAdvancedWithoutTotalCountOpts optional parameters nil if no parameters

Optional Parameters

Optional parameters are passed through a pointer to a SearchCouponsAdvancedWithoutTotalCountOpts struct

Name Type Description Notes

pageSize | optional.| The number of items in the response. | [default to 1000] skip | optional.| The number of items to skip when paging through large result sets. | sort | optional.| The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. Note: This parameter works only with numeric fields. | value | optional.| Filter results performing case-insensitive matching against the coupon code. Both the code and the query are folded to remove all non-alpha-numeric characters. | createdBefore | optional.| Filter results comparing the parameter value, expected to be an RFC3339 timestamp string, to the coupon creation timestamp. You can use any time zone setting. Talon.One will convert to UTC internally. | createdAfter | optional.| Filter results comparing the parameter value, expected to be an RFC3339 timestamp string, to the coupon creation timestamp. You can use any time zone setting. Talon.One will convert to UTC internally. | valid | optional.| Either &quot;expired&quot;, &quot;validNow&quot;, or &quot;validFuture&quot;. The first option matches coupons in which the expiration date is set and in the past. The second matches coupons in which start date is null or in the past and expiration date is null or in the future, the third matches coupons in which start date is set and in the future. | usable | optional.| Either &quot;true&quot; or &quot;false&quot;. If &quot;true&quot;, only coupons where `usageCounter < usageLimit` will be returned, &quot;false&quot; will return only coupons where `usageCounter >= usageLimit`. | referralId | optional.| Filter the results by matching them with the ID of a referral. This filter shows the coupons created by redeeming a referral code. | recipientIntegrationId | optional.| Filter results by match with a profile ID specified in the coupon's RecipientIntegrationId field. | exactMatch | optional.| Filter results to an exact case-insensitive matching against the coupon code. | [default to false] batchId | optional.| Filter results by batches of coupons |

Return type

InlineResponse2009

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

TransferLoyaltyCard

TransferLoyaltyCard(ctx, loyaltyProgramId, loyaltyCardId, body)

Transfer card data

Transfer loyalty card data, such as linked customers, loyalty balances and transactions, from a given loyalty card to a new, automatically created loyalty card. Important: - The original card is automatically blocked once the new card is created, and it cannot be activated again. - The default status of the new card is active.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
loyaltyProgramId int32 Identifier of the card-based loyalty program containing the loyalty card. You can get the ID with the List loyalty programs endpoint.
loyaltyCardId string Identifier of the loyalty card. You can get the identifier with the List loyalty cards endpoint.
body TransferLoyaltyCard body

Return type

(empty response body)

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

UpdateAccountCollection

Collection UpdateAccountCollection(ctx, collectionId, body)

Update account-level collection

Edit the description of a given account-level collection and enable or disable the collection in the specified Applications.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
collectionId int32 The ID of the collection. You can get it with the List collections in account endpoint.
body UpdateCollection body

Return type

Collection

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

UpdateAchievement

Achievement UpdateAchievement(ctx, applicationId, campaignId, achievementId, body)

Update achievement

Update the details of a specific achievement.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
applicationId int32 The ID of the Application. It is displayed in your Talon.One deployment URL.
campaignId int32 The ID of the campaign. It is displayed in your Talon.One deployment URL.
achievementId int32 The ID of the achievement. You can get this ID with the List achievement endpoint.
body UpdateAchievement body

Return type

Achievement

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

UpdateAdditionalCost

AccountAdditionalCost UpdateAdditionalCost(ctx, additionalCostId, body)

Update additional cost

Updates an existing additional cost. Once created, the only property of an additional cost that cannot be changed is the name property (or API name in the Campaign Manager). This restriction is in place to prevent accidentally breaking live integrations.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
additionalCostId int32 The ID of the additional cost. You can find the ID the the Campaign Manager's URL when you display the details of the cost in Account > Tools > Additional costs.
body NewAdditionalCost body

Return type

AccountAdditionalCost

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

UpdateAttribute

Attribute UpdateAttribute(ctx, attributeId, body)

Update custom attribute

Update an existing custom attribute. Once created, the only property of a custom attribute that can be changed is the description. To change the type or name property of a custom attribute, create a new attribute and update any relevant integrations and rules to use the new attribute.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
attributeId int32 The ID of the attribute. You can find the ID in the Campaign Manager's URL when you display the details of an attribute in Account > Tools > Attributes.
body NewAttribute body

Return type

Attribute

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

UpdateCampaign

Campaign UpdateCampaign(ctx, applicationId, campaignId, body)

Update campaign

Update the given campaign. Important: You cannot use this endpoint to update campaigns if campaign staging and revisions is enabled for your Application.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
applicationId int32 The ID of the Application. It is displayed in your Talon.One deployment URL.
campaignId int32 The ID of the campaign. It is displayed in your Talon.One deployment URL.
body UpdateCampaign body

Return type

Campaign

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

UpdateCollection

Collection UpdateCollection(ctx, applicationId, campaignId, collectionId, body)

Update campaign-level collection's description

Edit the description of a given campaign-level collection.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
applicationId int32 The ID of the Application. It is displayed in your Talon.One deployment URL.
campaignId int32 The ID of the campaign. It is displayed in your Talon.One deployment URL.
collectionId int32 The ID of the collection. You can get it with the List collections in Application endpoint.
body UpdateCampaignCollection body

Return type

Collection

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

UpdateCoupon

Coupon UpdateCoupon(ctx, applicationId, campaignId, couponId, body)

Update coupon

Update the specified coupon. <div class="redoc-section"> <p class="title">Important

With this PUT endpoint, if you do not explicitly set a value for the startDate, expiryDate, and recipientIntegrationId properties in your request, it is automatically set to null.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
applicationId int32 The ID of the Application. It is displayed in your Talon.One deployment URL.
campaignId int32 The ID of the campaign. It is displayed in your Talon.One deployment URL.
couponId string The internal ID of the coupon code. You can find this value in the `id` property from the List coupons endpoint response.
body UpdateCoupon body

Return type

Coupon

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

UpdateCouponBatch

UpdateCouponBatch(ctx, applicationId, campaignId, body)

Update coupons

Update all coupons or a specific batch of coupons in the given campaign. You can find the batchId on the Coupons page of your campaign in the Campaign Manager, or you can use List coupons. <div class="redoc-section"> <p class="title">Important

  • Only send sequential requests to this endpoint.
  • Requests to this endpoint time out after 30 minutes. If you hit a timeout, contact our support team.
  • With this PUT endpoint, if you do not explicitly set a value for the startDate and expiryDate properties in your request, it is automatically set to null.
To update a specific coupon, use Update coupon.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
applicationId int32 The ID of the Application. It is displayed in your Talon.One deployment URL.
campaignId int32 The ID of the campaign. It is displayed in your Talon.One deployment URL.
body UpdateCouponBatch body

Return type

(empty response body)

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: application/json
  • Accept: Not defined

[Back to top] [Back to API list] [Back to Model list] [Back to README]

UpdateLoyaltyCard

LoyaltyCard UpdateLoyaltyCard(ctx, loyaltyProgramId, loyaltyCardId, body)

Update loyalty card status

Update the status of the given loyalty card. A card can be active or inactive.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
loyaltyProgramId int32 Identifier of the card-based loyalty program containing the loyalty card. You can get the ID with the List loyalty programs endpoint.
loyaltyCardId string Identifier of the loyalty card. You can get the identifier with the List loyalty cards endpoint.
body UpdateLoyaltyCard body

Return type

LoyaltyCard

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

UpdateReferral

Referral UpdateReferral(ctx, applicationId, campaignId, referralId, body)

Update referral

Update the specified referral.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
applicationId int32 The ID of the Application. It is displayed in your Talon.One deployment URL.
campaignId int32 The ID of the campaign. It is displayed in your Talon.One deployment URL.
referralId string The ID of the referral code.
body UpdateReferral body

Return type

Referral

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

UpdateRoleV2

RoleV2 UpdateRoleV2(ctx, roleId, body)

Update role

Update a specific role.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
roleId int32 The ID of role. Note: To find the ID of a role, use the List roles endpoint.
body RoleV2Base body

Return type

RoleV2

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

UpdateStore

Store UpdateStore(ctx, applicationId, storeId, body)

Update store

Update store details for a specific store ID.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
applicationId int32 The ID of the Application. It is displayed in your Talon.One deployment URL.
storeId string The ID of the store. You can get this ID with the List stores endpoint.
body NewStore body

Return type

Store

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

UpdateUser

User UpdateUser(ctx, userId, body)

Update user

Update the details of a specific user.

Required Parameters

Name Type Description Notes
ctx context.Context context for authentication, logging, cancellation, deadlines, tracing, etc.
userId int32 The ID of the user.
body UpdateUser body

Return type

User

Authorization

management_key, manager_auth

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]