---
title: "Post a message to secure space"
method: POST
path: "/api/1/folders/{userFolder}/comments"
tags: ["Messages"]
---

# Post a message to secure space

`POST /api/1/folders/{userFolder}/comments`

## Request body

- object
  - `comment` string, required — Can be a string, HTML, or ProseMirror-compatible JSON object supported by Convoflo
  - `source` 'compose_root' | 'compose' | 'message_list' | 'legacy_reminder' | 'scheduled' | 'secure_space_invitation' | 'inbox' | 'onboarding' | 'import' | 'microsoft' | 'outlook' | 'outlook_forward' | 'zapier' | 'external_inbox' | 'request_review' | 'yearly_assessment', required — Source of the message.
  - `status` 'draft' | 'sent' — Status of the message. Set to "draft" to create as draft (posted_at will be null), or "sent" to create as sent immediately.
  - `title` string — Subject of message like one you would find in an email
  - `parent_id` integer — Provide the ID of the parent message to post a message as a reply
  - `users` integer[] — IDs of the users that the message will only be visible to. These users must be members of the secure space
  - `files` integer[] — Provide file IDs to attach them to this message, like file attachments you would find in an email message.
  - `file_request_id` integer — Provide the ID of the file request to attach it to the message
  - `payment_request_id` integer — Provide the ID of the payment request to attach it to the message
  - `paywalled_files` integer[] — IDs of the files that are blocked until a payment is made
  - `ignore_notifications_for` integer[] — Provide the user IDs to prevent them from being notified of the new message.
  - `read_notification` boolean — Set to true to enable read receipt. You will get a notification when this message will be read.
  - `show_preview` boolean — Set to true to display the message in the notification email sent to the users.
  - `priority` integer — Set to `1` to mark this message as important, such as what you would find in an email.
  - `parent_url` string — Provide the full URL of the parent message to post a message as a reply
  - `message_id` integer — Provide the canned message ID to set the content of the message to. Replaces the `comment` parameter.

## Response `200`

- object
  - `ID` string
  - `@type` string
  - `@id` string
  - `Title` string
  - `Priority` integer
  - `pinned_at` string, nullable
  - `created_at` string
  - `updated_at` string
  - `posted_at` string, nullable
  - `archived_at` string, nullable
  - `Comment` string
  - `preview` string
  - `Format` string
  - `audience` string

---

[API](https://skmtc.net/convoflo/apis/convoflo-rest-api.md) · [All operations](https://skmtc.net/convoflo/apis/convoflo-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/convoflo/convoflo-rest-api/versions/fed4481f0476/schema)