# HTTP OUT Trunks HTTP OUT SMS trunks allow you to send outbound SMS messages from your DID numbers to a specified HTTP(s) endpoint. This enables direct integration with your own systems or third-party services. **Create Trunk** Create and configure a new SMS HTTP OUT Trunk. [Create HTTP OUT Trunk](#user-panel-sms-http-out-trunk-create) **View or Regenerate Credentials** Access or update HTTP OUT trunk credentials. [View or Regenerate HTTP OUT Trunk Credentials](#user-panel-sms-http-out-trunk-credentials) **Send SMS** Send a test SMS message from HTTP OUT trunk. [Send SMS](#user-panel-sms-sending) **Edit Trunk** Update the settings of an existing trunk. [Edit HTTP OUT SMS Trunk](#user-panel-sms-http-out-trunk-edit) **Delete Trunk(s)** Remove one or more trunks from your account. [Delete HTTP OUT Trunk(s)](#user-panel-sms-http-out-trunk-delete) --- ## Create HTTP OUT Trunk ### Step 1: Start Creating HTTP OUT Trunk In the user panel menu, navigate to **SMS > SMS Trunks**. Click the **Create New** button in the top-right corner and select **HTTP OUT** from the dropdown menu. [![Navigating to create a new SMS to HTTP OUT Trunk.](../../_images/fig169.png)](../../_images/fig169.png) **Fig. 1.** Navigating to create a new SMS to HTTP OUT Trunk. ### Step 2: Configure HTTP OUT Trunk Enter the general information required to set up your SMS to HTTP OUT trunk. Provide a descriptive friendly name, configure the callback URL for delivery notifications, specify allowed IP addresses, and define the sender ID settings for outbound SMS. [![SMS to HTTP OUT Trunk configuration window.](../../_images/fig254.png)](../../_images/fig254.png) **Fig. 2.** SMS to HTTP OUT Trunk configuration window. #### General Settings > | Setting | Description | > | --- | --- | > | **Friendly name** | A unique name to identify this trunk. | > | **Callback URL** | URL to get the delivery status of the text messages you have sent. The server will call your callback URL and post SMS delivery notifications. | > | **Allowed IP addresses** | IP addresses from which access to the API is allowed in the format (IPv4|IPv6)[/mask] (not mandatory). Allow all IP addresses if empty. | #### Source Address Settings The **Source Address Settings** section controls which DID numbers can be used as the sender ID for outbound SMS. Use the **Allow any DID(s) for SMS OUT** toggle to choose how sender IDs are assigned: > - **Toggle on (default):** All DIDs with Outbound P2P SMS enabled in your account can be used as the sender ID. > - **Toggle off:** You can specify which DIDs are allowed. To do this, select numbers from the **Available Source Addresses** list and add them to the **Allowed Source Addresses** list. Only the numbers you add will be available as sender IDs. [![Source address selection for SMS to HTTP OUT Trunk.](../../_images/gif110.gif)](../../_images/gif110.gif) **Fig. 3.** Source address selection for SMS to HTTP OUT Trunk. Note When the **Allow any DID(s) for SMS OUT** toggle is turned off, the **Available Sender IDs** list shows only DIDs that support outbound P2P SMS. ### Step 3: Create the Trunk Click **Create** at the bottom of the page to save the new trunk. --- ## View or Regenerate HTTP OUT Trunk Credentials > 1. Navigate to **SMS > SMS Trunks** in the user panel. > 2. Locate the HTTP OUT trunk you want to manage. > 3. Click the [![Credentials button](../../_images/credentials1.png)](../../_images/credentials1.png) > key icon in the **Credentials** column to open the credentials window. [![Credentials pop-up window for SMS to HTTP OUT Trunk.](../../_images/fig_credentials1.png)](../../_images/fig_credentials1.png) **Fig. 4.** Credentials button for SMS to HTTP OUT Trunk. *View Credentials* In the credentials pop-up window, you can see the HTTP OUT trunk **Username**, **Password**, and **Host(s)**. Click the **eye** icon to show the password. **Host(s)** lists one endpoint for each DIDWW location: | Location | Endpoint | | --- | --- | | **US, NY** | `https://us.sms-out.didww.com/outbound_messages` | | **NL, AMS** | `https://eu.sms-out.didww.com/outbound_messages` | HTTP OUT trunks have no location setting. To use a location, send your requests to its endpoint. See [Endpoints & Headers](technical-data/http-specification.html#sms-out-spec-endpoints-headers). [![Viewing credentials for an SMS to HTTP OUT Trunk.](../../_images/fig_credentials2.webp)](../../_images/fig_credentials2.webp) **Fig. 5.** Viewing credentials. *Regenerate Credentials* Important The password is updated immediately when you regenerate credentials. Update all integrations right away to avoid authentication failures. 1. In the credentials pop-up window, click **Regenerate** next to the **Password** field to generate new credentials. 2. Copy the new credentials and update any systems that use them. [![Regenerating password for SMS to HTTP OUT Trunk.](../../_images/fig_credentials2-regenerate.webp)](../../_images/fig_credentials2-regenerate.webp) **Fig. 6.** Regenerating credentials. --- ## Send SMS From the SMS Trunks list, you can use the built-in tool to send a test message or a one-time message through any of your HTTP OUT trunks. ### Before You Begin Before sending messages, make sure you have: > 1. A DID number with outbound P2P SMS enabled. If you don't have one, see [How to Buy DID Numbers](../../phone-numbers/buy-numbers/how-to-buy.html#user-panel-buy-numbers-process). > 2. Sender IDs configured in your HTTP OUT trunk. For details, see [Source Address Settings](#user-panel-sms-http-out-trunk-source-address-settings). ### Step 1: Open the Send SMS Tool > 1. In the user panel menu, navigate to **SMS > SMS Trunks**. > 2. Locate the desired HTTP OUT trunk and click the [![Actions button](../../_images/three_dots_action_button1.png)](../../_images/three_dots_action_button1.png) > button next to it. > 3. Select **Send SMS** from the dropdown menu. [![Accessing the SMS sending tool.](../../_images/send1.png)](../../_images/send1.png) **Fig. 7.** Accessing the SMS sending tool. ### Step 2: Compose the Message In the Send SMS window, select a source address, enter the destination number, and type your message. | Field | Description | | --- | --- | | **Source Address** | Select one of your authorized DID numbers with outbound P2P SMS enabled. | | **Destination** | Enter the recipient's phone number in international format (for example, `15551234567`). | | **Text** | Enter the message content. | [![Composing an SMS message.](../../_images/send2.png)](../../_images/send2.png) **Fig. 8.** Composing an SMS message. ### Step 3: Send the Message Click **Send** to deliver your message. Note The system automatically selects the message encoding: > - **GSM-7** is used for Latin-based characters. Each SMS fragment can contain up to 160 characters. > - **UCS-2** is used for non-Latin characters. Each SMS fragment can contain up to 70 characters. Billing is based on SMS fragments, not on the message as submitted. If a long SMS is split into multiple fragments, each fragment is billed separately. --- ## Edit HTTP OUT SMS Trunk > 1. In the user panel menu, navigate to **SMS > SMS Trunks**. > 2. Locate the trunk you wish to edit and click the [![Actions button](../../_images/three_dots_action_button1.png)](../../_images/three_dots_action_button1.png) > button next to it. > 3. Select **Edit** from the dropdown menu. > 4. On the **Edit HTTP OUT Trunk** page, modify the settings as needed. > 5. Click **Submit** to apply your changes. > > [![Edit option for SMS to HTTP OUT Trunk.](../../_images/fig_edit.png)](../../_images/fig_edit.png) > > > **Fig. 9.** Edit option for SMS to HTTP OUT Trunk. --- ## Delete HTTP OUT Trunk(s) You can delete a single SMS to HTTP OUT trunk or multiple trunks at once by using batch actions. *Delete a Single Trunk* 1. Navigate to the **SMS Trunks** list page. 2. Locate the trunk you wish to remove and click the [![Actions button](../../_images/three_dots_action_button1.png)](../../_images/three_dots_action_button1.png) button next to it. 3. Select **Delete** from the dropdown menu. 4. In the confirmation pop-up window, click **Delete** to permanently remove the trunk. [![Delete option for SMS to HTTP OUT Trunk.](../../_images/fig_delete.png)](../../_images/fig_delete.png) **Fig. 10.** Delete option for SMS to HTTP OUT Trunk. *Delete Multiple Trunks* 1. Navigate to the **SMS Trunks** list page. 2. Select the trunks you wish to delete by checking the boxes next to them. 3. At the bottom of the page, click **Batch Actions** and select **Delete Trunks**. 4. In the confirmation pop-up window, click **Delete** to permanently remove the selected trunks. [![Batch delete option for SMS to HTTP OUT Trunks.](../../_images/fig_delete_batch.png)](../../_images/fig_delete_batch.png) **Fig. 11.** Batch delete option for SMS to HTTP OUT Trunks. --- ## Related Resources **How to Send Messages** Learn how to send SMS messages directly from the DIDWW User Panel using an HTTP OUT Trunk. [Send SMS](#user-panel-sms-sending) **HTTP Specification** See full technical details for HTTP message delivery formats and variables. [HTTP Specification](technical-data/http-specification.html#user-panel-sms-http-specification) On this page