---
title: "Import Number"
method: POST
path: "/assistants/v1/numbers/{provider}"
tags: ["Phone Numbers"]
---

# Import Number

`POST /assistants/v1/numbers/{provider}`

Import number from provider. Please add provider credentials in the provider credentials section before you import an phone number.

## Path parameters

- `provider` string, required

## Request body

- object
  - `number` string, required — Phone number to import. Please provide in E.164 format, Ex: +1234567890
  - `label` string — Label for the number
  - `credentials` object — The credentials for the Twilio account. You can get these from the Twilio console. If you don't have an `authToken`, you can use the `apiKeySid` and `apiSecret` instead.
    - `accountSid` string — This is the account sid of the Twilio account.
    - `authToken` string — This is the auth token of the Twilio account. If you don't have an `authToken`, you can use the `apiKeySid` and `apiSecret` instead.
    - `apiKeySid` string — This is the api key sid of the Twilio account.
    - `apiSecret` string — This is the api secret of the Twilio account.

## Response `200`

Successfully imported the number.

- Number
  - `_id` string, objectId, required — Unique identifier of the number
  - `teamId` string, objectId, required — This is unique identifier of the team.
  - `number` string, required — Phone number associated with the team
  - `provider` object, required
    - `name` string — Name of the provider
  - `assistantId` string — ID of the associated assistant (if any)
  - `inboundEnabled` boolean — If true, inbound call is enabled. If false, inbound call is disabled.
  - `outboundEnabled` boolean — If true, outbound call is enabled. If false, outbound call is disabled.
  - `label` string — Label for the number

## Other responses

- `404` — Number not found at provider
- `406` — Provider credentials missing
- `500` — Internal server error.

---

[API](https://skmtc.net/interactly/apis/interactly-api.md) · [All operations](https://skmtc.net/interactly/apis/interactly-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/interactly/interactly-api/versions/f39cdcb1f4e4/schema)