SmartWats Cloud API
    • Send Message
      POST
    • Send Media Message
      POST
    • Send Template Message
      POST
    • Get Template List
      GET
    • Send Carousel Template Message
      POST
    • Create Contact
      POST
    • Create Campaign
      POST
    • Campaign List
      GET
    • Campaign Status
      GET
    • Update Contact
      POST
    • Get Contacts
      GET
    • Get Single Contact
      GET
    • Send Interactive Message
      POST
    • Assign Team Member and Enable/Disable AI Bot and Bot Reply
      POST
    • Get Contact Groups
      GET
    • Get Contact Labels and Tags
      GET
    • Get Message Status
      GET
    • Assign Groups to Contacts
      POST
    • Unassign Groups from Contacts
      POST
    • Assign Labels to Contacts
      POST
    • Unassign Labels to Contacts
      POST

      Send Media Message

      POST
      /{{vendorUid}}/contact/send-media-message
      Send Message

      Request

      Authorization
      Provide your bearer token in the
      Authorization
      header when making requests to protected resources.
      Example:
      Authorization: Bearer ********************
      Body Params application/jsonRequired

      Examples

      Responses

      🟢200
      application/json
      Body

      Request Request Example
      Shell
      JavaScript
      Java
      Swift
      curl --location -g --request POST '/{{vendorUid}}/contact/send-media-message' \
      --header 'Authorization: Bearer <token>' \
      --header 'Content-Type: application/json' \
      --data-raw '{
          // optional from phone number id is not given it will use default phone number id
          "from_phone_number_id": "",
          "phone_number" : "{{phoneNumber}}",
          "media_type" : "document",
          "media_url" : "https://images.pexels.com/photos/276267/pexels-photo-276267.jpeg?auto=compress&cs=tinysrgb&w=1260&h=750&dpr=2",
          "caption" : "your capation for image or video media types",
          "file_name" : "your file name for document",
          // if you want to create contact if it does not exist
          "contact": {
              "first_name" : "Johan",
              "last_name" : "Doe",
              "email" : "johndoe@doamin.com",
              "country" : "Saudi Arabia",
              "language_code" : "ar",
              "groups" : "examplegroup1,examplegroup2"
          }
      }'
      Response Response Example
      {}
      Modified at 2026-04-22 11:00:47
      Previous
      Send Message
      Next
      Send Template Message
      Built with