Skip to content

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).

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.