> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sigmamind.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Bring Your Own Number (BYO)

> How to integrate your own number with SigmaMind

You can bring your own numbers from supported telephony providers into **SigmaMind** using **[SIP Trunking](/documentation/numbers/sip-integration/sip-trunking)**.

<Note>
  Currently, we support the following providers:

  * **Twilio**
  * **Telnyx**
</Note>

## Dashboard

You can purchase and assign agents to numbers directly from the **SigmaMind Dashboard**.

* During purchase, you may optionally specify preferred **area codes**.

<div className="pl-8">
  <img src="https://mintcdn.com/sigmamindai/TTkOrqvwQ_u0Zt8b/images/numbers/bring-your-own-number.png?fit=max&auto=format&n=TTkOrqvwQ_u0Zt8b&q=85&s=6e3acd0b7b98756304c79093c5f4cba6" alt="New Phone Number" height="250" width="500" className="rounded-lg" data-path="images/numbers/bring-your-own-number.png" />
</div>

* After purchase, you can update the number’s **nickname** for easier identification.

* Once assigned, you can configure both **inbound** and **outbound agents**.

<div className="pl-8">
  <img src="https://mintcdn.com/sigmamindai/TTkOrqvwQ_u0Zt8b/images/numbers/assign-agents.png?fit=max&auto=format&n=TTkOrqvwQ_u0Zt8b&q=85&s=8c245efd762924f9ff15728da7346623" alt="New Phone Number" height="250" width="500" className="rounded-lg" data-path="images/numbers/assign-agents.png" />
</div>

<Tip>
  After setup, your number will be ready to accept **inbound calls** if an inbound agent has been assigned.\
  Give it a try by calling the number to confirm it’s working!
</Tip>

## API

If you prefer programmatic control, you can use our APIs.\
Refer to the [Create Phone Number API Reference](/api-reference/phone-numbers/create-phone-number) for details on all available parameters.

* Numbers are **yours indefinitely** once purchased.
* Manage your purchased numbers in the [Numbers Dashboard](https://dashboard.sigmamind.ai/app/ai/phone-numbers).
* You can assign **different inbound and outbound agents**.

<CodeGroup>
  ```sh Bring Your Own Number (BYO) theme={null}
  curl --location 'https://api.sigmamind.ai/v1/phone-numbers' \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: key_C6HL3Goru7Q.TlI5kZOKPmDM03Gt39nRBEnxrL****************' \
  --data '{
      "friendlyName": "Inbound Agent 2",
      "phoneNumber": "+14159876543",
      "provider": "byo",
      "trunkName": "SigmaMing SIP Trunk",
      "trunkUsername": "admin",
      "trunkPassword": "password",
      "terminationSipURI": "sip.telnyx.com"
  }'
  ```

  ```sh Purchase New Number theme={null}
  curl --location 'https://api.sigmamind.ai/v1/phone-numbers' \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: key_C6HL3Goru7Q.TlI5kZOKPmDM03Gt39nRBEnxrL****************' \
  --data '{
      "friendlyName": "Inbound Agent 1",
      "provider": "telnyx"
  }'
  ```
</CodeGroup>