Send image

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

curl -X POST "https://core.wadial.com/api/v1/sessions/{sessionId}/messages/image" \
  -H "Authorization: Bearer $WADIAL_API_KEY" \
  -H "Idempotency-Key: order-123-image-v1" \
  -F "to=15551234567" \
  -F "caption=Receipt copy" \
  -F "media=@./receipt.jpg;type=image/jpeg"

{
  "data": {
    "to": "15551234567",
    "contentType": "image",
    "mediaUrl": "https://example.com/receipt.jpg",
    "caption": "Receipt copy",
    "status": "sent"
  }
}

POST

api

sessions

{sessionId}

messages

image

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

curl -X POST "https://core.wadial.com/api/v1/sessions/{sessionId}/messages/image" \
  -H "Authorization: Bearer $WADIAL_API_KEY" \
  -H "Idempotency-Key: order-123-image-v1" \
  -F "to=15551234567" \
  -F "caption=Receipt copy" \
  -F "media=@./receipt.jpg;type=image/jpeg"

{
  "data": {
    "to": "15551234567",
    "contentType": "image",
    "mediaUrl": "https://example.com/receipt.jpg",
    "caption": "Receipt copy",
    "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 image.

string

required

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

string

required

Image MIME type, for example image/jpeg or image/png.

string

Optional image caption.

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

curl -X POST "https://core.wadial.com/api/v1/sessions/{sessionId}/messages/image" \
  -H "Authorization: Bearer $WADIAL_API_KEY" \
  -H "Idempotency-Key: order-123-image-v1" \
  -F "to=15551234567" \
  -F "caption=Receipt copy" \
  -F "media=@./receipt.jpg;type=image/jpeg"

{
  "data": {
    "to": "15551234567",
    "contentType": "image",
    "mediaUrl": "https://example.com/receipt.jpg",
    "caption": "Receipt copy",
    "status": "sent"
  }
}

Get started

Guides

Build with the API

API Reference