> For the complete documentation index, see [llms.txt](https://docs.onum.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.onum.com/data-sinks/data-sink-integrations/send-data-to-twilio.md).

# Send data to Twilio

{% hint style="info" %}
See the changelog of this Data sink type [here](/data-sinks-changelog/twilio-data-sink.md).
{% endhint %}

## Overview

Onum supports integration with [Twilio](https://www.twilio.com/en-us).

Twilio is a cloud communications platform-as-a-service (PaaS) that provides developers with programmable communication tools for building and scaling communication features into their applications.

## Onum Setup

{% stepper %}
{% step %}
Log in to your Onum tenant and click **Data Sinks> New Data sink**.
{% endstep %}

{% step %}
Double-click the **Twilio** Sink.
{% endstep %}

{% step %}
Enter a **Name** for the new Data Sink. Optionally, add a **Description** and some **Tags** to identify the Sink.
{% endstep %}

{% step %}
Decide whether or not to include this Data sink info in the metrics and graphs of the [**Home**](/home.md) area.
{% endstep %}

{% step %}
Enter your **Twilio account SID**<mark style="color:red;">**\***</mark> [string identifier](https://www.twilio.com/docs/glossary/what-is-a-sid). Select it from your [Secrets](/settings/organization-settings/secrets-management.md) or create a new one.

Enter your [Twilio authorization token](https://help.twilio.com/articles/223136027-Auth-Tokens-and-How-to-Change-Them). Select it from your [Secrets](/settings/organization-settings/secrets-management.md) or create a new one.
{% endstep %}

{% step %}
In the [Secrets](/settings/organization-settings/secrets-management.md) area, **New secret** to create a new one:

* Give the secret a **Name**.
* Turn off the **Expiration date** option.
* Click **Add new value** and paste the corresponding value.
* Click **Save**.

<figure><picture><source srcset="/files/NeeWsSQzoChVxRIY76Nt" media="(prefers-color-scheme: dark)"><img src="/files/1oTccyPmgZJ1laY7IhZH" alt=""></picture><figcaption></figcaption></figure>

{% hint style="info" %}
Learn more about secrets in Onum in [this article](/settings/organization-settings/secrets-management.md).
{% endhint %}

You can now select the created secrets in the configuration.
{% endstep %}

{% step %}
Toggle **SMS** or **WhatsApp** and enter the **Phone number**<mark style="color:red;">**\***</mark> used to send the message.
{% endstep %}

{% step %}
Specify the **Maximum requests per second**<mark style="color:red;">**\***</mark>. The minimum value is `1`, and the maximum value is `100`.
{% endstep %}

{% step %}
If your organization uses proxy servers, activate the **Proxy configuration** toggle and establish the connection here:

* **Scheme**<mark style="color:red;">**\***</mark> - Choose the required proxy scheme (**HTTP** or **HTTPS**).
* **Host**<mark style="color:red;">**\***</mark> - Set the required proxy address.
* **Port**<mark style="color:red;">**\***</mark> - Set the required proxy port.
* **Username** - Enter your proxy username.
* **Password** - Select your proxy password from the list of your tenant's [Secrets](/settings/organization-settings/secrets-management.md) or create a new one.
  {% endstep %}
  {% endstepper %}

Click **Finish** when complete. Your new Data sink will appear in the **Data sinks** area list.

## Pipeline configuration

When it comes to using this Data sink in a [Pipeline](/pipelines.md), you must configure the following output parameters. To do it, simply click the Data sink on the canvas and select **Configuration**.

### Output configuration

<table><thead><tr><th width="169.859375">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><strong>Event field</strong><mark style="color:red;">*</mark></td><td>Select the incoming field containing the message to send on.</td></tr></tbody></table>

#### **Destination phone numbers**

<table><thead><tr><th width="169.8125">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><strong>Phone number</strong><mark style="color:red;">*</mark></td><td>Select the incoming field containing the destination phone numbers.</td></tr></tbody></table>

Click **Save** to save your configuration.