Skip to content

API errors and rate limits

What each error code means, how to fix it, and how many calls a key can make per minute.

2 min read · Updated November 18, 2026

Every error has the same shape and a matching HTTP status. The requestId (also sent as the X-Request-Id header) is what support needs to look at your call.

An error
{ "error": { "code": "invalid", "message": "Give the campaign a name.", "requestId": "…", "fieldErrors": { "name": "Give the campaign a name." } } }
StatusCodeWhat it meansWhat to do
400invalid_jsonThe body isn't valid JSONCheck the JSON
401unauthenticatedThe key is missing, mistyped, revoked or expiredThe header must read Bearer, a space, then the key. Make a new key if needed
402billing_paused, limit_reachedThe subscription is paused or past due, or a plan limit was reachedCheck Settings, Billing. Pausing and stopping always work
403forbiddenThe key's access level is too low for this callUse a higher level, such as Admin to launch
404not_foundNo such thing in this workspaceCheck the ID. Something in another workspace looks the same as nothing
413payload_too_largeThe body is over 5 MBSend fewer rows per call
415unsupported_media_typeNo JSON content typeAdd Content-Type: application/json
422invalidValid JSON, but not valid inputRead fieldErrors: it names the field and says what's wrong
429rate_limitedToo many calls this minuteWait the seconds in Retry-After, then retry
503unavailableTemporarily unavailableRetry after a few seconds
500unknownOur faultSend us the requestId

#Rate limits

Limits are per key, per minute, by the kind of call:

KindPer minuteFor
Read60Reading data
Write20Changes that never touch LinkedIn: create or edit campaigns, set do-not-contact, pause
Bulk10Adding up to 500 people to a list in one call
Enqueue5Anything that starts LinkedIn activity: launch, resume, add leads to a campaign

Responses include X-RateLimit-Limit and X-RateLimit-Remaining. A 429 includes Retry-After. Rejected 429s don't count against you, so waiting out Retry-After is always enough. Sending more rows per call (up to 5,000 for a list import) is better than sending more calls.

Was this article helpful?