Challenge events - Lobyco Help center

Lobyco publishes a challenge event when a challenge definition changes. These events describe the challenge itself, not a customer, so they carry no CustomerId.

Payload fields keep the Activity prefix, as in ActivityId, ActivityName and ActivityDrawType. The rename to Challenge applies to the event names only, not to the payload contract.

Field reference

Field definitions match the challenge models of the Challenges endpoints.

Event
Challenge Created
Challenge Updated
Challenge Published
Challenge Stopped
Challenge Deleted

Schemas

Challenge Created
Challenge Updated
Challenge Published
Challenge Stopped
Challenge Deleted

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "$defs": {
    "Reward": {
      "type": ["object", "null"],
      "properties": {
        "Id": { "type": ["string", "null"] },
        "OfferId": { "type": ["string", "null"] },
        "Title": { "type": ["string", "null"] },
        "TotalRewards": { "type": ["integer", "null"] },
        "BonusAmount": { "type": ["number", "null"] },
        "RewardType": { "type": "string", "enum": ["Coupon", "Bonus", "Custom", "LotteryTicket", "Multiple"] },
        "Tier": { "type": "integer" }
      }
    },
    "ProgressRule": {
      "type": ["object", "null"],
      "properties": {
        "Id": { "type": "integer" },
        "ProgressCalculationType": { "type": "string", "enum": ["ProductCount", "PurchaseAmount", "StoreVisit", "PaymentMethod"] },
        "UnitOfMeasure": { "type": ["string", "null"], "enum": ["Item", "Litre", "Gram", "Kilogram", null] },
        "ApplicationType": { "type": "string", "enum": ["Include", "Exclude"] },
        "RequiredProgress": { "type": ["number", "null"] },
        "MinimumPurchaseAmount": { "type": ["number", "null"] },
        "CooldownHours": { "type": ["integer", "null"] },
        "PaymentTypes": { "type": ["array", "null"], "items": { "type": "string" } },
        "Tier": { "type": "integer" },
        "RuleIndex": { "type": "integer" },
        "HasAffiliationFilter": { "type": "boolean" }
      }
    }
  },
  "properties": {
    "UnifiedCampaignId": { "type": ["string", "null"] },
    "ActivityId": { "type": "string" },
    "ActivityName": { "type": "string" },
    "HideInList": { "type": "boolean" },
    "StartDate": { "type": "string", "format": "date-time" },
    "EndDate": { "type": "string", "format": "date-time" },
    "ActivationLimit": { "type": ["integer", "null"] },
    "PickUpEndDate": { "type": ["string", "null"], "format": "date-time" },
    "DaysForPickup": { "type": ["integer", "null"] },
    "Status": { "type": "string", "enum": ["Draft", "Published"] },
    "AdminName": { "type": ["string", "null"] },
    "AdminId": { "type": ["string", "null"] },
    "AccrualValue": { "type": ["number", "null"] },
    "AudienceIds": { "type": ["array", "null"], "items": { "type": "string" } },
    "IsSinglePurchase": { "type": "boolean" },
    "ChainIds": { "type": ["array", "null"], "items": { "type": "string" } },
    "StoreIds": { "type": ["array", "null"], "items": { "type": "string" } },
    "Rewards": { "type": ["array", "null"], "items": { "$ref": "#/$defs/Reward" } },
    "ProgressRules": { "type": ["array", "null"], "items": { "$ref": "#/$defs/ProgressRule" } },
    "ActivationMode": { "type": "string", "enum": ["Manual", "Automatic"] },
    "ProductFileUrl": { "type": "string" },
    "CategoryFileUrl": { "type": "string" },
    "IsTemplate": { "type": "boolean" },
    "DrawType": { "type": "string", "enum": ["Instant", "GlobalLottery", "StoreLottery"] },
    "TimeUnit": { "type": "string", "enum": ["None", "Hour", "Day", "Week", "Month", "Year"] },
    "TimeUnitBetweenCardsIssued": { "type": ["integer", "null"] },
    "ValidForDays": { "type": ["integer", "null"] },
    "SegmentationType": { "type": "string", "enum": ["Standard", "Triggered"] },
    "DiscountFilterType": { "type": "string", "enum": ["IncludeAll", "ExcludeAll", "RecalculateBasedOnPrice"] },
    "FundedBy": { "type": ["string", "null"] },
    "IssueStoreCoupon": { "type": "boolean" },
    "CheckoutTypes": { "type": ["array", "null"], "items": { "type": "string", "enum": ["Pos", "SelfCheckout", "ScanAndPay", "Online"] } },
    "Tags": { "type": ["array", "null"], "items": { "type": "string" } },
    "EventId": { "type": "string" }
  }
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "$defs": {
    "Reward": {
      "type": ["object", "null"],
      "properties": {
        "Id": { "type": ["string", "null"] },
        "OfferId": { "type": ["string", "null"] },
        "Title": { "type": ["string", "null"] },
        "TotalRewards": { "type": ["integer", "null"] },
        "BonusAmount": { "type": ["number", "null"] },
        "RewardType": { "type": "string", "enum": ["Coupon", "Bonus", "Custom", "LotteryTicket", "Multiple"] },
        "Tier": { "type": "integer" }
      }
    },
    "ProgressRule": {
      "type": ["object", "null"],
      "properties": {
        "Id": { "type": "integer" },
        "ProgressCalculationType": { "type": "string", "enum": ["ProductCount", "PurchaseAmount", "StoreVisit", "PaymentMethod"] },
        "UnitOfMeasure": { "type": ["string", "null"], "enum": ["Item", "Litre", "Gram", "Kilogram", null] },
        "ApplicationType": { "type": "string", "enum": ["Include", "Exclude"] },
        "RequiredProgress": { "type": ["number", "null"] },
        "MinimumPurchaseAmount": { "type": ["number", "null"] },
        "CooldownHours": { "type": ["integer", "null"] },
        "PaymentTypes": { "type": ["array", "null"], "items": { "type": "string" } },
        "Tier": { "type": "integer" },
        "RuleIndex": { "type": "integer" },
        "HasAffiliationFilter": { "type": "boolean" }
      }
    }
  },
  "properties": {
    "UnifiedCampaignId": { "type": ["string", "null"] },
    "ActivityId": { "type": "string" },
    "ActivityName": { "type": "string" },
    "HideInList": { "type": "boolean" },
    "StartDate": { "type": "string", "format": "date-time" },
    "EndDate": { "type": "string", "format": "date-time" },
    "ActivationLimit": { "type": ["integer", "null"] },
    "PickUpEndDate": { "type": ["string", "null"], "format": "date-time" },
    "DaysForPickup": { "type": ["integer", "null"] },
    "AccrualValue": { "type": ["number", "null"] },
    "AudienceIds": { "type": ["array", "null"], "items": { "type": "string" } },
    "IsSinglePurchase": { "type": "boolean" },
    "ChainIds": { "type": ["array", "null"], "items": { "type": "string" } },
    "StoreIds": { "type": ["array", "null"], "items": { "type": "string" } },
    "Rewards": { "type": ["array", "null"], "items": { "$ref": "#/$defs/Reward" } },
    "ProgressRules": { "type": ["array", "null"], "items": { "$ref": "#/$defs/ProgressRule" } },
    "ActivationMode": { "type": "string", "enum": ["Manual", "Automatic"] },
    "ProductFileUrl": { "type": "string" },
    "CategoryFileUrl": { "type": "string" },
    "IsTemplate": { "type": "boolean" },
    "ModifiedBy": { "type": ["string", "null"] },
    "DrawType": { "type": "string", "enum": ["Instant", "GlobalLottery", "StoreLottery"] },
    "TimeUnit": { "type": "string", "enum": ["None", "Hour", "Day", "Week", "Month", "Year"] },
    "TimeUnitBetweenCardsIssued": { "type": ["integer", "null"] },
    "ValidForDays": { "type": ["integer", "null"] },
    "SegmentationType": { "type": "string", "enum": ["Standard", "Triggered"] },
    "DiscountFilterType": { "type": "string", "enum": ["IncludeAll", "ExcludeAll", "RecalculateBasedOnPrice"] },
    "FundedBy": { "type": ["string", "null"] },
    "IssueStoreCoupon": { "type": "boolean" },
    "CheckoutTypes": { "type": ["array", "null"], "items": { "type": "string", "enum": ["Pos", "SelfCheckout", "ScanAndPay", "Online"] } },
    "Tags": { "type": ["array", "null"], "items": { "type": "string" } },
    "EventId": { "type": "string" }
  }
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "ActivityId": { "type": "string" },
    "PublishedAt": { "type": "string", "format": "date-time" },
    "PublishedBy": { "type": ["string", "null"] },
    "EventId": { "type": "string" }
  }
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "ActivityId": { "type": "string" },
    "StoppedBy": { "type": ["string", "null"] },
    "EventId": { "type": "string" }
  }
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "ActivityId": { "type": "string" },
    "DeletedBy": { "type": ["string", "null"] },
    "EventId": { "type": "string" }
  }
}

API reference

Endpoint documentation: Challenges.

Card events — a customer’s progress on the challenge.
OutboundAPI connection — how these events reach an endpoint in your system.

Last modified on October 9, 2026