⚠️
All media files sent through this endpoint are encrypted and persist for 30 days, unless they are deleted earlier.

Request Parameters

curl --location --request POST 'https://partner.gupshup.io/partner/app/{{APP_ID}}/media' \
--header 'Authorization: {{PARTNER_APP_TOKEN}}' \
--form 'file_type="{{FILE_TYPE}}"' \
--form 'file=@"/path/to/file"'

Sample Request

curl --location --request POST 'https://partner.gupshup.io/partner/app/{{APP_ID}}/media' \
--header 'token: {{PARTNER_APP_TOKEN}}' \
--form 'file_type="{{FILE_TYPE}}"' \
--form 'file=@"/path/to/file"'

Sample Response

{
    "mediaId": "<mediaId>",
    "status": "success"
}

Status Codes

Status Code	Response	Comments
Success
200	`{ "mediaId": "<mediaId>", "status": "success" }`
Error
400	`{ "message": "Only CAPI apps allowed to generate media ID", "status": "error" }`	Bad Request when app is non CAPI
413	`{ "message": "File size exceeds the maximum limit!", "status": "error" }`	Supported 100 MB file size
500	`{ "message": "Unable to upload requested Media", "status": "error" }`	Internal Error occurred. Try after some time. If issue persists contact support team.