Create a comment
Request and response reference for POST /api/integrations/posts.
Example request
curl -i -X POST https://forum.genesistudio.com/api/integrations/posts \
-H "Authorization: Bearer $FORUM_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: comment-987654" \
-d '{
"uuid": "external-user-324234",
"username": "reader123",
"novel": "Memorize",
"chapterNumber": 42,
"timestamp": "2026-07-28T09:15:00Z",
"content": "The source comment text."
}'
Request fields
| Field | Required | Validation |
|---|---|---|
uuid | Yes | Stable external user ID, at most 255 characters |
username | Yes | 1–50 characters |
novel | Yes | Novel title, 1–300 characters |
content | Yes | Comment body, 1–20,000 characters |
chapterNumber | No | Integer from 1 to 1,000,000 |
timestamp | No | ISO 8601 timestamp with timezone; no more than five minutes in the future |
If timestamp is omitted, Genesis records the receipt time as the comment time.
Created response
The first successful delivery returns 201 Created:
{
"created": true,
"postId": "2c31d623-0a40-4dac-a8a6-5e939bf37ef9",
"threadId": "79291fea-6eb9-4eca-8259-104be2f10212",
"url": "https://forum.genesistudio.com/novels/memorize/discussion?post=2c31d623"
}
A retry with the same idempotency key returns 200 OK, the original identifiers, and created: false.
Content rules
Do not send HTML, credentials, private messages, or content the user did not intend to publish. The supplied text is handled as Forum comment content and remains subject to automated checks, reports, staff moderation, and applicable retention rules.