Create Contest

POST

https://stageapi.partake.ng/api/v2/merchants/me/contests

Last modified:2026-07-10 13:15:30

Maintainer:Not configured

Creates a new contest for the authenticated merchant. Paid contests require costPerVote. Merchant only.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Header Params

Body Params application/json

Examples

Responses

🟢201

application/json

Bodyapplication/json

🟠400

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://stageapi.partake.ng/api/v2/merchants/me/contests' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
  "title": "Miss iVoteNg 2026",
  "description": "Annual national beauty and talent pageant.",
  "startDate": "2026-05-01T00:00:00.000Z",
  "endDate": "2026-06-01T00:00:00.000Z",
  "prizeDetails": "₦500,000 cash prize + crown",
  "votingType": "paid",
  "costPerVote": 100,
  "bannerImageUrl": "https://cdn.example.com/banners/miss-ivoteng-2026.jpg"
}

// Notes:
// - description: optional
// - prizeDetails: optional
// - costPerVote: required when votingType is "paid", optional otherwise
// - bannerImageUrl: optional'

Response Example

201 - 201 Created

{
  "success": true,
  "data": {
    "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
    "title": "Miss iVoteNg 2026",
    "status": "draft",
    "votingType": "paid",
    "costPerVote": 100,
    "startDate": "2026-05-01T00:00:00.000Z",
    "endDate": "2026-06-01T00:00:00.000Z",
    "createdAt": "2026-04-29T10:00:00.000Z"
  },
  "message": "Contest created successfully"
}

Modified at 2026-07-10 13:15:30

List My Contests

Get Contest