> ## Documentation Index
> Fetch the complete documentation index at: https://help.lobyco.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Post Coupons From an External Promotion Provider

> Push coupons into Lobyco from a third-party promotion provider.

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`

<Steps>
  <Step>
    ## 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.

    * V2 Bulk import via [POST /promotion/v2/bulk/campaigns](/api-reference/promotion-platform/bulk-v2/post-v2-bulk-campaigns) - send a flat array of offers
    * V2 Single import via [POST /promotion/v2/campaigns](/api-reference/promotion-platform/offers-v2/post-v2-campaigns) - create a single offer
    * V3 Bulk import via [POST /promotion/v3/bulk/offers](/api-reference/promotion-platform/bulk-v3/post-v3-bulk-offers) - send a flat array of offers
    * V3 Single import via [POST /promotion/v3/offers](/api-reference/promotion-platform/offers-v3/post-v3-offers) - create or update a single offer
  </Step>

  <Step>
    ## 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.
  </Step>
</Steps>

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:

<img src="https://mintcdn.com/lobyco-4c9fb3ad/wpdZgjvGMgh4Gbhy/images/801c0b6d8a1aba74114d19279d4828bb70d41b4f.png?fit=max&auto=format&n=wpdZgjvGMgh4Gbhy&q=85&s=55cf62ec57a717b463aae8639b62c10a" alt="Screenshot from Lobyco Admin Portal - example of imported offers by API" width="3584" height="1206" data-path="images/801c0b6d8a1aba74114d19279d4828bb70d41b4f.png" />

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](/integration/activities/offers) 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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.