Skip to main content
POST
/
api
/
{session}
/
status
/
video
{
  "video": {
    "content": "AAAAIGZ0eXBpc29tAAACAGlzb21pc28yYXZjMW1wNDEAAAAIZnJlZQAAAs1tZGF0AAACrQYF...",
    "mimetype": "video/mp4"
  },
  "caption": "Check out this amazing video!",
  "participants": [
    "5511999999999@s.whatsapp.net",
    "5511888888888@s.whatsapp.net"
  ]
}

{
    "success": true,
    "messageId": "3EB0796F91D8B2A4E053AC100F0A4D1E"
}

​
Description

This endpoint allows you to send a video status (story) on WhatsApp. You can include a caption and define which contacts will be able to view the status.

​
URL Parameters

​
session
string
required
Unique authenticated session ID

​
Request Body

​
video
object
required
Object containing video data
​
caption
string
Video caption
​
participants
array
Array of contact JIDs who will be able to view the status. If not specified, the status will be visible to all contacts.JID format: ["5511999999999@s.whatsapp.net"]
{
  "video": {
    "content": "AAAAIGZ0eXBpc29tAAACAGlzb21pc28yYXZjMW1wNDEAAAAIZnJlZQAAAs1tZGF0AAACrQYF...",
    "mimetype": "video/mp4"
  },
  "caption": "Check out this amazing video!",
  "participants": [
    "5511999999999@s.whatsapp.net",
    "5511888888888@s.whatsapp.net"
  ]
}

​
Response

​
success
boolean
required
Indicates if the status was sent successfully
​
messageId
string
Sent status message ID
{
    "success": true,
    "messageId": "3EB0796F91D8B2A4E053AC100F0A4D1E"
}

​
Status Codes

  • 200 - Status sent successfully
  • 400 - Invalid parameters
  • 401 - Unauthorized
  • 500 - Server error

​
Usage Example

curl -X POST https://api.wappfy.com.br/api/my-session/status/video \
  -H "Content-Type: application/json" \
  -d '{
    "video": {
      "content": "AAAAIGZ0eXBpc29tAAACAGlzb21pc28yYXZjMW1wNDEAAAAIZnJlZQAAAs1tZGF0AAACrQYF...",
      "mimetype": "video/mp4"
    },
    "caption": "Check out this amazing video!"
  }'

​
Notes

  • Status are temporary content (Stories) that disappear after 24 hours
  • If the participants parameter is not specified, the status will be visible to all contacts
  • Video must be encoded in base64
  • Supported video formats: MP4, AVI, MKV, MOV
  • It is recommended to keep the video with a maximum duration of 30 seconds for better compatibility

Authorizations

​
apikey
string
header
required

Your Wappfy API key (get it at dash.wappfy.com.br)

Path Parameters

​
session
string
required

Session name (instanceName)

Body

application/json
​
file
object
required
  • Option 1
  • Option 2
​
id
string

Pre-generated status message id

Example:

"BBBBBBBBBBBBBBBBB"

​
contacts
string[]

Contact list to send the status to.

Example:

null

​
caption
string
⌘I