Video status - Wawp WhatsApp API

POST /status/video

Uploads a video file as a status update (video story). This allows you to share short video clips visible to your contacts for 24 hours.

Developer Tips & Best Practices:

Format: The preferred format is MP4 (H.264 video codec and AAC audio).

Duration: WhatsApp Status videos are typically capped at 30 seconds. Longer videos may be trimmed automatically by the receiving clients or rejected if too large.

Size: Keep file sizes reasonable (ideally under 16MB) to ensure successful delivery.

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200Success

application/json

Body

Example

{
    "id": "true_status@broadcast_AAAAAAAAAAAAAAAAAAAAAA_1234567890@c.us",
    "_data": {
        "Info": {
            "Chat": "status@broadcast",
            "Sender": "1234567890:13@s.whatsapp.net",
            "IsFromMe": true,
            "IsGroup": false,
            "AddressingMode": "",
            "SenderAlt": "",
            "RecipientAlt": "",
            "BroadcastListOwner": "",
            "BroadcastRecipients": null,
            "ID": "AAAAAAAAAAAAAAAAAAAAAA",
            "ServerID": 0,
            "Type": "",
            "PushName": "",
            "Timestamp": "2026-01-03T02:21:37.314Z",
            "Category": "",
            "Multicast": false,
            "MediaType": "",
            "Edit": "",
            "MsgBotInfo": {
                "EditType": "",
                "EditTargetID": "",
                "EditSenderTimestampMS": "0001-01-01T00:00:00Z"
            },
            "MsgMetaInfo": {
                "TargetID": "",
                "TargetSender": "",
                "TargetChat": "",
                "DeprecatedLIDSession": null,
                "ThreadMessageID": "",
                "ThreadMessageSenderJID": ""
            },
            "VerifiedName": null,
            "DeviceSentMeta": null
        },
        "Message": {
            "videoMessage": {
                "URL": "https://mmg.whatsapp.net/v/t62.7161-24/REDACTED_VIDEO.enc?ccb=11-4&oh=REDACTED_HASH&oe=REDACTED_EXPIRY",
                "mimetype": "video/mp4",
                "fileSHA256": "REDACTED_SHA256",
                "fileLength": 302253,
                "mediaKey": "REDACTED_MEDIA_KEY",
                "caption": "Watch this clip",
                "fileEncSHA256": "REDACTED_ENC_SHA256",
                "directPath": "/v/t62.7161-24/REDACTED_PATH...",
                "JPEGThumbnail": "/9j/4AAQSkZJRgABAgAAUgBRAAD//gAQTGF2YzU5LjM3LjEwMAD/2wBDAAgEBAQEBAUFBQUFBQYGBgYGBgYGBgYGBgYHBwcICAgHBwcGBgcHCAgICAkJCQgICAgJCQoKCgwMCwsODg4RERT/xACBAAEAAwEBAQEAAAAAAAAAAAAAAgUEAwEHBgEBAQEBAQAAAAAAAAAAAAAAAAIBAwQQAAIBAwMCAwYEBwEAAAAAAAECAwAEETESIUEFIhQGUpFhoRNxsZLBUYIjYgeBFdEyEQACAgIBBQEBAAAAAAAAAAAAAQIRMQMScUIhkUFhgf/AABEIACkASAMBIgACEQADEQD/2gAMAwEAAhEDEQA/APgNKUoBWt+zXUAXzH8mRwCIMEyqCMgyDSPIwQreP91FW/oXs0UiXvfLpVMVg0cNqrruSS9lBZXIOot41MmMHxmOoyW7TJJctukDSn6khYF2Z8nJ684PiPWumrVzy6RMp1j4VP8ArwE8TMGyRwVIHy/WuMlu8fUOPhrVxHbQXLbS+zUJngE40znAJ4GTpWG4SKCTG4SN7CbhtyBwxI1ByDjOlVPTBOlkRlLJhpXsgIkORjOeNMV5XJ2nRVilKVgFKUoD9bYBl/tfH5cn6j94vy+3XcsNoBn+DGKp7S7eKEQEuJNxHGThT7+tWXoO9jvu39y9NynbJct53t503XCRlJoB/VNFtZB1MW0ckVS3MdzZXE0DhlZSVbUHHTmvRqa4R6V6OXfNft/x4NsxeNU+kwDPwSQMgc5K5B2/fGQazmS3jklwpZjjYzYPz+/WuCTTMNnidj/5JJyP85A9+a6zWsqIS7qWC8jUcjOM6H8Kq1baRteFbM9+yOI2GN3Uf9rPUpW3N8z96jXn2u5suKpClKVJoyKZFRpQE0keJ1kjdo3Rg6OjFWRlOQysMEEHkEciruX1NY98ix3mN4bzaFPcLVFYXHxurfKeL2pImGddmeaoaVUNkoY9GSgpecNfUWEvk4TmK8hmHQos6t+WSJSKzTXRfKqW2n2jzXCla902qwFFdSXFMio0qDSWRTIqNKA//9k="
            }
        },
        "IsEphemeral": false,
        "IsViewOnce": false,
        "IsViewOnceV2": false,
        "IsViewOnceV2Extension": false,
        "IsDocumentWithCaption": false,
        "IsLottieSticker": false,
        "IsBotInvoke": false,
        "IsEdit": false,
        "SourceWebMsg": null,
        "UnavailableRequestID": "",
        "RetryCount": 0,
        "NewsletterMeta": null,
        "RawMessage": {
            "videoMessage": {
                "URL": "https://mmg.whatsapp.net/v/t62.7161-24/REDACTED_VIDEO.enc?ccb=11-4&oh=REDACTED_HASH&oe=REDACTED_EXPIRY",
                "mimetype": "video/mp4",
                "fileSHA256": "REDACTED_SHA256",
                "fileLength": 302253,
                "mediaKey": "REDACTED_MEDIA_KEY",
                "caption": "Watch this clip",
                "fileEncSHA256": "REDACTED_ENC_SHA256",
                "directPath": "/v/t62.7161-24/REDACTED_PATH...",
                "JPEGThumbnail": "/9j/4AAQSkZJRgABAgAAUgBRAAD//gAQTGF2YzU5LjM3LjEwMAD/2wBDAAgEBAQEBAUFBQUFBQYGBgYGBgYGBgYGBgYHBwcICAgHBwcGBgcHCAgICAkJCQgICAgJCQoKCgwMCwsODg4RERT/xACBAAEAAwEBAQEAAAAAAAAAAAAAAgUEAwEHBgEBAQEBAQAAAAAAAAAAAAAAAAIBAwQQAAIBAwMCAwYEBwEAAAAAAAECAwAEETESIUEFIhQGUpFhoRNxsZLBUYIjYgeBFdEyEQACAgIBBQEBAAAAAAAAAAAAAQIRMQMScUIhkUFhgf/AABEIACkASAMBIgACEQADEQD/2gAMAwEAAhEDEQA/APgNKUoBWt+zXUAXzH8mRwCIMEyqCMgyDSPIwQreP91FW/oXs0UiXvfLpVMVg0cNqrruSS9lBZXIOot41MmMHxmOoyW7TJJctukDSn6khYF2Z8nJ684PiPWumrVzy6RMp1j4VP8ArwE8TMGyRwVIHy/WuMlu8fUOPhrVxHbQXLbS+zUJngE40znAJ4GTpWG4SKCTG4SN7CbhtyBwxI1ByDjOlVPTBOlkRlLJhpXsgIkORjOeNMV5XJ2nRVilKVgFKUoD9bYBl/tfH5cn6j94vy+3XcsNoBn+DGKp7S7eKEQEuJNxHGThT7+tWXoO9jvu39y9NynbJct53t503XCRlJoB/VNFtZB1MW0ckVS3MdzZXE0DhlZSVbUHHTmvRqa4R6V6OXfNft/x4NsxeNU+kwDPwSQMgc5K5B2/fGQazmS3jklwpZjjYzYPz+/WuCTTMNnidj/5JJyP85A9+a6zWsqIS7qWC8jUcjOM6H8Kq1baRteFbM9+yOI2GN3Uf9rPUpW3N8z96jXn2u5suKpClKVJoyKZFRpQE0keJ1kjdo3Rg6OjFWRlOQysMEEHkEciruX1NY98ix3mN4bzaFPcLVFYXHxurfKeL2pImGddmeaoaVUNkoY9GSgpecNfUWEvk4TmK8hmHQos6t+WSJSKzTXRfKqW2n2jzXCla902qwFFdSXFMio0qDSWRTIqNKA//9k="
            }
        }
    }
}