Skip to content
Capturit Backend Docs

Create an Event

POST api/event/create

This is used to create a new event.

Example Request

Terminal window
curl -X 'GET' \
  'http://localhost:8080/api/event/create' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -F "event_name=<event_name>" \
  -F "event_cover_file=<file_path>" \
  -F "event_location=<location>" \
  -F "event_location_longitude=<longitude>" \
  -F "event_location_latitude=<latitude>" \
  -F "event_start=<utc_date_string>" \
  -F "event_end=<utc_date_string>" \
  -F "event_details=<details>" \
  -F "event_photos_per_guest=<count>" \
  -F "event_media_reveal=<number>" \
  -F "event_media_reveal_at=<utc_date_string>" \
  -F "event_visibility=<number>" \
  -F "event_guests[0]=<user_id>" \
  -F "event_setting_join_approval=<boolean>"

Request Body

Content Type: application/json
Content: Create Event

{
  "event_name": "string",
  "event_cover_file": "string",
  "event_location": "string",
  "event_location_longitude": "string",
  "event_location_latitude": "string",
  "event_start": "2025-01-01T05:14:05.801Z",
  "event_end": "2025-01-01T05:14:05.801Z",
  "event_details": "string",
  "event_photos_per_guest": 1,
  "event_media_reveal": 3,
  "event_media_reveal_at": "2025-01-01T05:14:05.801Z",
  "event_visibility": 0,
  "event_guests": [
    0
  ],
  "event_setting_join_approval": true
}

Responses

200 - OK

The request was successful

Content Type: application/json
Content: Event Resource

{
  "id": 0,
  "event_name": "string",
  "event_cover_url": "string",
  "event_cover_preview_url": "string",
  "event_location": "string",
  "event_location_longitude": "string",
  "event_location_latitude": "string",
  "event_start": "2024-12-18T10:52:00.510Z",
  "event_end": "2024-12-18T10:52:00.510Z",
  "event_details": "string",
  "event_photos_per_guest": 0,
  "event_media_reveal": 0,
  "event_media_reveal_at": "2024-12-18T10:52:00.510Z",
  "event_status": 0,
  "event_visibility": 0,
  "event_likes_count": 0,
  "event_highlight": true,
  "event_archived": true,
  "event_deleted_on": "2024-12-18T10:52:00.510Z",
  "event_joined": 0,
  "event_liked": true,
  "event_group_chat_id": 0,
  "event_interested_count": 0,
  "event_going_count": 0,
  "event_settings": {
    "event_setting_join_approval": true
  },
  "event_organizer": {
    "id": 0,
    "user_first_name": "string",
    "user_last_name": "string",
    "user_username": "string",
    "user_avatar_url": "string",
    "user_visible": "string"
  },
  "created_at": "2024-12-18T10:52:00.510Z",
  "updated_at": "2024-12-18T10:52:00.510Z"
}

400 - Bad Request

Validation Error

Content Type: application/json
Content:

{
  "param_name": [
    "string"
  ],
  "param_name_2": [
    "string"
  ]
}

401 - Unauthorized

The request requires valid bearer token, but none were provided, or the bearer token is invalid.

429 - Too Many Requests

The user has exceeded the rate limit of 20 requests per minute.

500 - Internal Server Error

There is an issue with the backend. Sentry will provide a more detailed report on the problem.