Uploads (1.0.0)

Endpoints associated with uploading media files.

Upload Media File

The upload endpoint provides a method for converting files from an unsupported format to a format that one of our endpoints can handle.

Files can be submitted two ways: 1. Using base64 encoding in an application/json request. In this case, submit the base64-encoded file contents in the content field of the request body, and convert can be specified either also in the body or as part of the query string. 2. Using multipart/form-data encoding, in the same way it would be submitted using a HTML form. You may find cURL useful for this. For an example of how to do this, see one of our SDKs. In this case, specify convert in the query string.

Note that convert specifies the conversion to take place. That is, what the result should be compatible with and can be any of the following:

  • fax
  • mms
  • csv
  • post
  • postcard

All files will expire 10 minutes after being uploaded.

Parameters

Parameter In Type Required Description
convert query string true none
content body string true Base64-encoded file contents

Refer to Status Codes for definitions of HTTP status code responses.

This endpoint requires authentication, more info...

Request
header Parameters
Content-Type
string
Example: application/json
Request Body schema: application/json
object
Responses
200

Successful response

post/v3/uploads
Request samples
application/json
{
  • "content": "{{base64EncodedFile}}"
}
Copyright © ClickSend 2024. All right reserved.