S2S API Changelog

2026.07.02

• Added the copy_store_promotion endpoint to duplicate an existing store promotion
• Added optional custom_icon_url to loyalty settings across get_loyalty_settings and update_loyalty_settings

2026.07.01

• Added requirements_expression targeting rules — content is shown only to matching users — to News and Pages across the news endpoints (get_news_list, create_news, bulk_update_news, get_news_post, update_news) and page endpoints (get_pages, create_page, bulk_update_page, get_page, update_page, translate_page)
• Added optional created_from_campaign_node_id and created_from_campaign_version to store item responses across the store item endpoints (get_all_store_items, get_store_items, get_campaign_store_items, get_user_store_items, create_store_item, update_store_item, bulk_update_store_items)
• Removed the DELETE /v1/campaigns/{campaign_id}/objects endpoint (breaking)
• Added a 32-character max length to the creator_program_id field on update_player
• Removed the internal aghanim__api__player__schemas__PlayerInfo and aghanim__user__schemas__PlayerInfo schemas

2026.06.26

• Added an optional category_id to the Latest Pages layout block, letting it scope content to a specific category, across the page endpoints (get_pages, create_page, bulk_update_page, get_page, update_page, translate_page)

2026.06.20

• Added Progressive Web App (PWA) support — a new pwa_open campaign event type across the campaign endpoints (get_campaigns, create_campaign, get_campaigns_by_ids, get_campaign, update_campaign, update_campaign_graph) and new optional first_pwa_install_at, pwa_install_at, and pwa_visit_at player attributes on update_player

2026.06.19

• Added creator country filtering — a new get_creator_countries endpoint and an optional country query parameter on get_creators
• Renamed the analytics.checkout.payment_method.selected webhook event type to analytics.checkout.payment_method.select across all webhook endpoints (get_webhooks, create_webhook, get_webhook, update_webhook, expire_webhook_secret, reveal_webhook_secret) (breaking)

2026.06.18

• Renamed the analytics.checkout.payment_method.open webhook event type to analytics.checkout.payment_method.select across all webhook endpoints (get_webhooks, create_webhook, get_webhook, update_webhook, expire_webhook_secret, reveal_webhook_secret) (breaking)
• Added a 32-character max length to the news id and collection_id fields and the segment id field across the news and segment endpoints
• Added a 32-character max length to the locale_id field on create_translation_glossary

2026.06.16

• Removed the deprecated single-item coupon fields item_id, quantity, and item across create_coupon, update_coupon, bulk_update_coupon, get_coupon, get_coupons, and get_user_coupons (breaking; use free_items and items instead)

2026.06.13

• Added support for abandoned payments — the abandoned payment status is now returned by get_payments, and a new payment.abandoned webhook event type was added across the webhook endpoints (get_webhooks, create_webhook, get_webhook, update_webhook, expire_webhook_secret, reveal_webhook_secret)
• Added new analytics.checkout.payment_method.select and analytics.checkout.payment_method.close webhook event types across all webhook endpoints (get_webhooks, create_webhook, get_webhook, update_webhook, expire_webhook_secret, reveal_webhook_secret)

2026.06.12

• Added optional store_item_discount_limit_percent and store_item_bonus_limit_percent fields to cap combined store-item-plus-coupon discounts and bonuses across create_coupon, update_coupon, bulk_update_coupon, get_coupon, get_coupons, and get_user_coupons

2026.06.10

• Added an optional operator-only annotation (note, display_name) to creator responses across get_creators, create_creator, get_creator, and update_creator
• Documented the required loyalty_settings_id path parameter on issue_loyalty_points
• Relaxed the email response field to a plain string (dropped the email format constraint) on get_order and update_order

2026.06.08

• Removed the Cashback Rewards resource — all /v1/cashback_rewards endpoints and the CashbackRewardCreate, CashbackRewardRead, and CashbackRewardUpdate schemas (breaking, no deprecation)
• Added optional scope (public or private, default private) to campaign custom attributes across get_campaigns, create_campaign, get_campaigns_by_ids, get_campaign, update_campaign, and update_campaign_graph

2026.06.04

• Added a new Creators resource with full CRUD (get_creators, create_creator, get_creator, update_creator, delete_creator)

2026.06.03

• Added optional vc_settings/allow_non_secure_auth to embedded virtual currency items across daily reward, item, and store item endpoints (get_daily_rewards, create_daily_reward, get_daily_reward, update_daily_reward, copy_daily_reward, get_items, get_all_store_items, get_campaign_store_items, get_user_store_items, get_store_items, bulk_update_store_items, create_store_item, update_store_item)
• Added optional ga4_user_id to player attributes across create_order, update_player, authorize_user, get_order, update_order, and get_player

2026.05.29

