Skip to main content

POST /api/v1/events

Creates a new event with basic metadata. This endpoint creates the event shell only -- pools and markets must be added separately. For creating a complete event with pools and markets in one call, see Create Event Full.

Authentication

Required. User must have the Creator role.

Request

ParameterTypeInDescription
namestringbodyRequired. Event name in English
name_rustringbodyEvent name in Russian
tagsstring[]bodyArray of tag slugs (e.g. ["crypto", "ethereum"])
versus_namesstring[]bodyNames of the opposing sides (e.g. ["Team A", "Team B"])
versus_imagesstring[]bodyImage URLs for each side
has_drawboolbodyWhether the event supports a draw outcome

Example

curl -X POST "https://api.intotes.com/api/v1/events" \
-H "Authorization: Bearer <access_token>" \
-H "Content-Type: application/json" \
-d '{
"name": "Will SOL reach $300 by July?",
"name_ru": "SOL достигнет $300 к июлю?",
"tags": ["crypto", "solana"],
"versus_names": ["Yes", "No"],
"versus_images": [],
"has_draw": false
}'

Response

201 Created

{
"id": 3,
"name": "Will SOL reach $300 by July?",
"name_ru": "SOL достигнет $300 к июлю?",
"tags": ["crypto", "solana"],
"image_url": "",
"status": "new",
"is_active": false,
"created_at": "2026-04-04T09:00:00Z",
"versus_names": ["Yes", "No"],
"versus_images": [],
"has_draw": false,
"pools": []
}

403 Forbidden

{
"error": "insufficient permissions"
}