---
title: "Add Twilio Number"
method: POST
path: "/api/v1/phone-numbers/add-twilio"
tags: ["PhoneService"]
---

# Add Twilio Number

`POST /api/v1/phone-numbers/add-twilio`

## Request body

- AddTwilioNumberRequest
  - `phone_number` string, required — Phone number in E.164 format
  - `number_sid` string, required — Twilio number SID
  - `friendly_name` string — Friendly name
  - `price` number — Monthly price

## Response `200`

Successful response

- AddTwilioNumberResponse
  - `success` boolean
  - `message` string
  - `data` PurchasedNumber
    - `id` string — Record ID
    - `telephony_id` string — Associated telephony ID
    - `subscription_id` string — Associated subscription ID
    - `inbound_trunk_id` string — Inbound SIP trunk ID
    - `outbound_trunk_id` string — Outbound SIP trunk ID
    - `number` string — Phone number in E.164 format
    - `friendly_name` string — Human-readable label
    - `per_minute_price_inbound` integer — Per-minute inbound price
    - `per_minute_price_outbound` integer — Per-minute outbound price
    - `price` integer — Monthly price
    - `region` string — Region
    - `iso_country` string — ISO country code
    - `is_active` boolean — Whether the number is active
    - `created_at` string — Creation timestamp
    - `updated_at` string — Last update timestamp

---

[API](https://skmtc.net/ravan/apis/agni-api.md) · [All operations](https://skmtc.net/ravan/apis/agni-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ravan/agni-api/revisions/48f45dc58534/schema)