> 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.md).

# Integrations

SMS integrations — the providers that deliver your text messages, and which one is the default.

**Where:** SMS → **Integrations** · `/projects/<project>/sms/integrations`

An **integration** is your saved connection to one SMS provider. Saving it sends nothing; it makes the provider available to campaigns, trigger actions and template tests. Every campaign and trigger action names the integration that sends it, and that integration's number or sender ID is what the phone shows. The **default** integration is only the one Cloud picks for you on the forms. The rules that are the same in every module are on the [Integrations concept](/codemash/cloud/concepts/integrations.md) page.

<figure><img src="https://712692422-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHy372bqsaex2cqS3ikhL%2Fuploads%2Fgit-blob-e4b7290924cae6f210b827fe2308d6ad0354feae%2Fdisable-4.png?alt=media" alt="SMS Service Integrations list with two rows: Test Me, provider Fake, Enabled Yes, DEFAULT; and Twilio (Acme support line), provider Twilio, Enabled Yes; the Add New Integration button at the top right"><figcaption><p>SMS Service Integrations with the Fake and a Twilio integration.</p></figcaption></figure>

## Columns, search and filters

| Column           | What it shows                                                                                        |
| ---------------- | ---------------------------------------------------------------------------------------------------- |
| Integration Name | The name; press it to open the integration's page.                                                   |
| Provider         | `Twilio`, `Fake`, … A provider that cannot send yet carries the badge **SENDING NOT SUPPORTED YET**. |
| Enabled          | **Yes** or **No**.                                                                                   |
| Default          | The **DEFAULT** badge on the environment's default integration.                                      |

The list has no search. Right after you enable the module it holds one row, the built-in [Fake SMS (Test Me)](/codemash/cloud/sms/integrations/providers/fake-sms.md), enabled and the default. With several enabled integrations and no default, a yellow **No Default Set For Active Integrations** warning asks you to set one.

On an integration's page, the badges show its state: **DEFAULT**, **ENABLED** or **DISABLED**, **TESTED** / **TEST FAILED** / **NOT TESTED**, and **CONFIRMED** / **NOT CONFIRMED** (whether a person confirmed that the last test SMS arrived). The **Actions** menu also has **See \<Provider> documentation**, which opens the provider page here; **See SDK documentation** and **See API documentation** open an old address that does not work yet — use the [SDK](/codemash/sdks/notifications/sms.md) and [API](/codemash/api-reference/notifications/sms.md) reference instead.

## What you can do here

* [Connect a provider](/codemash/cloud/sms/integrations/providers.md) — **Add New Integration**: [Twilio](/codemash/cloud/sms/integrations/providers/twilio.md) or [Fake SMS (Test Me)](/codemash/cloud/sms/integrations/providers/fake-sms.md)
* [Test an integration](/codemash/cloud/sms/integrations/test.md)
* [Set an integration as default](/codemash/cloud/sms/integrations/set-default.md)
* [Disable, enable or delete an integration](/codemash/cloud/sms/integrations/disable.md)

## Do it from code

```ts
const { list, defaultIntegrationId } = await norbix.hub.notifications.getSmsIntegrations();
console.log(defaultIntegrationId, list.items.map((i) => `${i.viewId} ${i.integrationName} ${i.provider} enabled=${i.isEnabled}`));
// int_6owP11oF9ZZAt9szkqy99S [ 'int_6owP11oF9ZZAt9szkqy99S Test Me Fake enabled=true', 'int_2w2M7MsL0amANOuxamqgiG Twilio (Acme support line) Twilio enabled=true' ]
```

```sh
norbix hub notifications sms integrations get
```

The client setup is on the [SMS page](/codemash/cloud/sms.md#use-it-from-code). API: [Get Sms Integrations](/codemash/api-reference/notifications/sms/get-sms-integrations.md) · [Get Sms Integration](/codemash/api-reference/notifications/sms/get-sms-integration.md)