flow api
Sending · POST

sendFileByUrl

Send an image, PDF, video, audio file or document from a public URL, with an optional caption.

Video walkthrough: sendFileByUrl · 20 seconds · click the bar to jump to a step

Endpoint

POST https://flowapi.pro/waInstance{idInstance}/sendFileByUrl/{apiTokenInstance}

Request body 

{
  "chatId": "972501234567@c.us",
  "urlFile": "https://www.w3.org/WAI/ER/tests/xhtml/testfiles/resources/pdf/dummy.pdf",
  "fileName": "dummy.pdf",
  "caption": ""
}

Example

curl -X POST "https://flowapi.pro/waInstance{idInstance}/sendFileByUrl/{apiTokenInstance}" \
  -H "Content-Type: application/json" \
  -d '{"chatId":"972501234567@c.us","urlFile":"https://www.w3.org/WAI/ER/tests/xhtml/testfiles/resources/pdf/dummy.pdf","fileName":"dummy.pdf","caption":""}'

Response

{
  "idMessage": "3EB0C1A7F2D4E8B91C"
}

Notes

  • fileName must include the extension; the type is detected from it.
  • The URL must be reachable from the internet without login.
Green API compatible. sendFileByUrl uses the same name, request body and response as Green API, so existing code works after you change the host to flowapi.pro. Errors: 401 wrong instance or token, 402 trial ended or number not covered by your plan, 429 rate limit reached (wait the seconds in the Retry-After header), 400 with a message for anything else.

More sending methods

sendMessagesendFileByUploaduploadFilesendLocationsendContactsendPollforwardMessagessendListMessagesendInteractiveButtonssendTextStatussendTyping
Try it on your own number

7 days free, no credit card. Then $10 per number per month.

Start free trial