# Import Exotel number (/docs/api-reference/phone-numbers/importExotelNumber)

> Import an Exotel number by providing your Exotel credentials.



**POST** `/phone_number/import/exotel`

Import an Exotel number by providing your Exotel credentials.

```yaml
operationId: importExotelNumber
requestBody:
  required: true
  content:
    application/json:
      schema:
        type: object
        required:
          - exotel_phone_number
          - exotel_api_key
          - exotel_api_token
          - exotel_subdomain
          - exotel_account_sid
          - exotel_app_id
        properties:
          exotel_phone_number:
            type: string
            description: Exotel phone number in E.164 format.
            example: '+919876543210'
          exotel_api_key:
            type: string
            description: Your Exotel API key.
          exotel_api_token:
            type: string
            description: Your Exotel API token.
          exotel_subdomain:
            type: string
            description: Your Exotel subdomain (e.g. `your-account.in.exotel.com`).
          exotel_account_sid:
            type: string
            description: Your Exotel account SID.
          exotel_app_id:
            type: string
            description: The Exotel App ID configured for the bot.
          name:
            type: string
            description: Optional friendly name for the imported number.
responses:
  '200':
    description: Exotel number imported.
    content:
      application/json:
        schema:
          type: object
          properties:
            success:
              type: boolean
            message:
              type: string
            id:
              type: integer
              description: ID of the newly imported phone number record. Use this with `/phone_number/attach`.
        example:
          success: true
          message: Number added successfully
          id: 3360
```

**Python SDK**

```python
import os
from omnidimension import Client

# Initialize the client
api_key = os.environ.get('OMNIDIM_API_KEY')
client = Client(api_key)

# Import an existing Exotel number
response = client.phone_number.import_exotel_number(
    exotel_phone_number="02261234567",
    exotel_api_key="your_exotel_api_key",
    exotel_api_token="your_exotel_api_token",
    exotel_subdomain="your_subdomain",
    exotel_account_sid="your_account_sid",
    exotel_app_id="your_app_id",
    name="My Exotel Number"  # Optional
)
print(response)
```

**curl**

```bash
curl -X POST "https://backend.omnidim.io/api/v1/phone_number/import/exotel" \
  -H "Authorization: Bearer $OMNIDIM_API_KEY"
```