Skip to main content
POST
Upload an image, video, audio or document. You can use the return object directly when creating a new message.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

multipart/form-data
type
enum<string>
Available options:
image,
video,
audio,
document
public
integer

Optional flag to indicate if the file should be publicly accessible permanently. Use it for WhatsApp campaigns or template sending. Does not work when using the messages endpoint. Only use for files that are not sensitive as anyone with the URL can access the file.

Example:

1

file
file

Response

200 - application/json

Success

internal_uuid
string

Internal identifier which will be used when creating a new message.

public
boolean

When public, returned URL is valid as long file exists. When not public, URL will be temporary signed URL.

url
string

Public reachable URL.

name
string

Name of uploaded file.

type
string

Type of uploaded file (specified on upload).

mime_type
string

Mime type of uploaded file.

size
integer

Size in bytes of uploaded file.