Event API Reference

Build powerful event experiences with our RESTful API. Create events, manage registrations, and track analytics programmatically.

Quick Start

1. Get your API key

Sign up for an API Platform account and get your unique API key from the dashboard.

2. Make your first request

Use your API key in the X-API-Key header to authenticate requests.

3. Start building

Create events, manage registrations, and integrate with your applications.

curl -X POST https://api.hackbytecodex.com/api-platform/events \
  -H "X-API-Key: hb_api_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "My Hackathon",
    "description": "An amazing event",
    "eventType": "HACKATHON",
    "mode": "online",
    "startDate": "2025-04-15T09:00:00Z",
    "endDate": "2025-04-17T18:00:00Z"
  }'

Try it yourself in seconds

See how simple it is to integrate with our API. Copy, paste, and start building.

Request
POST /api-platform/events
Content-Type: application/json
X-API-Key: hb_api_xxxxxxxxxxxx

{
  "title": "AI Hackathon 2025",
  "description": "Build the future with AI",
  "eventType": "HACKATHON",
  "mode": "hybrid",
  "startDate": "2025-04-15T09:00:00Z",
  "endDate": "2025-04-17T18:00:00Z",
  "location": "Bangalore, India",
  "registration": {
    "isOpen": true,
    "lastDate": "2025-04-10T23:59:59Z",
    "limit": 500
  }
}
Response
200 OK
{
  "success": true,
  "data": {
    "eventId": "evt_abc123xyz",
    "slug": "ai-hackathon-2025",
    "title": "AI Hackathon 2025",
    "status": "DRAFT",
    "createdAt": "2025-03-01T10:30:00Z"
  }
}

Authentication

API Key Authentication

For public endpoints like event registration, use your API key in the header:

X-API-Key: hb_api_your_key_here

Bearer Token Authentication

For platform management endpoints, use your JWT token:

Authorization: Bearer your_jwt_token

Base URL

https://api.hackbytecodex.com

All API requests should be made to this base URL. HTTPS is required for all requests.

Error Handling

400Bad Request

Invalid request payload or parameters

401Unauthorized

Missing or invalid authentication

403Forbidden

Insufficient permissions or plan limits exceeded

404Not Found

Resource not found

429Too Many Requests

Rate limit exceeded

500Internal Server Error

Something went wrong on our end

Webhooks

Webhooks allow you to receive real-time notifications when events occur in your account. Available on Pro and Enterprise plans.

Event Types

registration.createdregistration.cancelledpayment.receivedjudge.invitedscore.submittedevent.published

Ready to start building?

Get your API key and start creating amazing event experiences.