Media Uploads

Endpoints for uploading media files

Upload Media

post

Upload media files (images, videos, documents) to Meta's media API for use in messages.

Authorizations

D360-API-KEY

D360-API-KEYstringRequired

API Key for Messaging API authentication. Send your API key in the D360-API-KEY header.

Body

multipart/form-data

string · binaryOptional

Responses

200

Media uploaded successfully

application/json

idstringOptional

400

Bad request

application/json

401

Unauthorized

application/json

500

Internal server error

application/json

post

/media

HTTPcURLJavaScriptPython

POST /media HTTP/1.1
Host: waba-v2.360dialog.io
D360-API-KEY: YOUR_API_KEY
Content-Type: multipart/form-data
Accept: */*
Content-Length: 8

"binary"

{
  "id": "text"
}

Create Upload Session

post

Create a new upload session for media files. Returns a session ID for uploading file data. See Meta docs: https://developers.facebook.com/docs/graph-api/guides/upload

Authorizations

D360-API-KEY

D360-API-KEYstringRequired

API Key for Messaging API authentication. Send your API key in the D360-API-KEY header.

Query parameters

file_namestringRequired

File name

file_lengthintegerRequired

File size in bytes

file_typestringRequired

MIME type of the file

Responses

200

Upload session created successfully

application/json

idstringOptionalExample: abcdefghijklmnopqrstuvwxyz123456

400

Bad request - missing authorization header or invalid parameters

application/json

401

Unauthorized

application/json

500

Internal server error

application/json

post

/uploads

HTTPcURLJavaScriptPython

POST /uploads?file_name=text&file_length=1&file_type=text HTTP/1.1
Host: waba-v2.360dialog.io
D360-API-KEY: YOUR_API_KEY
Accept: */*

{
  "id": "abcdefghijklmnopqrstuvwxyz123456"
}

Upload Media with Session ID

post

Upload media using upload: prefixed session ID (e.g., for profile picture uploads).

Authorizations

D360-API-KEY

D360-API-KEYstringRequired

API Key for Messaging API authentication. Send your API key in the D360-API-KEY header.

Path parameters

session_idstringRequired

Session ID with 'upload:' prefix

Header parameters

file_offsetintegerOptional

Offset in bytes for this chunk, default 0

Body

multipart/form-data

objectOptional

Responses

200

Media uploaded successfully

application/json

objectOptional

400

Bad request - missing 'upload:' prefix

application/json

401

Unauthorized

application/json

500

Internal server error

application/json

post

/{session_id}

HTTPcURLJavaScriptPython

POST /{session_id} HTTP/1.1
Host: waba-v2.360dialog.io
D360-API-KEY: YOUR_API_KEY
Content-Type: multipart/form-data
Accept: */*
Content-Length: 2

{}

{}