BSG utilizes HTTP cookies (and similar or complementary technologies) to 1) make this website safe, functional, and accessible (through the use of mandatory cookies) and 2) understand how you use our website (through the use of optional cookies) in order to improve your experience and to provide you with personalized content.

The information in the cookie text files may be related to your personal preferences or your device and is intended to make the site operate according to your expectations. The information contained in cookies does not usually identify your identity directly but is helpful in providing you with a more personalized user experience.

In accordance with the requirements of the General Data Protection Regulation (GDPR) privacy and security law that governs how the personal data of individuals in the EU may be processed and transferred, we provide you the possibility to prohibit the use of certain types of cookies when you use our website.

Read our Cookie Notice and the Privacy Policy for detailed information on how BGS collects and uses cookies. Please note that prohibiting the use of certain types of cookies may affect your interaction with the website and limit the accessibility of services we offer you. Choose the appropriate category below to learn more and to disable cookies.

Accept All cookies*
*Recommended for comfortable use of the site
Accept only necessary cookies
Accept only selected cookies
Necessary cookies
Social media
Analytics
Marketing

BSG migrated to the new DevPortal
to ship the latest One API versions faster

Use it for up-to-date endpoints, guides, and changelogs

Go to the new DevPortal
Developer Docs
Number Intelligence

Add a contact to the RCS stop list

Method : POST

Endpoint : /api/stoplist/attach

Description: method for adding one or more contacts to the RCS stop list.

Input parameters

Parameter Mandatory Type Description.
phones Yes array Array of phone numbers
types Yes array The type of stop list to which you want to add a contact. Possible values: sms, viber, rcs.

Answer elements

Parameter Type Description.
id integer id of the contact added to the stop list.
phone string Phone number of the contact.
created_at datetime The date when the contact was added to the stop list.
sms_stoplist boolean Indicates whether the contact is in the SMS stop list. Possible values: true/false.
viber_stoplist boolean Indicates whether the contact is in the Viber stop list. Possible values: true/false.
rcs_stoplist boolean Indicates whether there is a contact in the RCS stop list. Possible values: true/false.

Example of a query


{
   "phones":[
      380661231231
   ],
   "types":[
      "rcs"
   ]
}

An example of an answer

If the request is successfully executed:


{
   "data":[
      {
         "id":9392897,
         "phone":380661231231,
         "created_at":"2022-04-18 19:22:16",
         "sms_stoplist":true,
         "viber_stoplist":true,
         "rcs_stoplist":true
      }
   ]
}

Interested in a special offer?

Ready to reach further?
Let’s talk

I agree to BSG privacy policy
Submit

Useful Materials

WhatsApp Business API: Complete Guide — Setup, Pricing, Use Cases [2026]

WhatsApp Business API for 2026 — setup steps, the new per-message pricing model, and proven use cases by industry.

What Is CPaaS? The Complete Business Guide to Communications Platform as a Service

What is CPaaS? The cloud API layer that adds SMS, WhatsApp, voice & OTP to your apps — how it works and why it beats a multi-vendor stack.

One Communication API for SMS, WhatsApp, Viber & RCS — Why It Beats Five

Why one communication API for SMS, WhatsApp, Viber & RCS beats five separate integrations — cascade fallback, unified reports.