Skip to main content
This guide describes the options to import Offers and Coupons and assign them to specific customers in your loyalty programme through integration. In this case you may have a need to feed these into Lobyco Promotion API by making them available to Lobyco features like: App Coupons, Continuity, Games etc.

​
Offer flow via Promotion API

1

​
Import offers from external systems

Offer import is possible from external systems, in case there is another system that can generate offers or allocate coupons.
2

​
Create offers in the Lobyco Admin Tool

Creation directly in the Lobyco Admin Tool where an end user (e.g. marketeer) adds the necessary content regarding discount rules, thresholds, App presentation, and possible segmentation.
Field names in the available APIs and Admin Tool differ slightly, but they are still stored in the same fields in the DB, so it’s safe to mix ways of creating and updating Offers. To create a new Offer, a minimal number of fields has to be provided, including Offer Id, Name, Type, Valid From and Valid To dates. All other fields are optional during initial creation, but will be required when publishing the Offer. When import as been successfully completed by either bulk or single load, the offers will be present in the Lobyco Admin. They will appear based on the defined parameters in the API call: Screenshot from Lobyco Admin Portal - example of imported offers by API Screenshot from Lobyco Admin Portal - example of imported offers by API

​
Publish an Offer

Before the Offer can be displayed in the app, you need to publish it. Before the Offer can be published, populate the following fields:
  • Stores or Chains
  • Title, description and imageUrl in content
  • Discount details, including rule types and values, threshold types and values and list of impacted products and categories.
  • Depending on discount types, you might need to specify more rules. See Offer and discount types or the examples on any of the endpoints.

​
Assign coupons to customers via Coupon API

  • Assign multiple coupons for a single offer to multiple customers in two ways
    • Attach a segmentation file through the Admin Tool
    • Populate audienceId in the Offer model
Last modified on October 19, 2026