# WhatsApp photos and files not sending or receiving

> Text messages work fine through the WhatsApp Business API, but images, documents, voice notes, and other media attachments fail.

Text messages work fine through the WhatsApp Business API, but images, documents, voice notes, and other media attachments fail. You might see errors when sending files, or incoming media from customers appears broken or missing.

2 min read

Updated 10 Sep 2026

WhatsApp media (images, PDFs, audio, video) requires a specific API permission called whatsapp_business_messaging. When your access token doesn't include this scope, text-only messages still work, but anything involving media files will fail.

This is one of the most common token configuration issues on WhatsApp Business API.

- Missing token scope. During the initial connection, the access token wasn't granted the whatsapp_business_messaging permission
- Token was regenerated without full permissions. A reauthorization may have produced a token with fewer scopes than the original
- Meta permission changes. Meta occasionally updates required scopes, and older tokens may lack newer permissions

### Step 1: confirm it is a media issue

1

- Send a text-only message. Does it deliver?

2

- Send an image or document. Does it fail?

3

- Ask a contact to send you a photo. Does it appear?

If text works but media doesn't, you likely have a token scope issue.

### Step 2: check your token scopes

1

- Go to the Meta Access Token Debugger

2

- Paste your access token

3

- Look for these required scopes:
  - whatsapp_business_messaging (Required for media)
  - whatsapp_business_management (Required for account management)

If whatsapp_business_messaging is missing, your token needs to be regenerated.

The fix is to generate a new access token with the correct permissions. The exact steps depend on your WhatsApp platform:

1

- Disconnect or unlink your WhatsApp account from your platform

2

- Reconnect through the Embedded Signup or OAuth flow

3

- During the Facebook authorization step, grant all requested permissions. Don't skip or decline any

4

- After reconnecting, verify the new token includes whatsapp_business_messaging at the Token Debugger

5

- Test by sending an image to confirm media works
- After any reauthorization or reconnection, check your token scopes
- Always grant all requested permissions during the Facebook login flow
- If you manage multiple WhatsApp numbers, verify scopes for each token individually

If you're unsure how to check your token scopes, or if regenerating the token doesn't fix the issue:

Talk to Volty

Was this article helpful?

## Related Articles

Messaging WhatsApp error #10: permission deniedYour WhatsApp messages are failing with Error code #10 ("Application does not have permission for this action"). This guide covers the most common causes (Facebook security checkpoints, revoked asset permissions, and token scope issues) and how to fix each one. · Messaging Some contacts cannot read your WhatsApp messagesYou're sending messages through WhatsApp Business, and most contacts receive them fine, but some contacts report they can't see your messages. The messages show as sent on your end, but the recipient sees nothing or gets a "message unavailable" notice.

On this page

Quick Links

Contact Support

WhatsApp Diagnostic Tool

Back to Help Centre

## Links

- [Talk to Volty](https://voltade.com/sg/contact)
- [MessagingWhatsApp error #10: permission deniedYour WhatsApp messages are failing with Error code #10 ("Application does not have permission for this action"). This guide covers the most common causes (Facebook security checkpoints, revoked asset permissions, and token scope issues) and how to fix each one.](https://voltade.com/sg/help-centre/whatsapp-error-10-permission-denied)
- [MessagingSome contacts cannot read your WhatsApp messagesYou're sending messages through WhatsApp Business, and most contacts receive them fine, but some contacts report they can't see your messages. The messages show as sent on your end, but the recipient sees nothing or gets a "message unavailable" notice.](https://voltade.com/sg/help-centre/whatsapp-contacts-cant-read-messages)
- [WhatsApp Diagnostic Tool](https://voltade.com/sg/learn/whatsapp/diagnostic)
- [Back to Help Centre](https://voltade.com/sg/help-centre)
