Limits
Rate limits
Section titled “Rate limits”| Who | Limit |
|---|---|
| Each agent (API key or OAuth connection) | 20 requests/second and 1 200/minute. A batch counts once |
| Unauthenticated calls, per IP | 10/second and 120/minute |
| OAuth dynamic client registration, per IP | 10/minute |
Over a limit: 429 RATE_LIMITED with Retry-After (seconds).
Requests and fields
Section titled “Requests and fields”| What | Limit |
|---|---|
| Request body | 2 MB (413 PAYLOAD_TOO_LARGE) |
| Items per upsert or activity batch | 100 |
perPage (page lists) |
100 (default 50) |
limit (cursor lists) |
100 (timelines default 30) |
Search limit |
50 (default 10); q ≥ 2 characters |
MCP query_records filters |
30 |
Idempotency-Key |
200 characters; replayed for 24 hours |
Mety-Agent-Run |
100 characters |
Activity body |
100 000 characters |
Activity externalId |
500 characters |
Activity occurredAt |
At most 5 minutes in the future |
Compact bodies (compact) |
Truncated to 500 characters |
Organization name |
200; description 20 000 |
tags |
30 per record, 50 characters each |
customFields |
50 keys, 16 kB in total; values string, number, boolean or null |
| Custom field definitions | 50 active per record type; select 1–100 options |
externalRefs |
Keys [a-z0-9_-]{1,32}, values 200 characters |
| Board | 200 cards per column |
| Feedback | title 200, body 10 000 |
Limit (details.limit) |
Free | Unlimited |
|---|---|---|
records: organizations + contacts + deals per account, archived included |
1 000 | – |
pipelines per account |
1 | – |
members of an account (owner included) + pending invitations |
1 | – |
apiKeys: active keys per account |
1 | – |
accounts a user owns |
1 | – |
MCP, REST, OAuth connections, the portfolio and the export are on every plan and never limited. Limits are checked on create only: downgrading never deletes anything. Over a limit, on REST and MCP alike:
{ "error": { "code": "PLAN_LIMIT_REACHED", "message": "This account is on the Free plan, which allows up to 1,000 records (organizations, contacts and deals). Ask an owner to upgrade to Unlimited at https://app.mety.ai/settings/billing.", "details": { "limit": "records", "max": 1000, "plan": "free", "upgradeUrl": "https://app.mety.ai/settings/billing" } } }Status 402. In an upsert batch it is an item error and the other items are applied. An agent should not retry or
work around it (for example by deleting records): finish the updates it can and pass the message to a person.
Unlimited is 10 €/month or 96 €/year (VAT excluded), managed in the app under Settings → Billing.