# Sinch - SMS Notifications & Verifications

## Available To

Free for the following exchange plans:

* **Cloud Plans:**
  * Enterprise
* **On-Premise Plans:**
  * Enterprise Unlimited

## What Is It?

The **Sinch Plugin** is an SMS gateway integrated into HollaEx exchanges. Powered by [Sinch](https://www.sinch.com), it sends transactional SMS messages from your exchange — deposit/withdrawal notifications and verification codes for actions like withdrawals, password resets, and 2FA — using your Sinch SMS service plan and your own sender phone number or short code.

The plugin auto-formats numbers, routes traffic through your selected Sinch region (US, EU, AU, BR, CA), and integrates directly with the exchange's user verification flow so users who opt in to SMS receive the same codes they would otherwise receive via email or authenticator app.

## Who Needs It?

This plugin is suitable for any HollaEx exchange operator that:

* Wants to send SMS notifications for deposits and withdrawals.
* Wants to offer SMS as a second factor for sensitive actions (withdrawals, password reset).
* Already has a Sinch account, or prefers Sinch's regional coverage and short-code support over alternative SMS providers.

## How to Use It?

You can simply install the plugin from the **Plugins** section inside the Operator Control. After installation, input your Sinch service plan ID, API token, and sender number.

#### 1. Get your Sinch credentials

1. Log in to the [Sinch Customer Dashboard](https://dashboard.sinch.com).
2. Go to **SMS → APIs** and select (or create) a Service Plan. Copy the **Service Plan ID** and **API Token**.
3. Provision or whitelist a sender — either a long phone number in **E.164 format** (e.g. `+15555550123`) or a short code/alphanumeric sender ID supported in your destination countries.
4. Note the **region** your service plan is provisioned in (`us`, `eu`, `au`, `br`, `ca`).

#### 2. Configure the plugin

Open the plugin in the Operator Control and set the following fields:

| Field                        | Required | Default | Description                                                                                               |
| ---------------------------- | -------- | ------- | --------------------------------------------------------------------------------------------------------- |
| `servicePlanId`              | **yes**  | —       | Sinch SMS service plan ID.                                                                                |
| `apiToken`                   | **yes**  | —       | Sinch SMS API token.                                                                                      |
| `fromNumber`                 | **yes**  | —       | Sinch sender phone number or short code.                                                                  |
| `region`                     | no       | `us`    | Sinch SMS API region. Allowed: `us`, `eu`, `au`, `br`, `ca`.                                              |
| `send_sms_deposit`           | no       | `true`  | Send deposit SMS notifications to users.                                                                  |
| `send_sms_withdrawal`        | no       | `true`  | Send withdrawal SMS notifications to users.                                                               |
| `send_sms_user_verification` | no       | `true`  | Send user-action verification codes (e.g. withdrawal, password reset) via SMS when the user has opted in. |

Once configured, the exchange will automatically route SMS through Sinch for any user who has a verified phone number and has opted in to SMS notifications.

***

## **Benefits for HollaEx Operators**

The Sinch plugin gives exchange operators a globally distributed SMS channel with strong regional presence in the US, Europe, APAC, and Latin America. Region-pinned routing keeps latency low and improves carrier-level deliverability for jurisdictions that are hard to reach with generic providers. Combined with the exchange's existing email and authenticator-app channels, SMS rounds out a multi-factor security posture that meets users wherever they are.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.hollaex.com/plugins/use-plugins/sinch-sms-notifications-and-verifications.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.