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

# Partner Benefits Feeds

> Partner benefits feeds.

This guide explains how to create and manage Partner Benefits Feeds - a powerful way to showcase third-party partner offers, discounts, and exclusive deals directly within your mobile app and digital channels. You'll learn when to use each feed type and how to implement them effectively.

For more information about the endpoints please look up here: [Feed](/api-reference/communication/feed).

## What Are Partner Benefits Feeds?

Partner Benefits Feeds enable retailers to promote collaborative offers from external partners, such as restaurants, services, or other brands. These feeds integrate seamlessly into your existing content strategy, allowing customers to discover valuable partner benefits alongside your regular promotions.

**Common Use Cases:**

* Partner discount programs (e.g., "20% off at Partner Restaurant")
* Exclusive customer benefits from third-party partners
* Collaborative promotions with external brands
* Partner loyalty program integration

#### Examples of request and response bodies

<Tabs>
  <Tab title="Example of POST Partner Benefit Feed">
    ```json theme={"system"}
    {
      "authorId": "example.name@example.com",
      "authorName": "Example Name",
      "campaignName": "Partner restaurant discount",
      "title": "Free item",
      "feedType": "PartnerBenefit",
      "contentType": "Image",
      "publishDate": "2026-10-31T14:15:24.949Z",
      "expirationDate": "2026-11-05T14:15:24.949Z",
      "imageUrl": "https://uploadimageurl.com/190fab0906e943f69eac259ffe9537cd.jpeg",
      "topMessage": "Buy for 200 and receive a gift",
      "bottomMessage": "<p><strong>Details</strong></p>\n<p>Fresh offers a variety of different greens and vegetables. All products are ecological and picked out carefully. Every time you buy a Fresh product you will be rewarded with 15% extra bonus.</p>\n<p><strong></strong></p>\n<br /><p><strong>How to get the benefit</strong></p>\n<p>Use the code below</p>",
      "buttonText": "Go to website to apply code",
      "navigationType": "External",
      "externalUrl": "https://somethingsomethingsomething.com",
      "useWebWrapper": true,
      "deepLinkId": "133c8377-e5a6-4974-a1f5-c9d83e1ef3ce",
      "deepLinkParameters": null,
      "deepLinkUrl": "https://deeplink.your-environment.lobyco.net/home",
      "isReadyToDistribute": false,
      "segmentationType": "None",
      "segmentationFiles": [],
      "storeId": null,
      "audienceIds": [],
      "chainIds": [],
      "storeIds": [],
      "isBoardContent": false,
      "placeholders": [],
      "customProperties": {
        "logoUrl": "https://uploadimageurl.com/customer_logo.svg",
        "detailsImageUrl": "https://uploadimageurl.com/5d6458c53bba4b7c96c63f6f865911a8.jpg",
        "discountCode": {
          "code": "this is BarCode",
          "type": "BarCode"
        },
        "terms": "<p><strong>Terms and conditions:</strong> Offer valid until the expiration date, in participating stores only. One redemption per customer. Cannot be combined with other offers.</p>",
        "announcedStartDate": "2026-10-31T14:15:24.949Z",
        "category": "education"
      }
    }
    ```
  </Tab>

  <Tab title="Example of GET PartnerBenefit Feed">
    ```json theme={"system"}
    {
      "id": 2777,
      "campaignName": "DEMO feed 2",
      "title": "Free item",
      "feedType": "PartnerBenefit",
      "contentType": "Image",
      "status": "Expired",
      "publishDate": "2024-12-02T09:09:23.000Z",
      "expirationDate": "2024-12-03T09:09:23.000Z",
      "imageUrl": "https://uploadimageurl.com/190fab0906e943f69eac259ffe9537cd.jpeg",
      "topMessage": "Buy for 200 and receive a gift",
      "bottomMessage": "<p><strong>Details</strong></p>\n<p>Fresh offers a variety of different greens and vegetables. All products are ecological and picked out carefully. Every time you buy a Fresh product you will be rewarded with 15% extra bonus.</p>\n<p><strong></strong></p>\n<br /><p><strong>How to get the benefit</strong></p>\n<p>Use the code below</p>",
      "buttonText": "Go to website to apply code",
      "navigationType": "External",
      "externalUrl": "https://somethingsomethingsomething.com",
      "useWebWrapper": true,
      "isReadyToDistribute": true,
      "isSegmented": false,
      "segmentationType": "None",
      "authorId": "example.name@example.com",
      "authorName": "Example Name",
      "createdDate": "2024-10-11T11:29:25.007Z",
      "modifiedDate": "2024-10-11T11:29:43.847Z",
      "customProperties": {
        "logoUrl": "https://uploadimageurl.com/customer_logo.svg",
        "detailsImageUrl": "https://uploadimageurl.com/5d6458c53bba4b7c96c63f6f865911a8.jpg",
        "discountCode": {
          "code": "LOYALTYMEMBER24",
          "type": "Plain"
        },
        "terms": "<p><strong>Terms and conditions:</strong> Offer valid until the expiration date, in participating stores only. One redemption per customer. Cannot be combined with other offers.</p>",
        "announcedStartDate": null,
        "category": "education"
      },
      "disablingReasons": [],
      "priority": 3,
      "openedCount": 0,
      "requiresApproval": true
    }
    ```
  </Tab>
