---
title: "Enable Twilio phone number"
method: POST
path: "/v1/integrations/twilio/phone-numbers/enable"
tags: ["Credentials"]
---

# Enable Twilio phone number

`POST /v1/integrations/twilio/phone-numbers/enable`

## Request

- Base URL: `https://api.skyvern.com`
- URL: `https://api.skyvern.com/v1/integrations/twilio/phone-numbers/enable`
- Auth: API key in header `x-api-key`

Enable SMS forwarding for a Twilio phone number in the current organization.

## Request body

- EnablePhoneNumberRequest
  - `phone_number_sid` string, required
  - `confirm_takeover` boolean
  - `credential_id` string, nullable

## Response `200`

Successful Response

- OrganizationPhoneNumberResponse: Safe phone-number metadata without provider routing or cost secrets.
  - `phone_number_id` string, required
  - `organization_id` string, required
  - `sms_config_id` string, required
  - `phone_number` string, required
  - `provider` string, required
  - `credential_id` string, nullable
  - `price_cents` integer, nullable
  - `billing_exempt` boolean
  - `status` 'active' | 'disabled' | 'released' | 'quarantined' | 'provisioning' | 'quarantining' | 'releasing' | 'surrendering' | 'reversal_pending', required
  - `cancel_at` string, date-time, nullable
  - `quarantined_until` string, date-time, nullable
  - `created_at` string, date-time, required
  - `modified_at` string, date-time, required
  - `deleted_at` string, date-time, nullable

## Other responses

- `400`: The Twilio credential or phone number selection is invalid
- `404`: Twilio SMS is unavailable or the phone number was not found
- `409`: The phone number requires takeover confirmation or changed during setup
- `422`: Request validation failed
- `502`: The Twilio provider request failed
- `503`: The Twilio provider rate limit was reached

## Changes

- **2026-10-27** `dc7de12b8e80`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/skyvern-ai/apis/skyvern-api-2/changes/v1/integrations/twilio/phone-numbers/enable/post.md)

---

[API](https://skmtc.dev/skyvern-ai/apis/skyvern-api-2.md) - [All operations](https://skmtc.dev/skyvern-ai/apis/skyvern-api-2/llms.txt) - [OpenAPI document](https://skmtc.dev/skyvern-ai/apis/skyvern-api-2/revisions/64479cb160ff?raw)