Opt a number out of SMS

Adds a phone number to your team's outbound SMS opt-out list. Any later attempt to send an SMS to that number is blocked, and nothing is charged.

Use this endpoint when a recipient unsubscribes through a channel other than a STOP reply — a phone call, an email, or a form on your website — so that your Ringover opt-out list stays aligned with your own database.

The team is taken from your API key, so it is not part of the payload. The number must be in international format (E.164), with or without the leading +; a national format such as 0612345678 is rejected. Opting out a number that is already opted out succeeds and changes nothing.

The opt-out is scoped to your team only. It has no effect on other Ringover accounts, does not block inbound SMS from that number, and is unrelated to the call blacklist.

Permission: Conversations Write required.

Monitoring: No impact.

{
  "phone_number": "33611223344"
}