Create Event

Create a new event for your application to enable check-in functionality.

Endpoint

POST /api/events

Headers

X-API-Key: your-api-key
Content-Type: application/json

Request

{
  "eventId": "event-123",
  "accessPoint": "https://your-app.com/api/event-access",
  "requestVerifier": "verifier-token-123"
}

Field	Type	Required	Description
eventId	string	Yes	Unique identifier for the event in your system
accessPoint	string	Yes	URL endpoint that returns an array of email addresses for event attendees
requestVerifier	string	Yes	Token used to verify requests to the access point

Response

{
  "status": true,
  "message": "Event created successfully",
  "data": {
    "externalEventId": "event-123",
    "checkInCode": "evt_a1b2c3d4e5f6789012345678901234ab",
    "accessPoint": "https://your-app.com/api/event-access",
    "application": "app_1234567890abcdef",
    "createdAt": "2024-01-15T10:30:00.000Z"
  }
}

Response Fields

Field	Type	Description
externalEventId	string	The event ID you provided (same as eventId in request)
checkInCode	string	Unique check-in code for this event (format: evt_ + 32 hex chars)
accessPoint	string	The access point URL you provided
application	string	Application ID associated with your API key
createdAt	string	Event creation timestamp

Errors

Status	Message
400	Validation failed / Invalid URL format
401	Invalid API key / Application not found
409	Event with this external event ID already exists for this application

Example

curl -X POST "https://api.reeng.xyz/api/events" \
  -H "X-API-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "eventId": "event-123",
    "accessPoint": "https://your-app.com/api/event-access",
    "requestVerifier": "verifier-token-123"
  }'

Notes

• The eventId must be unique within your application scope
• The accessPoint URL must be a valid URL and should return an array of email addresses when called with the requestVerifier as a query parameter
• The checkInCode is generated automatically and is used to initialize check-ins for this event
• Events are associated with the application linked to your API key