Sinch Engage icon

Sinch Engage

Send SMS and manage communications via Sinch Engage
Join our community

Actions2

  • Blacklist Actions
  • SMS Actions

Overview

This node integrates with Sinch Engage to manage phone number blacklisting. Specifically, the 'Blacklist - Add' operation allows users to add one or multiple phone numbers to a blacklist, preventing those numbers from receiving communications. It supports input of phone numbers in E.164 format, optionally parsing local numbers based on a selected country. This node is useful for compliance with opt-out requests or managing communication preferences by blocking unwanted recipients.

Use Case Examples

  1. A marketing team uses this node to add phone numbers of customers who have opted out of receiving promotional SMS messages to the blacklist, ensuring compliance with regulations.
  2. A customer support system automatically blacklists phone numbers that repeatedly send spam or abusive messages to prevent further contact.

Properties

Name Meaning
Phone Numbers Phone number(s) to add to the blacklist. Enter one number per line in E.164 format. Multiple numbers are processed in a single API call.
Country Country code used to parse local phone numbers without an international prefix, helping to normalize numbers to E.164 format.

Output

JSON

  • success - Indicates if the blacklist addition was successful (true/false)
  • numbersAdded - The count of phone numbers successfully added to the blacklist
  • numbers - Array of phone numbers that were added to the blacklist in E.164 format
  • response - Full API response object from the blacklist addition request

Dependencies

  • Sinch Engage API (MessageMedia)
  • An API key credential for authentication

Troubleshooting

  • Invalid phone number format errors: Ensure phone numbers are in E.164 format or provide the correct country code for local numbers.
  • Empty phone number input: The node requires at least one phone number to add to the blacklist.
  • API request failures: Check network connectivity and API credentials if the request to add numbers to the blacklist fails.
  • Error messages from the API are propagated; review the error message for specific issues such as rate limits or invalid numbers.

Discussion