{
  "status": "success",
  "message": "raffle created successfully",
  "data": {
    "id": "44d6fac7-01cc-4020-a02f-0e731062b1a8",
    "name": null,
    "durationInDays": null,
    "partner": {
      "id": "dcc1a639-906e-4393-84b7-689379fc4de8",
      "businessName": "Edited Business Name",
      "brandName": "bb",
      "businessType": {},
      "businessAddress": "Edited Business Address",
      "registrationNumber": null,
      "email": "[email protected]",
      "tag": null,
      "emailVerified": null,
      "emailCodeExpiresAt": null,
      "emailVerifiedAt": null,
      "referralCode": "be00659",
      "referred": null,
      "otpExpiresAt": null,
      "transactionPinCreated": true,
      "type": "partner",
      "status": "active",
      "image": null,
      "coverImage": null,
      "bvn": null,
      "incorporationDate": null,
      "dateJoined": "2025-02-11T11:13:45.810Z",
      "phone": "00000000000",
      "countryCode": null,
      "bankAccountCreated": false,
      "bvnValidated": false,
      "isDisabled": false,
      "priority": 3,
      "completedTour": false,
      "webhookURL": "http://editedwebhookaddress.com",
      "webhookAuthorizationToken": "Authozation Code",
      "shop": {},
      "addMultipleEmails": true,
      "partnerEmails": []
    },
    "prizes": [
      {
        "id": "a72fd79e-a77b-4001-bbf8-8de027695dbc",
        "raffle": {},
        "coin": 10,
        "timeline": "daily"
      },
      {
        "id": "a7e9d6e0-fa39-429e-a3a6-3a1961de8abd",
        "raffle": {},
        "coin": 50,
        "timeline": "weekly"
      },
      {
        "id": "9e4361ec-7609-4bb4-b8af-c80ecec85d1e",
        "raffle": {},
        "coin": 100,
        "timeline": "monthly"
      }
    ],
    "prize": 1,
    "coinAmount": 1,
    "isActive": true,
    "startDate": "2025-09-02T23:00:00.000Z",
    "isPaused": false
  }
}

​

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

​

Request Body:
nametypeDescription
prizesarrayRequired
prizes.coinnumberRequired
The amount that should be rewarded
prizes.timelinenumberRequired
Values: daily, weekly, monthly
startDatedateRequired
When the raffle is expected to start
endDatedateRequired
When the raffle is expected to end
entryFeesarrayRequired
entryFees.typestringRequired
The mode of payment
entryFees.feesnumberRequired
The amount to be debited from the user
transactionPinstringRequired
The transaction PIN that was created by the partner

​

cURL
curl --request POST
'https://test-api.bvndle.com/api/v1/laas/raffles' \
--header 'Content-Type: application/json' \

{
    "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
        }
    ],
    "transactionPin": "1234"
}

​

{
  "status": "success",
  "message": "raffle created successfully",
  "data": {
    "id": "44d6fac7-01cc-4020-a02f-0e731062b1a8",
    "name": null,
    "durationInDays": null,
    "partner": {
      "id": "dcc1a639-906e-4393-84b7-689379fc4de8",
      "businessName": "Edited Business Name",
      "brandName": "bb",
      "businessType": {},
      "businessAddress": "Edited Business Address",
      "registrationNumber": null,
      "email": "[email protected]",
      "tag": null,
      "emailVerified": null,
      "emailCodeExpiresAt": null,
      "emailVerifiedAt": null,
      "referralCode": "be00659",
      "referred": null,
      "otpExpiresAt": null,
      "transactionPinCreated": true,
      "type": "partner",
      "status": "active",
      "image": null,
      "coverImage": null,
      "bvn": null,
      "incorporationDate": null,
      "dateJoined": "2025-02-11T11:13:45.810Z",
      "phone": "00000000000",
      "countryCode": null,
      "bankAccountCreated": false,
      "bvnValidated": false,
      "isDisabled": false,
      "priority": 3,
      "completedTour": false,
      "webhookURL": "http://editedwebhookaddress.com",
      "webhookAuthorizationToken": "Authozation Code",
      "shop": {},
      "addMultipleEmails": true,
      "partnerEmails": []
    },
    "prizes": [
      {
        "id": "a72fd79e-a77b-4001-bbf8-8de027695dbc",
        "raffle": {},
        "coin": 10,
        "timeline": "daily"
      },
      {
        "id": "a7e9d6e0-fa39-429e-a3a6-3a1961de8abd",
        "raffle": {},
        "coin": 50,
        "timeline": "weekly"
      },
      {
        "id": "9e4361ec-7609-4bb4-b8af-c80ecec85d1e",
        "raffle": {},
        "coin": 100,
        "timeline": "monthly"
      }
    ],
    "prize": 1,
    "coinAmount": 1,
    "isActive": true,
    "startDate": "2025-09-02T23:00:00.000Z",
    "isPaused": false
  }
}