> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hologram.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Set a SIM's SMS limit using the REST API

> Configure outbound SMS limits per SIM and understand pause behavior.

Each SIM has an outbound SMS limit. The **default is 100 outbound SMS per SIM**, tracked across all installed profiles. SMS limits cannot be removed.

Using the REST API, you can **lower** a SIM's SMS limit, or **raise it back up to the 100 default**. Raising the limit above 100 requires an active contract — see [How do I request an SMS limit increase?](#how-do-i-request-an-sms-limit-increase) below.

## What happens when a SIM reaches its SMS limit?

When a SIM hits its SMS limit, it is [paused](/dashboard/sim-actions/pause-resume-sims) until the next billing period, and the organization owner receives an email notification. To resume the SIM sooner, increase its SMS limit; the SIM typically resumes activity within about 10 minutes.

## How do I request an SMS limit increase?

<Info>
  **Limited access.**
  Customers with an active contract can request an SMS limit increase by contacting our [support team](/guides/get-started/contact-support).
</Info>

## How do I update an SMS limit using the REST API?

You can decrease the SMS limit on a SIM using the REST API, or increase the limit back to 100.

```bash cURL theme={null}
curl --request POST \
  'https://dashboard.hologram.io/api/1/links/cellular/limit/sms' \
  -u apikey:YOUR_HOLOGRAM_API_KEY \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "linkids": [YOUR_LINK_ID_1, YOUR_LINK_ID_2],
    "limit": YOUR_SMS_LIMIT
  }'
```