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 |