> ## Documentation Index
> Fetch the complete documentation index at: https://knowledge.flowella.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Block WhatsApp users from your business number

> What blocking a WhatsApp user does on the Business Platform, Meta's limits on blocking, and how to stop messaging a contact with Flowella opt-outs.

Meta's **Block Users API** lets a business block a WhatsApp user from its business number. A blocked user can't message the business or see when it's online, and the business can't message them. You can only block someone who has messaged your number in the last 24 hours, and each number's blocklist holds up to 64,000 users. You can unblock people and list who is blocked.

> [!NOTE]
>
> **In Flowella.** Not available. Flowella can't block or unblock WhatsApp users. To stop Flowella messaging a contact, add an [opt-out](https://knowledge.flowella.io/app/opt-outs.md): it blocks every send to that person from that number, from the Inbox, bulk send, HubSpot and the API. An opt-out doesn't stop the person messaging you, and their messages still reach the Inbox.

## Blocking compared with an opt-out

| | Meta block | Flowella opt-out |
| - | - | - |
| The person can message you | No | Yes |
| You can message the person | No. Sends fail. | No. Flowella refuses the send. |
| Who can apply it | Software using Meta's API | Your team on the **Opt-outs** page, or the person, by sending a keyword such as `STOP` |
| When you can apply it | Only within 24 hours of the person's last message | At any time |
| Limit | 64,000 people per number | |

## Meta's rules

| Rule | Detail |
| - | - |
| Who can be blocked | WhatsApp users who messaged your number in the last 24 hours. Other businesses can't be blocked. |
| Per request | Up to 1,000 users |
| Blocklist size | 64,000 users per business number |
| Partial results | Meta reports success or failure for each user, because some can succeed while others fail |

## Errors

| Code | Meaning |
| - | - |
| `139100` | Some or all of the users couldn't be blocked or unblocked |
| `139101` | The blocklist is full at 64,000 users |
| `139102` | The blocklist changed while it was being read |
| `139103` | Meta had an internal error. Try again. |
| `131047` | The person hasn't messaged you in the last 24 hours, or isn't a WhatsApp user |
| `131021` | You tried to block your own number |
| `130429` | Too many users or requests in a short time |

## Related

> [card] [Opt-outs](https://knowledge.flowella.io/app/opt-outs.md)
>
> Stop Flowella messaging a contact.

> [card] [Opt-in and opt-out](https://knowledge.flowella.io/whatsapp/messaging/opt-in-and-opt-out.md)
>
> WhatsApp's consent rules.

> [card] [Policy and enforcement](https://knowledge.flowella.io/whatsapp/messaging/policy-and-enforcement.md)
>
> How customers' blocks and reports affect your number.

> [card] [Error codes](https://knowledge.flowella.io/whatsapp/errors/error-codes.md)
>
> Every WhatsApp error code.

Checked against Meta's [Block users](https://developers.facebook.com/documentation/business-messaging/whatsapp/block-users) documentation on 18 November 2026.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.