---
title: "Request enabling voice on a SIM card"
method: POST
path: "/sim_cards/{id}/actions/enable_voice"
tags: ["SIM Cards"]
---

# Request enabling voice on a SIM card

`POST /sim_cards/{id}/actions/enable_voice`

This API enables voice calling on a SIM card. When a <code>connection_id</code> is provided, the SIM is associated with the specified Mobile Voice Connection. The connection must be owned by the same user and of type <code>mobile_voice</code>.<br/>
The API will trigger an asynchronous operation called a SIM Card Action. The status of the SIM Card Action can be followed through the [List SIM Card Action](https://developers.telnyx.com/api-reference/sim-card-actions/list-sim-card-actions) API.

## Path parameters

- `id` string, uuid, required

## Request body

- object
  - `connection_id` string — The identifier of the Mobile Voice Connection to associate with this SIM card. The connection must be owned by the same user and of type <code>mobile_voice</code>. If omitted, voice is enabled without a connection association.

## Response `202`

Successful Response

- object
  - `data` WirelessSIMCardAction — This object represents a SIM card action. It allows tracking the current status of an operation that impacts the SIM card.
    - `action_type` 'enable' | 'enable_standby_sim_card' | 'disable' | 'set_standby' | 'enable_voice' | 'disable_voice' — The operation type. It can be one of the following: <br/> <ul> <li><code>enable</code> - move the SIM card to the <code>enabled</code> status</li> <li><code>enable_standby_sim_card</code> - move a SIM card previously on the <code>standby</code> status to the <code>enabled</code> status after it consumes data.</li> <li><code>disable</code> - move the SIM card to the <code>disabled</code> status</li> <li><code>set_standby</code> - move the SIM card to the <code>standby</code> status</li> <li><code>enable_voice</code> - enable voice calling on the SIM card</li> <li><code>disable_voice</code> - disable voice calling on the SIM card</li> </ul>
    - `created_at` string — ISO 8601 formatted date-time indicating when the resource was created.
    - `id` string, uuid — Identifies the resource.
    - `record_type` string
    - `settings` object, nullable — A JSON object representation of the action params.
    - `sim_card_id` string, uuid — The related SIM card identifier.
    - `status` object
      - `reason` string — It describes why the SIM card action is in the current status. This will be <code>null</code> for self-explanatory statuses, such as <code>in-progress</code> and <code>completed</code> but will include further information on statuses like <code>interrupted</code> and <code>failed</code>.
      - `value` 'in-progress' | 'completed' | 'failed' | 'interrupted' — The current status of the SIM card action.
    - `updated_at` string — ISO 8601 formatted date-time indicating when the resource was updated.

## Other responses

- `400` — Bad Request — invalid connection_id format
- `422` — Unprocessable Entity
- `default` — Unexpected error

---

[API](https://skmtc.net/team-telnyx/apis/telnyx-api-2.md) · [All operations](https://skmtc.net/team-telnyx/apis/telnyx-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/team-telnyx/telnyx-api-2/revisions/1571b0380bd7/schema)