Skip to content
Core API
Esc
↑↓navigate↵open⌘Jpreview
On this page

Meetings

Create and update meetings with complete curl request examples.

Build a request

Example data only. No request is sent.

POST
Choose the destination IDs
Start with these fields

Requester must belong to the event. Under a sponsor restriction, the requester must represent an allowed sponsor.

Receiver must belong to the event.

PATCH can move a draft meeting; accepted meetings are not rescheduled by this mutation.

On POST, notifications are sent only when true.

On POST, true creates a draft; otherwise the meeting is accepted.

Add optional fields (7)

Additional participants. PATCH fully reconfigures only the additional participants, preserving requester and receiver.

Must belong to the event. null clears the location. Changing it frees the assigned meeting point.

Creation/status message; also used as the cancellation message.

Participant-specific message.

Participant-specific message.

Other supplied values do not expose another transition.

Selects or changes a reserved meeting point when available.

Use the API address and token from your environment. Set up authentication.

curl --fail-with-body --silent --show-error --globoff --max-time 30 --request POST \
  --url "${BRELLA_API_BASE_URL}"'/api/core/organizations/123/events/456/meetings' \
  --header "Accept: application/vnd.brella.v4+json" \
  --header "Brella-API-Access-Token: ${BRELLA_API_ACCESS_TOKEN}" \
  --header "Content-Type: application/json" \
  --data-raw '{
  "requester_registrant_id": 1201,
  "receiver_registrant_id": 1202,
  "timeslot_id": 5501,
  "draft": true,
  "send_individual_notifications": false
}'
201 CreatedIllustrative response
{
  "data": {
    "id": "1201",
    "type": "meeting"
  }
}

The token scope determines returned fields. This selector illustrates that configuration; it does not change your token or the request.

Collection path: events/{event_id}/meetings

POST a meeting

View the complete cURL example
curl --fail-with-body --silent --show-error --globoff --max-time 30 --request POST \
  --url "${BRELLA_API_BASE_URL}"'/api/core/organizations/123/events/456/meetings' \
  --header "Accept: application/vnd.brella.v4+json" \
  --header "Brella-API-Access-Token: ${BRELLA_API_ACCESS_TOKEN}" \
  --header "Content-Type: application/json" \
  --data-raw '{
  "requester_registrant_id": 1201,
  "receiver_registrant_id": 1202,
  "additional_registrant_ids": [
    1203
  ],
  "timeslot_id": 5501,
  "location_id": 88,
  "message": "Let us discuss distribution",
  "requester_message": "I would like to discuss the Nordic market",
  "receiver_message": "Please bring your channel overview",
  "send_individual_notifications": false,
  "draft": true,
  "preferred_table_index": 4
}'

The response type is meeting. Useful write-response fields include timeslot_id, location_id, status (returned as current-status), message, admin_panel_created, and updated_at.

PATCH a meeting

This example changes a draft meeting’s timeslot and preferred point and replaces its additional participants.

View the complete cURL example
curl --fail-with-body --silent --show-error --globoff --max-time 30 --request PATCH \
  --url "${BRELLA_API_BASE_URL}"'/api/core/organizations/123/events/456/meetings/6001' \
  --header "Accept: application/vnd.brella.v4+json" \
  --header "Brella-API-Access-Token: ${BRELLA_API_ACCESS_TOKEN}" \
  --header "Content-Type: application/json" \
  --data-raw '{
  "timeslot_id": 5502,
  "preferred_table_index": 6,
  "additional_registrant_ids": [
    1203,
    1204
  ],
  "message": "Moved to the later slot"
}'

Cancellation is a separate PATCH shape:

View the complete cURL example
curl --fail-with-body --silent --show-error --globoff --max-time 30 --request PATCH \
  --url "${BRELLA_API_BASE_URL}"'/api/core/organizations/123/events/456/meetings/6001' \
  --header "Accept: application/vnd.brella.v4+json" \
  --header "Brella-API-Access-Token: ${BRELLA_API_ACCESS_TOKEN}" \
  --header "Content-Type: application/json" \
  --data-raw '{
  "status": "cancelled",
  "message": "Cancelled by the event organizer"
}'

When status is cancelled, the cancellation branch handles the request; sibling scheduling and participant changes should be sent in a separate request before cancellation if needed.

Input reference

12 inputs. Expand a field for its request type and update behavior. These are the example request keys; your administrator can configure aliases.

requester_registrant_idScalar ID
POST
Required
PATCH
Ignored

Requester must belong to the event. Under a sponsor restriction, the requester must represent an allowed sponsor.

receiver_registrant_idScalar ID
POST
Required
PATCH
Ignored

Receiver must belong to the event.

additional_registrant_idsArray of scalar IDs
POST
Optional
PATCH
Optional

Additional participants. PATCH fully reconfigures only the additional participants, preserving requester and receiver.

timeslot_idScalar ID
POST
Required for the scheduled meeting create path
PATCH
Optional for draft meetings

PATCH can move a draft meeting; accepted meetings are not rescheduled by this mutation.

location_idScalar ID or `null`
POST
Optional
PATCH
Optional

Must belong to the event. null clears the location. Changing it frees the assigned meeting point.

messageScalar string or `null`
POST
Optional
PATCH
Optional

Creation/status message; also used as the cancellation message.

requester_messageScalar string or `null`
POST
Optional
PATCH
Optional

Participant-specific message.

receiver_messageScalar string or `null`
POST
Optional
PATCH
Optional

Participant-specific message.

send_individual_notificationsJSON boolean
POST
Optional
PATCH
Ignored

On POST, notifications are sent only when true.

draftJSON boolean
POST
Optional
PATCH
Ignored

On POST, true creates a draft; otherwise the meeting is accepted.

statusScalar string
POST
Ignored
PATCH
`cancelled` only

Other supplied values do not expose another transition.

preferred_table_indexScalar number or `null`
POST
Optional
PATCH
Optional for draft meetings

Selects or changes a reserved meeting point when available.

Last updated on August 25, 2026