Skip to main content

POST /api/events

Creates a new event. The authenticated user is associated with the event through the organizerId field.
Requires a valid Bearer token. Allowed roles: USER, ADMIN, ORGANIZER.

Request body

categoryId
string
required
GUID of the category this event belongs to.
organizerId
string
ID of the user organizing the event. Typically resolved server-side from the authenticated token.
title
string
required
Title of the event.
description
string
required
Full description of the event.
ubication
string
required
Physical location or address where the event will take place.
date
string
required
Date and time of the event (ISO 8601 format).

Response fields

status
boolean
required
Indicates whether the request succeeded.
message
string
Human-readable result message.
data
object
required
The created event object. See Get event for the full field list.
curl --request POST \
  --url 'https://api.meetpoint.com/api/events' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "categoryId": "c1d2e3f4-0000-1111-2222-333344445555",
    "organizerId": "user-abc123",
    "title": "Summer Music Festival",
    "description": "An outdoor music festival featuring local artists.",
    "ubication": "Central Park, New York",
    "date": "2026-07-20T18:00:00Z"
  }'
{
  "status": true,
  "message": "Evento creado correctamente",
  "data": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "categoryId": "c1d2e3f4-0000-1111-2222-333344445555",
    "categoryName": "Music",
    "organizerId": "user-abc123",
    "organizerName": "Jane Doe",
    "organizerRating": 4.7,
    "organizerRatingsCount": 15,
    "title": "Summer Music Festival",
    "description": "An outdoor music festival featuring local artists.",
    "ubication": "Central Park, New York",
    "date": "2026-07-20T18:00:00Z",
    "publicationDate": "2026-03-22T09:15:00Z",
    "attendancesCount": 0,
    "commentsCount": 0,
    "attendances": [],
    "comments": []
  }
}

Build docs developers (and LLMs) love