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

# Create Raffle

> This endpoint is used to create a raffle

export const EcosystemURLBlock = ({content = [], title = ""}) => {
  return <div style={{
    backgroundColor: "#6B3B900A",
    borderRadius: "8px",
    borderColor: "#F8F8F8"
  }} className="flex flex-col gap-4 border p-6">
      {title && <p className="font-bold text-2xl" style={{
    color: "#1C1C1C",
    marginBlock: "0px"
  }}>
          {title || ""}
        </p>}

      {content.length > 0 && content?.map((el, id) => <div key={id} className="flex flex-col [&>*]:my-0 gap-2">
            <div className="flex items-center justify-between [&>*]:my-0" style={{
    height: "fit-content"
  }}>
              <span className="font-bold" style={{
    color: "#1C1C1CCC",
    marginBlock: "0px"
  }}>
                {el.title}
              </span>
              <svg width="16" height="16" viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg" onClick={async () => {
    await navigator.clipboard.writeText(el.caption);
    alert("Link copied!");
  }}>
                <path d="M6 10C6 8.1144 6 7.1716 6.58579 6.58579C7.1716 6 8.1144 6 10 6H10.6667C12.5523 6 13.4951 6 14.0809 6.58579C14.6667 7.1716 14.6667 8.1144 14.6667 10V10.6667C14.6667 12.5523 14.6667 13.4951 14.0809 14.0809C13.4951 14.6667 12.5523 14.6667 10.6667 14.6667H10C8.1144 14.6667 7.1716 14.6667 6.58579 14.0809C6 13.4951 6 12.5523 6 10.6667V10Z" stroke="#191B1F" stroke-opacity="0.6" stroke-linecap="round" stroke-linejoin="round" />
                <path d="M11.3334 6.00016C11.3318 4.02877 11.302 3.00764 10.7282 2.30845C10.6174 2.17342 10.4936 2.04962 10.3586 1.9388C9.62096 1.3335 8.52516 1.3335 6.3335 1.3335C4.14184 1.3335 3.04602 1.3335 2.30845 1.9388C2.17342 2.04961 2.04962 2.17342 1.9388 2.30845C1.3335 3.04602 1.3335 4.14184 1.3335 6.3335C1.3335 8.52516 1.3335 9.62096 1.9388 10.3586C2.04961 10.4936 2.17342 10.6174 2.30845 10.7282C3.00764 11.302 4.02877 11.3318 6.00016 11.3334" stroke="#191B1F" stroke-opacity="0.6" stroke-linecap="round" stroke-linejoin="round" />
              </svg>
            </div>
            <p className="font-medium text-sm border-none" style={{
    color: el.color || "#1C1C1CCC"
  }}>
              {el.caption}
            </p>
          </div>)}
    </div>;
};

export const Table = ({data = []}) => <div className="text-sm font-mono">
    <div style={{
  gap: 10,
  display: "grid",
  padding: "5px 10px",
  backgroundColor: "#F7F9FB",
  color: "rgba(25,27,31,0.6)",
  gridTemplateColumns: "repeat(3, minmax(0, 1fr))"
}}>
      <span>name</span>
      <span>type</span>
      <span>Description</span>
    </div>
    {data?.map((item, idx) => <div key={idx} style={{
  gap: 10,
  display: "grid",
  padding: "8px 10px",
  color: "rgba(25,27,31,0.8)",
  gridTemplateColumns: "repeat(3, minmax(0, 1fr))"
}}>
        <span className="break-words">{item.name}</span>
        <span>{item.type}</span>
        <span>{item.desc}</span>
      </div>)}
  </div>;

export const NoteStatement = ({label, message}) => <div className="relative text-sm" style={{
  borderRadius: 16,
  padding: "1px 20px",
  backgroundColor: "rgba(252,155,28,.06)"
}}>
    <p style={{
  marginBlock: 0
}}>
      {label && <span>
          <span className="font-bold" style={{
  color: "#fc9b1c"
}}>
            {label || "PS"}
          </span>
          {message && `: `}
        </span>}
      {message}
    </p>
    <div className="absolute left-0 top-1/2 -translate-y-1/2 rounded-e-full" style={{
  width: 2,
  height: 35,
  backgroundColor: "#fc9b1c"
}} />
  </div>;

####

<EcosystemURLBlock
  content={[
{
  title: "URL",
  caption: "https://test-api.bvndle.com/api/v1/laas/raffles",
  color: "#6B3B90",
},
{
  title: "Base URL",
  caption: "https://test-api.bvndle.com/api/v1/laas",
  color: "#6B3B90",
},
{
  title: "HTTP Method",
  caption: "POST",
},
{
  title: "Authorization Header",
  caption: "Bearer ACCESS_TOKEN",
},
]}
/>

###

<NoteStatement label="Request Body" />

<Table
  data={[
{
  name: "prizes",
  type: "array",
  desc: <>Required</>,
},
{
  name: "prizes.coin",
  type: "number",
  desc: (
    <>
      Required <br />
      The amount that should be rewarded
    </>
  ),
},
{
  name: "prizes.timeline",
  type: "number",
  desc: (
    <>
      Required <br />
      Values: daily, weekly, monthly
    </>
  ),
},
{
  name: "startDate",
  type: "date",
  desc: (
    <>
      Required <br />
      When the raffle is expected to start
    </>
  ),
},
{
  name: "endDate",
  type: "date",
  desc: (
    <>
      Required <br />
      When the raffle is expected to end
    </>
  ),
},
{
  name: "entryFees",
  type: "array",
  desc: <>Required</>,
},
{
  name: "entryFees.type",
  type: "string",
  desc: (
    <>
      Required <br />
      The mode of payment
    </>
  ),
},
{
  name: "entryFees.fees",
  type: "number",
  desc: (
    <>
      Required <br />
      The amount to be debited from the user
    </>
  ),
},
{
  name: "transactionPin",
  type: "string",
  desc: (
    <>
      Required <br />
      The transaction PIN that was created by the partner
    </>
  ),
},
]}
/>

###

```bash cURL theme={null}
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"
}

```

####

<ResponseExample>
  ```json Success theme={null}
  {
    "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": "iheonu6@gmail.com",
        "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
    }
  }
  ```
</ResponseExample>