Skip to content

Limits

These are the limits the API enforces. A request over a limit fails with the error shown and changes nothing.

Your plan sets the counts below. The numbers that apply to your organization, with your add-ons and any limit SMSFabric set for you, are in GET /v1/org/plan (Plans) and in the portal under Plan and usage. The default plans:

Limit Free Starter Pro Business Enterprise
Phones 1 1 5 15 No fixed limit
Seats (members plus open invitations) 1 2 5 15 No fixed limit
Messages per day 50 500 2,500 10,000 No fixed limit
Messages per month 500 5,000 25,000 150,000 No fixed limit
API keys 1 2 10 50 No fixed limit
Webhook endpoints 1 2 10 50 No fixed limit
API requests per minute, per key 60 300 1,200 3,000 6,000
Recipients per request 10 100 100 100 100
Message history 7 days 30 days 90 days 365 days 730 days
Pools No No Yes Yes Yes
Scheduled sends, CSV export No Yes Yes Yes Yes
Sent with SMSFabric line on every message Yes No No No No

SMSFabric can change these defaults; GET /v1/plans always returns the current price list.

Where each limit is checked:

Limit Checked at Over the limit
Phones POST /v1/devices/pairing-tokens, and again when the phone pairs 403 plan_limit_reached
Seats POST /v1/org/invitations, and when an invitation is accepted 403 plan_limit_reached
API keys, webhook endpoints POST /v1/api-keys, POST /v1/webhooks 403 plan_limit_reached
Recipients per request POST /v1/messages 403 plan_limit_reached
Messages per day and per month POST /v1/messages, POST /v1/verifications and every message a campaign sends. One per recipient; sandbox sends, blacklisted recipients and inbound messages are not counted. Days and months are UTC. 429 quota_exceeded
Pools, scheduled sends, CSV export POST /v1/pools, scheduledAt on POST /v1/messages, GET /v1/messages/export.csv 403 feature_not_in_plan
SIMs per phone When the phone reports its SIMs The lowest slots are kept; no error
Message history, audit log A sweep every 6 hours deletes older messages and audit entries

A running campaign pauses when the allowance is used up; resume it once the allowance resets. The owner and billing members are emailed when the organization reaches 80% of the monthly allowance, and again at 100%. See Plan errors.

Limit Value Over the limit
Recipients per POST /v1/messages 100, or fewer on your plan 400 validation_failed; 403 plan_limit_reached over the plan’s number
Body length 1,600 characters 400 validation_failed
metadata 4 KB of JSON 400 validation_failed
scheduledAt Up to 1 year ahead 400 validation_failed
Stats period (GET /v1/messages/stats) 1 to 31 days 400 validation_failed
Encoding One segment Each part of a longer text
GSM7 160 characters 153 characters
UCS2 (Arabic, emoji, any non-GSM character) 70 characters 67 characters

The GSM characters ^ { } \ [ ] ~ | € take two places each. A 1,600-character body is at most 11 GSM7 segments or 24 UCS2 segments.

Limit Value Over the limit
JSON request body 100 KB 413 payload_too_large
Requests per API key Your plan’s rate (60 to 6,000 per minute, see above) 429 rate_limited
Requests per signed-in user 300 per minute 429 rate_limited
Requests per IP 600 per minute 429 rate_limited
Requests per organization 1,200 per minute 429 rate_limited
Bulk operations (imports, contact export, campaign estimate and start) 20 per minute per key or user 429 rate_limited
Page size (limit) 1 to 200, default 50 400 validation_failed
Idempotency-Key 1 to 255 characters, kept 24 hours 400 invalid_idempotency_key

See Rate limits.

Limit Value
Pairing token lifetime 10 minutes
Online window A phone is offline 2 minutes after its last check-in
Time for a phone to accept a message 10 seconds, then it moves to another phone in the pool
Default cooldown between messages on one phone 3 s plus up to 2 s jitter (0 to 600 s each, in preferences)
Retries after a phone reports a failure 2 by default (0 to 10)
SIM dailyLimit 0 to 100,000, or none
SIMs per phone 8
Limit Value Over the limit
Code length 4 to 10 digits, default 6 400 validation_failed
Code lifetime 60 to 1,800 seconds, default 600 400 validation_failed
Custom template 320 characters, must contain {{code}} 400 validation_failed
Wrong codes 5, then denied
Codes per number 3 per 10 minutes 429 verify_resend_limited
Codes per country 150 per hour (1 to 1,000) 429 verify_velocity_exceeded
Codes per organization 300 per hour (1 to 1,000) 429 verify_velocity_exceeded
Distinct numbers in one range 10 per 10 minutes (3 to 50) 403 verify_prefix_blocked
Limit Value
First and last name 120 characters each
Tags per contact 20, each 1 to 40 characters
Custom fields 50 keys, 4 KB, values up to 500 characters
Consent text 500 characters
Groups per create request 20
Group name 120 characters, description 500
Contacts per add or remove members request 1,000
Limit Value Over the limit
File size 5 MB 413 payload_too_large
Rows 100,000 400 csv_too_many_rows
Columns 50 400 csv_too_many_columns
Cell 1,000 characters 400 csv_cell_too_long
Tags added to every row 5 400 validation_failed
Skipped rows listed in the report First 500
Limit Value
Template or campaign name 120 characters
Template or campaign body 1,600 characters
Variable fallback 60 characters
Audience 20 groups and 20 tags
ratePerMinute 1 to 6,000, default 120
scheduledAt Up to 1 year ahead
Limit Value
Webhook URL https, public address, 2,048 characters
Response time for a delivery 10 seconds
Delivery attempts 8, over about 23.5 hours
Signature tolerance (recommended) 300 seconds
Listen streams open at once 5 per organization (429 too_many_listeners)
Listen stream lifetime 5 minutes, then the client opens the next one
Listen streams opened 30 per minute per key or user
API key name 120 characters
API key IP allowlist 50 entries
Old secret after a key rotation Valid 24 hours
Team invitation Valid 7 days
User access token 15 minutes