Events
Request a meeting
POST
/events/:eventId/meetingsRequest a meeting with another participant of the event. A direct chat room is created if one does not already exist, and the message body is posted as the first message. The meeting starts in the REQUESTED status with no spot or time set.
| Auth | Login required |
|---|
Path parameters
eventIdstringrequiredEvent ID.
Request body
toUserIdstringrequiredUser ID of the person to request a meeting with.
messagestringrequiredBody of the first message.
Notes
Returns 400 (errorCode 40001) when the event's enabledMeetings is false. Requesting yourself returns 40002, either party not being registered returns 40003 / 40004, and a recipient who has opted out returns 40015.
A meeting with the same person cannot be requested twice, even if the previous one was canceled or rejected (errorCode 40005). Reaching the per-event request limit returns 40014.
Response
| Field | Type | Description |
|---|---|---|
meeting | Meeting | The created meeting, including event / chatRoom / fromUser / toUser / spot. |
Request
curl https://api.4s.link/events/EVENT_ID/meetings \-X POST \-H "Authorization: Bearer 4s_at_..." \-H "Content-Type: application/json" \-d '{"toUserId": "u9f8e7d6-...","message": "お話しさせていただけませんか?"}'
Example response
{"meeting": {"id": "mt1a2b3c-...","eventId": "ev1a2b3c-...","chatRoomId": "cr1a2b3c-...","fromUserId": "u1a2b3c4-...","toUserId": "u9f8e7d6-...","status": "REQUESTED","spotId": null,"startAt": null,"endAt": null,"createdAt": "2026-06-01T09:00:00.000Z"}}