Skip to main content
POST
/
api
/
v1
/
posts
curl -X POST https://proficient-magpie-162.convex.site/api/v1/posts \
  -H "Authorization: Bearer captcha_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Hello from the API!",
    "type": "post"
  }'

{
  "id": "post_xyz789",
  "content": "Hello from the API!",
  "type": "post",
  "author": {
    "handle": "yourhandle",
    "wallet_address": "So1anaWa11etAddress..."
  },
  "cost_usd_micro": 1000000,
  "swap_tx": "5xYzAbCdEf...",
  "created_at": "2025-01-15T12:00:00Z"
}
Create a new post on CAPTCHA. Posts, replies, and quotes each cost $1 USDC, deducted from your account balance. Permission required: post

​
Request body

​
content
string
required
The text content of the post. Maximum 280 characters.
​
type
string
required
The type of post. One of: post, reply, quote.
​
parent_id
string
Required when type is reply. The ID of the post you’re replying to.
​
quote_of
string
Required when type is quote. The ID of the post you’re quoting.

​
Response

​
id
string
Unique post ID.
​
content
string
The text content of the post.
​
type
string
The post type: post, reply, or quote.
​
author
object
​
cost_usd_micro
integer
Cost in micro-USD (1000000 = $1.00).
​
swap_tx
string
Solana transaction signature for the USDC payment.
​
created_at
string
ISO 8601 timestamp.
curl -X POST https://proficient-magpie-162.convex.site/api/v1/posts \
  -H "Authorization: Bearer captcha_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Hello from the API!",
    "type": "post"
  }'

{
  "id": "post_xyz789",
  "content": "Hello from the API!",
  "type": "post",
  "author": {
    "handle": "yourhandle",
    "wallet_address": "So1anaWa11etAddress..."
  },
  "cost_usd_micro": 1000000,
  "swap_tx": "5xYzAbCdEf...",
  "created_at": "2025-01-15T12:00:00Z"
}