Set a SIM's SMS limit using the REST API

SMS Limits are a way limit the number of outbound SMS messages a device can send during a billing period. SMS limits are commonly used to protect your SIMs against fraud and theft, or lowered to limit unexpected charges.

Upon reaching the limit, your SIM will be paused by the system. This means that the SIM can no longer send SMS or data until the SMS limit is increased or until the next billing period begins. The organization's owner will also get an email notifying them of the pause.

Note: The default SMS limit for all SIMs is 100 outbound SMS messages. SMS limits are tracked against all installed profiles on the SIM. When a SIM reaches the limit you set, it is paused.

What happens if a SIM reaches its SMS limit?

All profiles on the SIM will be paused until the SIM’s next billing period. To unpause the SIM you will need to increase the SMS limit, which will unpause your SIMs. This process typically takes around 10 minutes before the SIM will resume activity on our network.

What is my SMS limit and can I change it?

The default SMS limit for all SIMs is 100 outbound SMS messages. SMS limits cannot be removed from a SIM. Using our REST API, you can lower the SMS limit to any value you choose, or raise it back to 100. Customers on Hologram Advanced or Hologram Premium plans can increase SMS limits over 100.

How do I request an SMS limit increase?

Limited functionality
Customers on Hologram Advanced and Hologram Premium plans can increase SMS limits for a SIM using our REST API, or reach out to our teams for support.

Please contact our Support Team to request an SMS limit increase, contact our Sales Team if you work with an account executive.

Changing SMS limits for a SIM

You can raise or lower SMS limits with Hologram’s REST API, using the endpoints below. linkid should match the linkid of the profile to update. Changing an SMS limit will apply the change to all installed profiles, and is enforced at the SIM level.

Single profile update endpoint

POST https://dashboard.hologram.io/api/1/links/cellular/linkid/limit/sms

Sample request

{  "limit": 10 }

Bulk profile update endpoint

POST https://dashboard.hologram.io/api/1/links/cellular/limit/sms

Sample request

{
	"linkids": [500,600,700],
	"limit": 5
}
Was this article helpful?
0 out of 0 found this helpful