Errors · Salesteam API Docs

Every error has the same shape: a code to check in your code, a message to show a person, and the requestId of the call.

JSON

{ "error": { "code": "not_found", "message": "This campaign wasn’t found in this workspace.", "requestId": "req_9c41e2a07b5d3f6e8a1c2b4d" } }

Code	Status	Meaning
`invalid_request`	400	A field is missing or wrong. The message says which.
`invalid_json`	400	The body isn’t valid JSON.
`duplicate_in_request`	400	In a bulk request: a row names a lead an earlier row already named. Send each lead once.
`unauthorized`	401	No key, an unknown key, or a revoked one.
`forbidden`	403	This key can’t do that in this workspace.
`read_only_key`	403	This key is read-only: it can read everything and change nothing. Use a Full access key to make changes.
`billing_hold`	402	The workspace’s plan isn’t paid, so it’s read-only: adding leads and resuming campaigns wait for a plan. Reading and tidying still work.
`not_found`	404	The campaign, list, lead or path isn’t in this workspace.
`not_in_campaign`	404	The person isn’t in that campaign.
`method_not_allowed`	405	The path exists, but not with this method.
`conflict`	409	The change doesn’t fit the current state, like resuming someone who isn’t paused.
`idempotency_in_progress`	409	A request with this Idempotency-Key is still running. Try again after Retry-After seconds.
`workspace_busy`	409	A scheduled action is finishing. Try again after Retry-After seconds.
`campaign_finished`	409	The campaign has finished; add people to another one.
`campaign_without_list`	409	The campaign has no lead list yet.
`tag_limit`	409	The workspace already has 100 tags.
`lead_has_history`	409	The lead can’t be deleted: you’ve already been in touch with them or marked them Do not contact. Stop them in their campaign instead.
`campaign_not_launched`	409	The campaign is a draft. Launch it in Salesteam first; a draft never goes live through the API.
`campaign_cannot_resume`	409	The campaign can’t run right now. The message says why: an account to reconnect, live sending off, or nobody left who can join.
`ambiguous_email`	409	Several people in the workspace have this email. Send their linkedinUrl instead.
`too_large`	413	The body is larger than 1 MB.
`idempotency_key_reused`	422	This Idempotency-Key was already used for a different request.
`unsupported_media_type`	415	Send the body as JSON.
`rate_limited`	429	More than 300 requests this minute. Try again after Retry-After seconds.
`server_error`	500	Something went wrong at Salesteam. Try again in a minute.
`error`	503	A service Salesteam relies on didn’t answer. Try again in a minute.