Skip to main content

​

URL
https://test-api.bvndle.com/api/v1/laas/special-campaigns
Base URL
https://test-api.bvndle.com/api/v1/laas
HTTP Method
POST
Authorization Header
Bearer ACCESS_TOKEN

​

Request Body:
nametypeDescription
namestringRequired
Name of the campaign
descriptionstringRequired
A short description of the camapaign
startDatedateRequired
Start date for the campaign
endDatedateRequired
The end date for the campaign
eventsarrayRequired
eventTypestringRequired
This is the event type
• mission
• raffle
• spin the wheel
mission.namestringOptional
This is the mission name
Only required when eventType is mission
mission.descriptionstringOptional
This is the mission description
Only required when eventType is mission
mission.pointsRewardnumberOptional
This is the number of points gotten for completing missions
Only required when eventType is mission
mission.startDatedateOptional
This is the start date of the mission
Only required when eventType is mission
mission.endDatedateOptional
The end date for the mission
Only required when eventType is mission
mission.badgeIddateOptional
This is the user's badgeId
Only required when eventType is mission
mission.requirementsstringRequired
These are the requirements for the mission to be passed
Only required when eventType is mission
eventType.rafflearrayOptional
raffle.startDatedateOptional
The start date for the raffle
Only required when eventType is raffle
raffle.endDatedateOptional
The end date for the raffle
Only required when eventType is raffle
raffle.prizesarrayOptional
This is the prize for the raffle
Only required when eventType is raffle
prizes.coinnumberOptional
This is the number of coins for each raffle win
Only required when eventType is raffle
prizes.timelinestringOptional
This is the timeline for the raffle
• daily
• weekly
• monthly
Only required when eventType is raffle
raffle.entryFeesarrayOptional
This is the fee to enter into the raffle
Only required when eventType is raffle
entryFees.typestringOptional
This is the type of the entry fee - either coin or airtime
Only required when eventType is raffle
entryFees.feenumberOptional
This is the amount needed to enter
Only required when eventType is raffle
eventType.spinWheelarrayOptional
Only required when eventType is spinWheel
spinWheel.maxSpinnumberOptional
The max number of spins per user
Only required when eventType is spinWheel
spinWheel.namestringOptional
The name of the spinWheel game
Only required when eventType is spinWheel
spinWheel.entryFeesarrayOptional
The max number of spins per user
Only required when eventType is spinWheel
entryFees.typestringOptional
This is the type of the entry fee - either coin or airtime
Only required when eventType is spinWheel
entryFees.feenumberOptional
This is the amount needed to enter
Only required when eventType is spinWheel

​

cURL
curl --request POST
'https://test-api.bvndle.com/api/v1/laas/special-campaigns' \


--data '{
    "name": "New Special campaign",
    "description": "Test special campaign",
    "startDate": "2025-09-03",
    "endDate": "2025-12-15",
    "events": [
        {
            "eventType": "mission",
            "mission": {
                "name": "1K Yearly data purchase",
                "description": "Recharge data daily",
                "pointsReward": 1,
                "startDate": "2025-09-06",
                "endDate": "2025-12-15",
                "transactionPin": "1234",
                "badgeId": "34d48345-18ab-4ba0-b9b7-07a7bf767666",
                "requirements": [
                    "Finish your airtime",
                    "Recharge a new batch of airtime"
                ]
            }
        }
        // {
        //     "eventType": "raffle",
        //     "raffle": {
        //         "startDate": "2025-09-03",
        //         "endDate": "2025-09-10",
        //         "prizes": [
        //             {
        //                 "coin": 10,
        //                 "timeline": "daily"
        //             },
        //             {
        //                 "coin": 50,
        //                 "timeline": "weekly"
        //             },
        //             {
        //                 "coin": 100,
        //                 "timeline": "monthly"
        //             }
        //         ],
        //         "entryFees": [
        //             {
        //                 "type": "coin",
        //                 "fee": 2
        //             },
        //             {
        //                 "type": "airtime",
        //                 "fee": 10
        //             }
        //         ]
        //     }
        // },
        // {
        //     "eventType": "spinWheel",
        //     "spinWheel": {
        //         "maxSpins": -1,
        //         "name": "Another spin wheel",
        //         "entryFees": [
        //             {
        //                 "fee": 5,
        //                 "type": "coins"
        //             },
        //             {
        //                 "fee": 200,
        //                 "type": "airtime"
        //             }
        //         ]
        //     }
        // }
    ]
}'

​

{
  "status": "success",
  "message": "special campaign created successfully",
  "data": {
    "id": "7bf6fbf0-94a1-4d13-94f8-bd5eb045309d",
    "name": "New Special campaign",
    "description": "Test special campaign",
    "startDate": "2025-09-03",
    "endDate": "2025-12-15",
    "status": "active",
    "events": [
      {
        "id": "b0a01dc3-9c1d-4d6e-ae2a-5743fa1e3497",
        "spinWheel": {},
        "mission": {
          "id": "51eaebe9-9c70-4285-97b8-364166db6f9c",
          "name": "1k yearly data purchase",
          "description": "Recharge data daily",
          "pointsReward": 1,
          "startDate": "2025-09-06",
          "endDate": "2025-12-15",
          "createdAt": "2025-10-16T08:54:08.036Z",
          "updatedAt": "2025-10-16T08:54:08.036Z",
          "partner": {},
          "requirements": [
            "Finish your airtime",
            "Recharge a new batch of airtime"
          ],
          "badge": {
            "id": "34d48345-18ab-4ba0-b9b7-07a7bf767666",
            "name": "shadow ninja",
            "description": "Hello",
            "partner": {},
            "icon": null
          }
        },
        "raffle": {},
        "eventType": "mission",
        "createdAt": "2025-10-16T08:54:08.047Z",
        "updatedAt": "2025-10-16T08:54:08.047Z"
      }
    ],
    "createdAt": "2025-10-16T08:54:07.997Z",
    "updatedAt": "2025-10-16T08:54:07.997Z"
  }
}