Send video

curl -X POST "https://core.wadial.com/api/v1/sessions/{sessionId}/messages/video" \
  -H "Authorization: Bearer $WADIAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: order-123-video-v1" \
  -d '{"to":"15551234567","content":{"type":"video","mediaUrl":"https://example.com/demo.mp4","mimetype":"video/mp4","caption":"Quick demo"}}'

curl -X POST "https://core.wadial.com/api/v1/sessions/{sessionId}/messages/video" \
  -H "Authorization: Bearer $WADIAL_API_KEY" \
  -H "Idempotency-Key: order-123-video-v1" \
  -F "to=15551234567" \
  -F "caption=Quick demo" \
  -F "media=@./demo.mp4;type=video/mp4"

{
  "data": {
    "to": "15551234567",
    "contentType": "video",
    "mediaUrl": "https://example.com/demo.mp4",
    "caption": "Quick demo",
    "status": "sent"
  }
}

POST

api

sessions

{sessionId}

messages

video

curl -X POST "https://core.wadial.com/api/v1/sessions/{sessionId}/messages/video" \
  -H "Authorization: Bearer $WADIAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: order-123-video-v1" \
  -d '{"to":"15551234567","content":{"type":"video","mediaUrl":"https://example.com/demo.mp4","mimetype":"video/mp4","caption":"Quick demo"}}'

curl -X POST "https://core.wadial.com/api/v1/sessions/{sessionId}/messages/video" \
  -H "Authorization: Bearer $WADIAL_API_KEY" \
  -H "Idempotency-Key: order-123-video-v1" \
  -F "to=15551234567" \
  -F "caption=Quick demo" \
  -F "media=@./demo.mp4;type=video/mp4"

{
  "data": {
    "to": "15551234567",
    "contentType": "video",
    "mediaUrl": "https://example.com/demo.mp4",
    "caption": "Quick demo",
    "status": "sent"
  }
}

The token must be paired and connected: true. Use Idempotency-Key when retrying the same send.

string

required

Token id returned by POST /api/v1/sessions.

string

Unique key for retrying the same send request safely.

string

required

Recipient phone number with country code.

string

required

Must be video.

string

required

Public video URL used by the editable playground. Use the multipart cURL example below to upload a file instead.

string

required

Video MIME type, for example video/mp4.

string

Optional video caption.

curl -X POST "https://core.wadial.com/api/v1/sessions/{sessionId}/messages/video" \
  -H "Authorization: Bearer $WADIAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: order-123-video-v1" \
  -d '{"to":"15551234567","content":{"type":"video","mediaUrl":"https://example.com/demo.mp4","mimetype":"video/mp4","caption":"Quick demo"}}'

curl -X POST "https://core.wadial.com/api/v1/sessions/{sessionId}/messages/video" \
  -H "Authorization: Bearer $WADIAL_API_KEY" \
  -H "Idempotency-Key: order-123-video-v1" \
  -F "to=15551234567" \
  -F "caption=Quick demo" \
  -F "media=@./demo.mp4;type=video/mp4"

{
  "data": {
    "to": "15551234567",
    "contentType": "video",
    "mediaUrl": "https://example.com/demo.mp4",
    "caption": "Quick demo",
    "status": "sent"
  }
}

Get started

Guides

Build with the API

API Reference