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

# Plivo

Connect Plivo to SMS — coming soon; Norbix cannot send through Plivo yet.

Plivo is a messaging platform with high-throughput SMS APIs and global carrier connections.

{% hint style="warning" %}
Cloud has no screen for this yet. On **Add New Integration** the Plivo card shows **COMING SOON**, the note *Sending SMS through Plivo is not supported yet.* and a turned-off **Connect** button, and Norbix refuses every send and every test through Plivo (`CM-ERRORS-SMS-005`, *Sending SMS through Plivo 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 %}

<figure><img src="https://712692422-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHy372bqsaex2cqS3ikhL%2Fuploads%2Fgit-blob-c7c500650f55c974d7dd1aea4c89f44f331f886f%2Fplivo-card-1.png?alt=media" alt="The Plivo card on Select SMS Integration: COMING SOON badge, a grey Connect button and the note Sending SMS through Plivo is not supported yet."><figcaption><p>The Plivo card is not connectable yet.</p></figcaption></figure>

## Get your credentials

1. Sign in to the [Plivo console](https://console.plivo.com/).
2. On the **Overview** page copy the **Auth ID** and the **Auth Token**.
3. Under **Phone Numbers** pick a number that can send SMS, in E.164 format.

## Connect it in Cloud

**Where:** SMS → Integrations → **Add New Integration** → Plivo — **Connect** is turned off for now.

The form exists in Cloud and opens only by its address, `/projects/<project>/sms/integrations/new/plivo`; it starts with the note *Sending SMS through Plivo 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                 |
| ------------------- | -------- | ----------------------------------------------------- | ----------------------- |
| Auth ID             | yes      | Names your Plivo account; paired with the Auth Token. | `MAXXXXXXXXXXXXXXXXXX`  |
| Sender Phone Number | yes      | The number the SMS comes from, in E.164 format.       | `+15551234567`          |
| Auth Token          | yes      | Secret; encrypted on save and never shown again.      | `your-plivo-auth-token` |
| Integration Name    | yes      | The name in your integrations list.                   | `Plivo production`      |

<figure><img src="https://712692422-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHy372bqsaex2cqS3ikhL%2Fuploads%2Fgit-blob-d4f807293ff9defdf6d98b3f68ff8a239905a2ed%2Fplivo-form-1.png?alt=media" alt="New Plivo Integration form with the note Sending SMS through Plivo is not supported yet. and the empty fields"><figcaption><p>The Plivo form, opened by its address.</p></figcaption></figure>

## Test and set as default

**Test integration** answers *Test failed* with `Sending SMS through Plivo 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 Plivo goes live.

## Common errors

| Message                                                                          | Cause                                   | Fix                                                                                                                                                 |
| -------------------------------------------------------------------------------- | --------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| Sending SMS through Plivo is not supported yet. Use Twilio or the Fake provider. | Every send or test through Plivo 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: 'Plivo',
    integrationName: 'Plivo production',
    isEnabled: true,
    authId: 'MAXXXXXXXXXXXXXXXXXX',
    fromPhoneNumber: '+15551234567',
    authToken: 'your-plivo-auth-token',
  } as any, // the TS type knows only the shared fields
});
```

```sh
norbix hub notifications sms integration save --integration '{"provider":"Plivo","integrationName":"Plivo production","isEnabled":true,"authId":"MAXXXXXXXXXXXXXXXXXX","fromPhoneNumber":"+15551234567","authToken":"your-plivo-auth-token"}'
```

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)