> For the complete documentation index, see [llms.txt](https://codemash.gitbook.io/codemash/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://codemash.gitbook.io/codemash/cloud/sms/integrations/providers/sinch.md).
# Sinch
Connect Sinch to SMS — coming soon; Norbix cannot send through Sinch yet.
Sinch is a cloud communications provider with an SMS API and direct carrier connections.
{% hint style="warning" %}
Cloud has no screen for this yet. On **Add New Integration** the Sinch card shows **COMING SOON**, the note *Sending SMS through Sinch is not supported yet.* and a turned-off **Connect** button, and Norbix refuses every send and every test through Sinch (`CM-ERRORS-SMS-005`, *Sending SMS through Sinch is not supported yet. Use Twilio or the Fake provider.*). To send SMS today, use [Twilio](/codemash/cloud/sms/integrations/providers/twilio.md), or [Fake SMS (Test Me)](/codemash/cloud/sms/integrations/providers/fake-sms.md) for practice. The settings below can already be saved with the SDK, the CLI or the API.
{% endhint %}
The Sinch card is not connectable yet.
## Get your credentials
1. Sign in to the [Sinch dashboard](https://dashboard.sinch.com/).
2. Under **SMS → APIs** open your service plan and copy the **Service plan ID** and the **API token**.
3. Copy the API secret, and pick a number of the service plan in E.164 format.
## Connect it in Cloud
**Where:** SMS → Integrations → **Add New Integration** → Sinch — **Connect** is turned off for now.
The form exists in Cloud and opens only by its address, `/projects//sms/integrations/new/sinch`; it starts with the note *Sending SMS through Sinch is not supported yet.* An integration saved there (or from code) stays in the [integrations list](/codemash/cloud/sms/integrations.md) with **SENDING NOT SUPPORTED YET**, can be edited and deleted, and is not offered on campaigns, trigger actions or template tests.
| Field | Required | What it does | Example |
| ------------------- | -------- | ---------------------------------------------------------------- | ---------------------------- |
| Service Plan ID | yes | The SMS service plan used to send. | `your-sinch-service-plan-id` |
| Sender Phone Number | yes | The number the SMS comes from, in E.164 format. | `+15551234567` |
| API Key | yes | Secret (the API token); encrypted on save and never shown again. | `your-sinch-api-token` |
| API Secret | yes | Second secret; encrypted on save and never shown again. | `your-sinch-api-secret` |
| Integration Name | yes | The name in your integrations list. | `Sinch production` |
The Sinch form, opened by its address.
## Test and set as default
**Test integration** answers *Test failed* with `Sending SMS through Sinch is not supported yet. Use Twilio or the Fake provider.`, and the integration is not offered as a sender, so setting it as default has no use yet. See [Test an integration](/codemash/cloud/sms/integrations/test.md) and [Set an integration as default](/codemash/cloud/sms/integrations/set-default.md) for the flow once Sinch goes live.
## Common errors
| Message | Cause | Fix |
| -------------------------------------------------------------------------------- | --------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| Sending SMS through Sinch is not supported yet. Use Twilio or the Fake provider. | Every send or test through Sinch today. | Use [Twilio](/codemash/cloud/sms/integrations/providers/twilio.md) or [Fake SMS (Test Me)](/codemash/cloud/sms/integrations/providers/fake-sms.md). |
| Secret is not provided (`CM-ERRORS-SECRETS-001`) | An update without the secret fields. | Send every secret again on each save. |
| Required | An empty field on the form. | Fill every field. |
## Do it from code
```ts
const { id } = await norbix.hub.notifications.saveSmsIntegration({
integration: {
provider: 'Sinch',
integrationName: 'Sinch production',
isEnabled: true,
servicePlanId: 'your-sinch-service-plan-id',
fromPhoneNumber: '+15551234567',
apiKey: 'your-sinch-api-token',
apiSecret: 'your-sinch-api-secret',
} as any, // the TS type knows only the shared fields
});
```
```sh
norbix hub notifications sms integration save --integration '{"provider":"Sinch","integrationName":"Sinch production","isEnabled":true,"servicePlanId":"your-sinch-service-plan-id","fromPhoneNumber":"+15551234567","apiKey":"your-sinch-api-token","apiSecret":"your-sinch-api-secret"}'
```
The client setup is on the [SMS page](/codemash/cloud/sms.md#use-it-from-code). API: [Save Sms Integration](/codemash/api-reference/notifications/sms/save-sms-integration.md)