</Tabs>

## What Are Partner Benefits Banner Feeds?

Banner-style partner content optimized for prominent placement and visual impact. Designed for high-visibility promotional placements.

**Common Use Cases:**

* Featured partner promotions in banner carousels
* Time-sensitive partner offers requiring immediate attention
* Premium partner placements with enhanced visibility
* Hero banners for strategic partner campaigns

#### Examples of request and response bodies

<Tabs>
  <Tab title="Create Partner Benefit Feed Request Body">
    ```json theme={"system"}
    {
      "authorId": "example.name@example.com",
      "authorName": "Example Name",
      "campaignName": "Demo Partner Benefit Banner",
      "title": "Free item",
      "feedType": "PartnerBenefitBanner",
      "contentType": "Image",
      "analyticsIdentifier": null,
      "publishDate": "2026-10-31T14:15:24.949Z",
      "expirationDate": "2026-11-05T14:15:24.949Z",
      "imageUrl": "https://uploadimageurl.com/190fab0906e943f69eac259ffe9537cd.jpeg",
      "topMessage": "Buy for 200 and receive a gift",
      "bottomMessage": "<p><strong>Details</strong></p>\n<p>Fresh offers a variety of different greens and vegetables. All products are ecological and picked out carefully. Every time you buy a Fresh product you will be rewarded with 15% extra bonus.</p>\n<p><strong></strong></p>\n<br /><p><strong>How to get the benefit</strong></p>\n<p>Use the code below</p>",
      "buttonText": "Go to website to apply code",
      "navigationType": "External",
      "externalUrl": "https://somethingsomethingsomething.com",
      "useWebWrapper": true,
      "isReadyToDistribute": true,
      "segmentationType": "None",
      "customProperties": {
        "logoUrl": "https://uploadimageurl.com/customer_logo.svg",
        "detailsImageUrl": "https://uploadimageurl.com/5d6458c53bba4b7c96c63f6f865911a8.jpg",
        "discountCode": {
          "code": "LOYALTYMEMBER24",
          "type": "Plain"
        },
        "terms": "<p><strong>Terms and conditions:</strong> Offer valid until the expiration date, in participating stores only. One redemption per customer. Cannot be combined with other offers.</p>",
        "announcedStartDate": "2026-10-25T07:20:26.431Z",
        "category": "education"
      },
      "priority": null,
      "requiresApproval": null
    }
    ```
  </Tab>

  <Tab title="GET Partner Benefit Banner Feed Response">
    ```json theme={"system"}
    {
      "id": 2778,
      "campaignName": "Demo banner feed",
      "title": "Free item",
      "feedType": "PartnerBenefitBanner",
      "contentType": "Image",
      "status": "Expired",
      "analyticsIdentifier": "987",
      "publishDate": "2024-10-02T09:09:23.000Z",
      "expirationDate": "2025-01-01T00:00:00.000Z",
      "imageUrl": "https://uploadimageurl.com/190fab0906e943f69eac259ffe9537cd.jpeg",
      "topMessage": "Buy for 200 and receive a gift",
      "bottomMessage": "<p><strong>Details</strong></p>\n<p>Fresh offers a variety of different greens and vegetables. All products are ecological and picked out carefully. Every time you buy a Fresh product you will be rewarded with 15% extra bonus.</p>\n<p><strong></strong></p>\n<br /><p><strong>How to get the benefit</strong></p>\n<p>Use the code below</p>",
      "buttonText": "Go to website to apply code",
      "navigationType": "External",
      "externalUrl": "https://somethingsomethingsomething.com",
      "useWebWrapper": true,
      "deepLinkId": "123",
      "deepLinkParameters": {},
      "deepLinkUrl": "https://deeplink.your-environment.lobyco.net/home",
      "isReadyToDistribute": true,
      "isSegmented": false,
      "segmentationType": "None",
      "authorId": "example.name@example.com",
      "authorName": "Example Name",
      "createdDate": "2024-10-15T08:16:00.580Z",
      "modifiedDate": "2024-10-15T08:16:00.580Z",
      "externalId": "123",
      "isBoardContent": false,
      "customProperties": {
        "logoUrl": "https://uploadimageurl.com/customer_logo.svg",
        "detailsImageUrl": "https://uploadimageurl.com/5d6458c53bba4b7c96c63f6f865911a8.jpg",
        "discountCode": {
          "code": "LOYALTYMEMBER24",
          "type": "Plain"
        },
        "terms": "<p><strong>Terms and conditions:</strong> Offer valid until the expiration date, in participating stores only. One redemption per customer. Cannot be combined with other offers.</p>",
        "announcedStartDate": "2024-11-04T07:20:26.431Z",
        "category": "education"
      },
      "priority": 3,
      "openedCount": 0,
      "requiresApproval": true
    }
    ```
  </Tab>
</Tabs>