• Added Progressive Web App support — a PWAPromptActionNode graph node, pwa_installed / pwa_deinstalled campaign event types, and an optional is_pwa_installed player attribute
• Added optional offers (offers the promotion applies to) across store promotion endpoints (get_store_promotions, create_store_promotion, bulk_update_store_promotions, get_user_promotions, get_store_promotion, update_store_promotion)
• Added campaign_id, user_campaign_id, and user_id to store promotion responses (get_store_promotions, create_store_promotion, bulk_update_store_promotions, get_store_promotion, update_store_promotion)

2026.05.27

• Reworked coupon item rewards to support multiple items per coupon via new free_items and items fields across all coupon endpoints, deprecating single-item item, item_id, and quantity
• Added optional ga4firebase_app_instance_id to player attributes across create_order, update_player, authorize_user, get_order, update_order, and get_player

2026.05.25

• Added RemoveFromSegmentNode graph node across campaign, segment group, and page dynamic-block endpoints
• Added optional collection_id to news endpoints (get_news_list, create_news, bulk_update_news, get_news_post, update_news)
• Added optional video/auto_play to Twitch and YouTube blocks across get_pages, get_page, create_page, update_page, bulk_update_page, and translate_page
• Added optional item_featured_card_background_image_url across store promotion endpoints (get_store_promotions, create_store_promotion, bulk_update_store_promotions, get_user_promotions, get_store_promotion, update_store_promotion)

2026.05.22

• Added optional eligible_for_reward_points, eligible_for_loyalty_points, and rewards (virtual currency rewards with issue status) to get_order and update_order responses

2026.05.21

• Unified item source enum across catalog and order responses, adding seven new reward/liveops values and making the order item source required
• Added optional quantity_bonus_value and quantity_after_bonus to item responses across items, store items, and daily rewards
• Added optional category_template_id to carousel and featured-item blocks and show_thumbnail to Twitch and YouTube video blocks across page endpoints
• Made start_at and end_at optional and nullable across store promotion endpoints
• Added optional creator_program/inherits_from_tier to create_coupon, update_coupon, and coupon responses
• Added optional coupon_code to create_order request
• Added optional show_store_button to get_loyalty_settings and update_loyalty_settings
• Added optional attributes and custom_attributes to get_player response

2026.05.12

• Added optional receipt_number to get_order and update_order responses
• Changed authorize_user to upsert: when the player already exists, the provided player_info (name, avatar_url, attributes, custom_attributes) now updates the stored player on every call instead of being ignored after the first authorization

2026.05.11

• Added optional player_info to authorize_user request, allowing player name, avatar URL, attributes, and custom attributes to be supplied alongside the authorization

2026.05.08

• Added optional button_text and custom_url fields to page card across all page endpoints
• Restructured item objects in order and payment responses with required name and quantity, plain-string image_url, recursive nested_items, and a unified Item schema
• Added reactivate_player_subscription endpoint
• Added optional coupons array to get_order, update_order, and get_payments responses
• Renamed cancel_user_subscriptions operation ID to cancel_player_subscriptions
• Removed OrderItem and PaymentItem schemas

2026.05.07

• Added deprecated Apple-specific image URL fields on item responses across all item-bearing endpoints

2026.05.05

• Set maxLength of 32 on id in locale responses (get_locales, create_locale, get_locale, update_locale)

2026.05.01

• Added structured highlights field across all item types and every endpoint that returns item data
• Deprecated payment_number on get_payments, replaced by new required receipt_number
• Added title, text, and button_text optional fields to ImageBannerBlock in page endpoints
• Added optional bonus_items_settings/start_at and end_at scheduling to store item and store promotion endpoints
• Added optional start_at and end_at to virtual currency items in store item and daily reward responses
• Added optional limited_stock_settings/start_calculation_at to store endpoints
• Added galaxy_store and one_store enum values to marketplace fields in create_order and update_player
• Added optional appsflyer_customer_user_id to create_order and update_player
• Added optional applied_reward_points to get_order, update_order, and get_payments responses
• Changed claim_mode default from modal to inline in create_daily_reward and update_daily_reward
• Tightened image_url validation on achievement endpoints to require a valid URI (non-empty, format: uri, max 2083 characters); achievement type no longer accepts null
• Set maxLength of 32 on user_id in gdpr_data_removal

2026.04.13

• Added virtual currency support across coupons, items, store items, and daily rewards
• Added analytics webhook events and batch delivery mode
• Added bulk_update_coupon endpoint
• Added optional category_id to create_coupon and get_coupons
• Added item_price_type, sort_order parameters and modified_at, price sort options to get_items
• Added amount, amount_before_discount, currency fields to get_order and update_order responses
• Added fallback item fields to featured item blocks in page endpoints
• Added optional sku to loyalty tier items in update_loyalty_tiers
• Removed LoyaltyItemCreatUpdate schema

Need help?
Contact our integration team at [email protected]