---
"@context": https://schema.org
"@type": TechArticle
"@id": https://www.twilio.com/docs/api/errors/30012#article
headline: "30012: TTL is too small"
url: https://www.twilio.com/docs/api/errors/30012
inLanguage: en
dateModified: 2026-06-09T11:00:42.000Z
author:
  "@type": Organization
  name: Twilio Developer Education Team
publisher:
  "@type": Organization
  name: Twilio
---

# 30012: TTL is too small

Log Level: ERROR

## Description

Twilio returned this error because the `ValidityPeriod` you provided for the message is below the minimum supported value. `ValidityPeriod` controls how long Twilio attempts to deliver an outbound message before the message expires.

### Possible causes

* The request includes a `ValidityPeriod` value that is lower than the minimum allowed value for Programmable Messaging.
* Your application is passing an incorrectly calculated TTL value when creating a message.
* A unit conversion issue caused your application to send a value in the wrong format or range.

### Possible solutions

* Update your request to use a larger `ValidityPeriod` value.
* Check how your application calculates TTL and confirm it sends the correct value in seconds.
* Review your message creation logic and validate outbound request parameters before sending them to Twilio.
* If you do not need a custom TTL, remove the `ValidityPeriod` parameter and let Twilio use the default behavior.

#### Additional resources

* [Programmable Messaging API overview](/docs/messaging/api)
* [Message resource](/docs/messaging/api/message-resource)
* [Manage queueing and latency for SMS messages](/docs/messaging/guides/scaling-queueing-latency)