Skip to main content
POST
/
admin
/
v1
/
networks
/
{network_id}
/
posts
Create a new post, and optionally notify the network
curl --request POST \
  --url https://api.mn.co/admin/v1/networks/{network_id}/posts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "space_id": 123,
  "title": "<string>",
  "description": "<string>",
  "post_type": "<string>"
}'
{
  "id": "1234",
  "created_at": "2025-11-07T23:17:21+00:00",
  "updated_at": "2025-11-07T23:17:21+00:00",
  "creator_id": 123,
  "space_id": 123,
  "summary": "<string>",
  "description": "<string>",
  "post_type": "<string>",
  "images": [
    "<string>"
  ],
  "title": "<string>",
  "status": "<string>",
  "published_at": "2025-11-07T23:17:22+00:00",
  "last_activity_at": "2025-11-07T23:17:22+00:00",
  "content_type": "<string>",
  "comments_enabled": true,
  "permalink": "<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

Query Parameters

​
notify
boolean

Body

application/json

Submit results as JSON

Posts are created by users within spaces

​
space_id
integer
required

The ID of the space to post in

​
title
string
required

The title of the post

​
description
string

The description/body content of the post

​
post_type
string

The type of post to create (e.g., 'article')

Response

Returns the newly created post on success

Posts are created by users within spaces

​
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"

​
creator_id
integer
required

The ID of the user that created the post

​
space_id
integer
required

The ID of the space where the post was created

​
summary
string
required

A short summary of the post's contents

​
description
string
required

The thing

​
post_type
string
required

The type of post

​
images
string[]
required

An array of image URLs associated with the post

​
title
string
required

The title of the post

​
status
string
required

The post's current status

​
published_at
string<date-time>
required

The date the post was published

Example:

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

​
last_activity_at
string<date-time>
required

The time the of last activity on the post

Example:

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

​
content_type
string
required

The type of post content attached to the post

​
comments_enabled
boolean
required

Whether or not comments are enabled on this post

​
permalink
string<url>
required

The post's unique address within the network