Send PDF - Wawp WhatsApp API

POST /sendFile

Treat PDFs as general file deliveries via the file endpoint.
Require file.url and optional caption.
Improve user experience by extracting and showing preview metadata (filename, size) before upload and by confirming allowed extensions/mime-types.
Provide a clear large-file warning and progress indicator.

If server returns proxy_error or wawp_upstream_error, provide a retry option and a “share a link instead” fallback.

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200Success

application/json

Body

Example

{
  "_data": {
    "id": {
      "fromMe": true,
      "remote": "000000000000@c.us",
      "id": "MSG_ID_123456",
      "_serialized": "true_000000000000@c.us_MSG_ID_123456"
    },
    "viewed": false,
    "body": null,
    "type": "document",
    "t": 1759109026,
    "from": {
      "server": "c.us",
      "user": "111111111111",
      "_serialized": "111111111111@c.us"
    },
    "to": {
      "server": "c.us",
      "user": "000000000000",
      "_serialized": "000000000000@c.us"
    },
    "ack": 0,
    "isNewMsg": true,
    "star": false,
    "kicNotified": false,
    "caption": "Here's your requested document.",
    "deprecatedMms3Url": "https://example.com/document-url",
    "directPath": "/media/direct/path/document",
    "mimetype": "application/pdf",
    "filehash": "FILE_HASH_PLACEHOLDER",
    "encFilehash": "ENC_FILE_HASH_PLACEHOLDER",
    "size": 24024,
    "filename": "document.pdf",
    "mediaKey": "MEDIA_KEY_PLACEHOLDER",
    "mediaKeyTimestamp": 1759109026,
    "streamable": false,
    "mediaHandle": null,
    "isFromTemplate": false,
    "pollInvalidated": false,
    "isSentCagPollCreation": false,
    "latestEditMsgKey": null,
    "latestEditSenderTimestampMs": null,
    "mentionedJidList": [],
    "groupMentions": [],
    "isEventCanceled": false,
    "eventInvalidated": false,
    "isVcardOverMmsDocument": false,
    "isForwarded": false,
    "isQuestion": false,
    "questionReplyQuotedMessage": null,
    "questionResponsesCount": 0,
    "readQuestionResponsesCount": 0,
    "labels": [],
    "hasReaction": false,
    "disappearingModeInitiator": "chat",
    "disappearingModeTrigger": "chat_settings",
    "productHeaderImageRejected": false,
    "lastPlaybackProgress": 0,
    "isDynamicReplyButtonsMsg": false,
    "isCarouselCard": false,
    "parentMsgId": null,
    "callSilenceReason": null,
    "isVideoCall": false,
    "callDuration": null,
    "callCreator": null,
    "callParticipants": null,
    "isCallLink": null,
    "callLinkToken": null,
    "isMdHistoryMsg": false,
    "stickerSentTs": 0,
    "lastUpdateFromServerTs": 0,
    "invokedBotWid": null,
    "bizBotType": null,
    "botResponseTargetId": null,
    "botPluginType": null,
    "botPluginReferenceIndex": null,
    "botPluginSearchProvider": null,
    "botPluginSearchUrl": null,
    "botPluginSearchQuery": null,
    "botPluginMaybeParent": false,
    "botReelPluginThumbnailCdnUrl": null,
    "botMessageDisclaimerText": null,
    "botMsgBodyType": null,
    "requiresDirectConnection": false,
    "bizContentPlaceholderType": null,
    "hostedBizEncStateMismatch": false,
    "senderOrRecipientAccountTypeHosted": false,
    "placeholderCreatedWhenAccountIsHosted": false,
    "galaxyFlowDisabled": false,
    "links": []
  },
  "mediaKey": "MEDIA_KEY_PLACEHOLDER",
  "id": {
    "fromMe": true,
    "remote": "000000000000@c.us",
    "id": "MSG_ID_123456",
    "_serialized": "true_000000000000@c.us_MSG_ID_123456"
  },
  "ack": 0,
  "hasMedia": true,
  "body": "Here's your requested document.",
  "type": "document",
  "timestamp": 1759109026,
  "from": "111111111111@c.us",
  "to": "000000000000@c.us",
  "deviceType": "android",
  "isForwarded": false,
  "forwardingScore": 0,
  "isStatus": false,
  "isStarred": false,
  "fromMe": true,
  "hasQuotedMsg": false,
  "hasReaction": false,
  "vCards": [],
  "mentionedIds": [],
  "groupMentions": [],
  "isGif": false,
  "links": []
}

🟠401invalid_instance

🟠401invalid_access_token