Skip to main content
POST
/
admin
/
v1
/
networks
/
{network_id}
/
events
Creates a new event in the network
curl --request POST \
  --url https://api.mn.co/admin/v1/networks/{network_id}/events \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "title": "Monthly Community Meetup",
  "description": "Join us for our monthly community meetup",
  "link": "https://zoom.us/j/123456789",
  "starts_at": "2025-01-15T14:00:00Z",
  "ends_at": "2025-01-15T16:00:00Z",
  "event_type": "online_meeting",
  "space_id": 123,
  "location": "San Francisco, CA",
  "time_zone": "America/Los_Angeles",
  "rsvp_enabled": true,
  "rsvp_closed": true,
  "restricted_event": true,
  "post_in_feed": true,
  "recurrence_rule": "FREQ=WEEKLY;INTERVAL=1"
}'
{
  "id": "1234",
  "created_at": "2025-11-07T23:17:21+00:00",
  "updated_at": "2025-11-07T23:17:21+00:00",
  "post_type": "event",
  "creator": {
    "id": "1234",
    "created_at": "2025-11-07T23:17:21+00:00",
    "updated_at": "2025-11-07T23:17:21+00:00",
    "name": "<string>",
    "email": "ada.lovelace@example.com",
    "short_bio": "<string>",
    "admin": true
  },
  "images": [
    "<string>"
  ],
  "permalink": "https://example.mn.co/posts/123",
  "title": "Monthly Community Meetup",
  "summary": "<string>",
  "recurrence_rule": "<string>",
  "rsvp_enabled": true,
  "rsvp_closed": true,
  "restricted_event": true,
  "post_in_feed": true,
  "event_type": "online_meeting",
  "starts_at": "2025-11-07T23:17:22+00:00",
  "ends_at": "2025-11-07T23:17:22+00:00",
  "time_zone": "<string>",
  "location": "<string>",
  "link": "<string>"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
network_id
required

The Network's unique integer ID, or subdomain Unique numeric network ID

Body

application/json

Submit results as JSON

Request body for creating or updating an event

​
title
string
required

The event title

Example:

"Monthly Community Meetup"

​
starts_at
string<date-time>
required

The date and time the event starts (ISO8601 format)

Example:

"2025-01-15T14:00:00Z"

​
ends_at
string<date-time>
required

The date and time the event ends (ISO8601 format)

Example:

"2025-01-15T16:00:00Z"

​
event_type
string
required

Type of event: 'online_meeting', 'local_meetup', etc.

Example:

"online_meeting"

​
space_id
integer
required

ID of the space where the event will be created

Example:

123

​
description
string

The event description

Example:

"Join us for our monthly community meetup"

​
link
string

External event link URL

Example:

"https://zoom.us/j/123456789"

​
location
string

Physical location of the event

Example:

"San Francisco, CA"

​
time_zone
string

IANA timezone identifier for the event

Example:

"America/Los_Angeles"

​
rsvp_enabled
boolean

Whether RSVPs are enabled (default: true)

Example:

true

​
rsvp_closed
boolean

Whether RSVPs are closed (default: false)

​
restricted_event
boolean

Whether event is restricted to specific members (default: false)

​
post_in_feed
boolean

Whether event appears in the activity feed (default: true)

Example:

true

​
recurrence_rule
string

RRULE format string for recurring events

Example:

"FREQ=WEEKLY;INTERVAL=1"

Response

Returns the created event

Events are scheduled gatherings that members can RSVP to

​
id
integer
required

The record's integer ID

Example:

"1234"

​
created_at
string<date-time>
required

The date and time the record was created

Example:

"2025-11-07T23:17:21+00:00"

​
updated_at
string<date-time>
required

The date and time the record was last modified

Example:

"2025-11-07T23:17:21+00:00"

​
post_type
string
required

The type of post - always 'event' for this endpoint

Example:

"event"

​
creator
object
required

The user who created the event

​
permalink
string
required

Full URL to view the event

Example:

"https://example.mn.co/posts/123"

​
title
string
required

The event title

Example:

"Monthly Community Meetup"

​
event_type
string
required

Type of event: 'online_meeting', 'local_meetup', 'zoom_meeting', 'zoom_webinar', etc.

Example:

"online_meeting"

​
images
string[]

Array of image URLs for the event

​
summary
string

A summary of the event description

​
recurrence_rule
string

RRULE format string for recurring events

​
rsvp_enabled
boolean

Whether RSVPs are enabled for this event

​
rsvp_closed
boolean

Whether RSVPs are closed

​
restricted_event
boolean

Whether this event is restricted to specific members

​
post_in_feed
boolean

Whether this event appears in the activity feed

​
starts_at
string<date-time>

The date and time the event starts (ISO8601 format in event's timezone)

Example:

"2025-11-07T23:17:22+00:00"

​
ends_at
string<date-time>

The date and time the event ends (ISO8601 format in event's timezone)

Example:

"2025-11-07T23:17:22+00:00"

​
time_zone
string

IANA timezone identifier for the event

​
location
string

Physical location of the event

​
link
string

External event link URL