***
id: 6feaface-f96a-44ae-9f5c-ccb9a62f7ae6
title: SIP trunking
slug: /voice/sip/trunking
x-custom:
author: rsowald
tags:
* 'product:voice'
* getting-started
* 'product:video'
* 'product:freeswitch'
***
SIP trunking is a popular option for customers who have an existing PBX phone system and would like to route SIP traffic through SignalWire without taking advantage of our application-level features.
Customers can create SIP endpoints programmatically or in their SignalWire Space and route traffic to those endpoints in the SignalWire network.
These endpoints could be many things, such as PBXs / Business Phone Systems, IP Phones, Softphones, Mobile Applications, and IoT devices, just to name a few.
The SIP trunk will allow any of these endpoints to connect with other external SIP endpoints or the Public Switched Telephone Network (PSTN).
## Creating a SIP Credential
In order to create a SIP Credential you can go to **Resources** in your [SignalWire Space](https://my.signalwire.com/resources/sips), and create a new **SIP Credential**.
Alternatively, you can create the endpoint programmatically with an [API call](/docs/apis/fabric/sip-endpoints/create-sip-endpoint).
```bash
curl -L -X POST 'https://$SPACE_NAME.signalwire.com/api/relay/rest/endpoints/sip' \
-u '$PROJECT_ID:$API_TOKEN' \
--data-raw '{
"username": "newCompany",
"password": "#SuperSecurePassword",
"caller_id": "New Company",
"encryption": "required"
}'
```
For an in-depth look at what these settings do and all of your SIP Dashboard tools, see the
[complete guide to your SIP Space](/docs/platform/voice/sip).
Note that the endpoint URL depends on the SIP URI that you name in your SIP Profile.
Manage your SIP Profile on your Dashboard or via [API](/docs/apis/relay-rest/sip-profile/update-sip-profile).
The username, password, and URL in your SIP endpoint settings will be used later to connect your SIP device.
After saving your settings, your endpoint is ready to accept traffic via its SIP URL, or you can set up a phone number to accept incoming PSTN calls.
## Phone Number to Handle Incoming Calls
To direct incoming traffic to your endpoint, you may wish to purchase a SignalWire phone number (DID) and connect it to your SIP endpoint.
Again, you have the option to do this via your Dashboard or programmatically.
See [Buying a Phone Number](/docs/platform/phone-numbers) for step-by-step instructions on searching for and purchasing a number, then open its settings by clicking on your new number in your Dashboard's Phone Numbers Space.
In the number's setting, click on the "Assign Resource" button and select your SIP endpoint resource.
{/* Shared component: Resource admonition */}
[Resources](/docs/platform/resources) are the building blocks of SignalWire applications. They include AI Agents, SWML Scripts, cXML Scripts, SIP Endpoints, and more.
If you prefer to use API calls, you will need the [Search for Available Phone Numbers](/docs/apis/relay-rest/phone-numbers/search-available-phone-numbers),
[Purchase a Phone Number](/docs/apis/relay-rest/phone-numbers/purchase-phone-number), and
[Update a Phone Number](/docs/apis/relay-rest/phone-numbers/update-phone-number) endpoints.
Change the Voice and Fax Settings to accept incoming calls as Voice Calls and handle calls using a SIP Endpoint.
Then you can search for the endpoint by username.
After saving your settings, incoming calls to this number will be immediately directed to your SIP endpoint.
## Configuring a SIP Device
To handle calls after they reach your SIP endpoint, you'll need to set up a SIP device.
Depending on what your SIP device is—be it a PBX or a SIP application or IP Phone—they require many of the same field parameters.
* SIP Username
* SIP Password
* Local SIP Port (In order to avoid malicious behavior, we suggest choosing a local SIP port that is not the typical SIP port.)
* SIP Server
* SIP Server Port
* SIP Server Transport Protocol
* Outbound Proxy
* Outbound Proxy Port
* Outbound Proxy Transport Protocol
Continuing with our earlier example, our parameters for a SIP IP Phone or soft client might be:
* SIP Username: newCompany
* SIP Password: #SuperSecurePassword
* Local SIP Port: 6050
* SIP Server: newCompany @xxx-xxx.sip.signalwire.com (refer to your Dashboard for the correct URL)
* SIP Server Port: 5061 (SIP Port: 5060, TLS Port 5061)
* SIP Server Transport Protocol: TLS
* Outbound Proxy: (supported but not generally needed)
* Outbound Proxy Port: (supported but not generally needed)
* Outbound Proxy Transport Protocol: (supported but not generally needed)
## Security
Security is important to us!
Communications over the open internet should be secure both in signalling and in media.
We feel so strongly about security that we decided to support TLS (Transport Layer Security) and SRTP (Secure Real-time Transport Protocol) by default.
When setting up your SIP endpoint, specify which codecs and ciphers to support, but you must choose at least one.
Be aware that not all codecs and ciphers are compatible with every SIP device, so refer to your device documentation for compatibility.
## Call Logs
All call logs can be viewed in the "Logs" tab of your SignalWire Dashboard.
Here, you can see details for each call including the SignalWire resource type and cost.
Additional details for each call are available by clicking on the resource name.
## Wrap Up
Setting up a SIP trunk like this may be the solution for you if all you need is to direct SIP traffic in and out of your existing system.
However, the flip side to that is there will be no features available on the trunk such as recording, IVR or any form of call control.
If you want to explore SIP options that take advantage of SignalWire's services and features, check out our guide to [SIP Domain Applications](/docs/platform/voice/sip/domain-applications).
## In the Legacy Dashboard
{/* Shared component: UI Accordion for new vs legacy dashboard */}
**New Dashboard**: You have a **Resources** tab in the left sidebar.
**Legacy Dashboard**: You have separate tabs for SIP, LaML, RELAY, etc.
Navigate to the [Phone Numbers tab](https://my.signalwire.com?page=phone_numbers), click the phone number
that you would like to register, and then click `Edit Settings` button. From here, in the
`Handle Incoming Calls` section, select `SIP Endpoint`, then input the SIP address you created.
Register SIP Endpoint to a SignalWire Phone Number