{
"title": "Annual General Meeting",
"start_date_time": "2026-10-01T10:00:00Z",
"end_date_time": "2026-10-01T12:00:00Z",
"venue": "Main Hall",
"timezone": "Africa/Lagos",
"should_notify": true
}
{
"status": "success",
"data": {
"id": 11,
"chapter_id": 9,
"title": "Annual General Meeting",
"description": "Yearly review",
"venue": "Main Hall",
"meeting_link": null,
"document_link": null,
"event_image": null,
"start_date_time": "2026-10-01T10:00:00Z",
"end_date_time": "2026-10-01T12:00:00Z",
"recurrence_end_date_time": null,
"timezone": "Africa/Lagos",
"all_participant": true,
"record_meeting": false,
"waiting_room_enabled": true,
"meeting_provider_type": null,
"createddate": "2026-09-14T08:00:00Z",
"lastmodifieddate": null
}
}
Events
Create Event
Create an event.
POST
/
v1
/
events
{
"title": "Annual General Meeting",
"start_date_time": "2026-10-01T10:00:00Z",
"end_date_time": "2026-10-01T12:00:00Z",
"venue": "Main Hall",
"timezone": "Africa/Lagos",
"should_notify": true
}
{
"status": "success",
"data": {
"id": 11,
"chapter_id": 9,
"title": "Annual General Meeting",
"description": "Yearly review",
"venue": "Main Hall",
"meeting_link": null,
"document_link": null,
"event_image": null,
"start_date_time": "2026-10-01T10:00:00Z",
"end_date_time": "2026-10-01T12:00:00Z",
"recurrence_end_date_time": null,
"timezone": "Africa/Lagos",
"all_participant": true,
"record_meeting": false,
"waiting_room_enabled": true,
"meeting_provider_type": null,
"createddate": "2026-09-14T08:00:00Z",
"lastmodifieddate": null
}
}
Create an event. By default every chapter member is invited (
Sending anything else returns
all_participant: true) and invitations are sent (should_notify: true) exactly as if the key’s owner had created the event in the app.
Required scope: events:write
In person, Transparency Hub video conference, or Zoom?
meeting_provider_type decides how the event is held:
| Value | Meaning |
|---|---|
omitted / null | In person — put the address in venue. |
transparencyhub | Transparency Hub video conference — a room is created for you; members join from the app. Set record_meeting to true if it should be recorded. |
zoom, teams, google_meet | External meeting — put the invite address in meeting_link (required for these). |
400, and the reply lists the values it accepts.
{
"title": "Annual General Meeting",
"start_date_time": "2026-10-01T10:00:00Z",
"end_date_time": "2026-10-01T12:00:00Z",
"venue": "Main Hall",
"timezone": "Africa/Lagos",
"should_notify": true
}
{
"status": "success",
"data": {
"id": 11,
"chapter_id": 9,
"title": "Annual General Meeting",
"description": "Yearly review",
"venue": "Main Hall",
"meeting_link": null,
"document_link": null,
"event_image": null,
"start_date_time": "2026-10-01T10:00:00Z",
"end_date_time": "2026-10-01T12:00:00Z",
"recurrence_end_date_time": null,
"timezone": "Africa/Lagos",
"all_participant": true,
"record_meeting": false,
"waiting_room_enabled": true,
"meeting_provider_type": null,
"createddate": "2026-09-14T08:00:00Z",
"lastmodifieddate": null
}
}
Authorizations
ApiKeyAuthBearerAuth
Body
application/json
How the event is held. Omit for an in-person event (use venue). transparencyhub provisions a Transparency Hub video conference. zoom / teams / google_meet need the invite in meeting_link.
Available options:
transparencyhub, zoom, teams, google_meet