Create imported post
Concise API reference for POST /api/integrations/posts.
Endpoint
POST /api/integrations/posts
Requires a Bearer API key, JSON content type, idempotency key, active integration, and Post ingestion capability. Maximum request size: 32 KB. Default rate: 60 requests per minute.
JSON body
| Name | Type | Required | Constraints |
|---|---|---|---|
uuid | string | Yes | Stable subject, at most 255 characters |
username | string | Yes | 1–50 characters |
novel | string | Yes | 1–300 characters |
content | string | Yes | 1–20,000 characters |
chapterNumber | integer | No | 1–1,000,000 |
timestamp | ISO 8601 string | No | Explicit timezone, not over five minutes ahead |
Success statuses
201 Created means the post was inserted. 200 OK with created: false means the same idempotency key already succeeded and the original result was returned. Both responses include postId, threadId, and url.
Endpoint errors
In addition to common authentication and validation errors, this endpoint may return novel_not_found, rate_limit_exceeded, or an identity/idempotency conflict. A missing novel is not automatically retryable unless Genesis approves the novel or enables creation.