---
title: "Import from Twilio"
method: POST
path: "/phone-numbers/import/twilio"
tags: ["Phone Numbers"]
---

# Import from Twilio

`POST /phone-numbers/import/twilio`

## Request

- Base URL: `https://app.freyavoice.ai/api/v2`
- URL: `https://app.freyavoice.ai/api/v2/phone-numbers/import/twilio`
- Auth: HTTP bearer

Imports an existing Twilio phone number into the workspace. The phone number must already be provisioned in your Twilio account.

## Request body

- object
  - `phoneNumber` string, required
  - `workspaceId` string, uuid, required

## Response `200`

Phone number imported

- object
  - `success` true, required
  - `data` object, required
    - `message` string, required
    - `result` object, required
      - `success` boolean, required
      - `message` string, required
      - `phoneNumber` object
        - `id` string, required
        - `number` string, required
        - `friendlyName` string, nullable
        - `workspaceId` string, required
        - `userId` string, required
        - `config` object, nullable
          - `capabilities` object
            - `voice` string
            - `sms` boolean
          - `voiceConfig` string
          - `messagingConfig` string
          - `emergencyCalls` boolean
          - `configType` 'agents' | 'workflows'
          - `inboundAgentId` string
          - `outboundAgentId` string
          - `inboundWorkflowId` string
          - `outboundWorkflowId` string
          - `originationUri` string
          - `sipInbound` object
            - `enabled` boolean, required
          - `sipOutbound` object
            - `enabled` boolean, required
            - `endpoint` string
            - `port` number
            - `username` string
            - `password` string
            - `transportProtocol` 'UDP' | 'TCP' | 'TLS'
            - `secureMedia` boolean
            - `headers` object[]
              - …
        - `createdAt` string, required
        - `updatedAt` string, required
        - `inboundAgentName` string, nullable
        - `outboundAgentName` string, nullable
        - `inboundWorkflowName` string, nullable
        - `outboundWorkflowName` string, nullable

## Other responses

- `400`: Validation error
- `401`: Missing or invalid token
- `404`: Phone number not found in Twilio
- `500`: Server error

---

[API](https://skmtc.dev/freyavoice/apis/freyavoice-api.md) - [All operations](https://skmtc.dev/freyavoice/apis/freyavoice-api/llms.txt) - [OpenAPI document](https://skmtc.dev/freyavoice/apis/freyavoice-api/revisions/153d120f0c73?raw)