---
title: "Apply a SIM configuration to a single SIM card"
method: POST
path: "/simcards/{simCardId}/configure/"
tags: ["SIM Configuration"]
---

# Apply a SIM configuration to a single SIM card

`POST /simcards/{simCardId}/configure/`

## Request

- Base URL: `https://dashboard.hologram.io/api/1`
- URL: `https://dashboard.hologram.io/api/1/simcards/{simCardId}/configure/`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/hologram/apis/hologram-rest-api-v1/docs/simcards/:simCardId/configure/post.ts> (a function with typed inputs; its response is checked against the schema)

Dispatches a configuration change to the specified SIM card. Non-admin users may only target a SIM card they can access and configurations allowed by their plan.

## Path parameters

- `simCardId` integer, required

## Request body

- object
  - `configuration_id` integer, required: ID of the SIM configuration to apply
  - `immediate` boolean: Skip the configuration queue; by default operations are queued at the time of the next usage update. If set and our backend is too busy to process the request in realtime this endpoint will return a 429 rate limit error until there is space for the request.
  - `plan_id` integer: Change the device plan simultaneously; requires zone and orgid
  - `zone` string: Required when plan_id is provided
  - `orgid` integer: Required when plan_id is provided

## Response `200`

OK

- ConfigureSimCardsResponse
  - `success` boolean: Indicates whether the request was successful.
  - `data` ConfigureSimCardsData
    - `requested_deviceids` integer[]: Device IDs for which configuration was successfully dispatched
    - `requested_simcardids` integer[]: SIM card IDs for which configuration was successfully dispatched
    - `async_request_id` integer: Parent async change request tracking this configure-sim operation
    - `child_ids` integer[]: IDs of per-device child async change requests under async_request_id
    - `warnings` string[]

## Other responses

- `400`: Invalid configuration, inaccessible SIM card, incompatible plan, or no valid devices after validation
- `401`: Unauthorized
- `429`: Immediate configuration temporarily unavailable due to eUICC queue backlog

---

[API](https://skmtc.dev/hologram/apis/hologram-rest-api-v1.md) - [All operations](https://skmtc.dev/hologram/apis/hologram-rest-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/hologram/apis/hologram-rest-api-v1/revisions/1bc07dcd1631?raw)