Softservv API
  1. Media
Softservv API
  • Authentication
    • Login
      POST
  • Accounts
    • Get Account
      GET
  • Whatsapp Accounts
    • Get Whatsapp Accounts
      GET
    • Get Whatsapp Account
      GET
    • Update Whatsapp Account Webhook
      POST
    • Upgrade Whatsapp Account Plan
      POST
    • Suspend Whatsapp Account (Resellers Only)
      POST
    • Unsuspend Whatsapp Account (Resellers Only)
      POST
  • Messages
    • JSON Examples for Sending Messages
    • Get Conversations List
      GET
    • Get Conversation Messages
      GET
    • Get Received Messages
      GET
    • Get Received Message
      GET
    • Get Sent Messages
      GET
    • Get Sent Message
      GET
    • Send Message
      POST
    • Mark Message As Read
      POST
  • Media
    • Get Media
      GET
    • Upload Media
      POST
    • Delete Media
      DELETE
  • Templates
    • JSON Examples for Creating Templates
    • Get Templates
      GET
    • Get Template
      GET
    • Create New Template
      POST
    • Update Template
      POST
    • Delete Template
      DELETE
  • Billing
    • Get Pricing Plans
  • Embedded Inbox
    • Embedded Inbox - How To
    • Generate Embed Code
    • Generate Embed Token
  • Onboarding
    • Create Onboarding Invite
  • Schemas
    • Schemas
  1. Media

Upload Media

POST
https://api.softservv.co/whatsapp-accounts/{number_id}/media/
Uploads a media file for use when sending a WhatsApp message. Requires a Bearer token in the Authorization header.

Request

Authorization
Bearer Token
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
or
Path Params

Body Params multipart/form-data

Responses

🟢200OK
application/json
Successful upload
Body

🟠400Bad Request
🟠401Unauthorized
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.softservv.co/whatsapp-accounts//media/' \
--header 'Authorization: Bearer <token>' \
--form 'file=@""'
Response Response Example
200 - Example 1
{
    "status": "Success",
    "data": {
        "whatsapp_number_id": "1234567890",
        "url": "https://example.com/media/12345",
        "mime_type": "image/jpeg",
        "sha256": "a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0",
        "file_size": 5242880,
        "media_id": "media_12345",
        "key": "key_67890",
        "date_created": "2025-05-15T09:59:00Z"
    }
}
Modified at 2025-09-08 13:58:15
Previous
Get Media
Next
Delete Media
Built with