Post Story
Supported & TestedPost a text or media status update through the Waplix Stories / Status API.
POSThttps://api.waplix.io/api/v1/stories/post
Authentication
Authorization: Bearer YOUR_API_KEY Parameters Specification
| Parameter | Type | Required | Description |
|---|---|---|---|
| instance_id | string | Required | Required Waplix instance id |
| type | string | Required | Required: text or supported media type |
| text | string | Required | Required for text status updates |
| background_color | string | Optional | Optional text status background color |
| font | string | Optional | Optional text status font style |
| media_url | string | Required | Required for media status updates |
| caption | string | Optional | Optional media caption |
instance_id
stringReq Required Waplix instance id
type
stringReq Required: text or supported media type
text
stringReq Required for text status updates
background_color
stringOpt Optional text status background color
font
stringOpt Optional text status font style
media_url
stringReq Required for media status updates
caption
stringOpt Optional media caption
Usage Notes
Verified on production. Public documentation uses sanitized example data only.
Request Payload Example
Request
curl -X POST "https://api.waplix.io/api/v1/api/v1/stories/post" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"instance_id": "demo_instance",
"type": "text",
"text": "Hello from Waplix Status API",
"background_color": "#1DB954",
"font": 1
}'Success Response
Response · 200 OK
{
"success": true,
"data": {
"instance_id": "demo_instance",
"story_id": "STATUS_DEMO_001",
"message_id": "STATUS_DEMO_001",
"status": "posted",
"type": "text"
}
} Was this page helpful?