salesloft-common-errors

# SalesLoft Common Errors ## Overview Quick reference for the most common SalesLoft REST API v2 errors. All errors return JSON with a message field. Rate limiting uses a cost-based system (600 cost/minute). ## Error Reference ### 401 Unauthorized -- Invalid or Expired Token ```json { "error": "Not authorized", "error_description": "The access token is invalid" } ``` **Causes:** Token expired, revoked, or wrong environment key. **Fix:** ```typescript // Check if token works const { data } = await api.get('/me.json').catch(err => { if (err.response?.status === 401) { console.error('Token invalid. Refreshing...'); return refreshAccessToken(storedRefreshToken); } throw err; }); ``` ### 403 Forbidden -- Insufficient Scopes ```json { "error": "Forbidden", "error_description": "Insufficient scope for this resource" } ``` **Fix:** Check app scopes in [developer portal](https://developers.salesloft.com). Common issue: using user-level OAuth for team-level endpoints (cadences, team templates). ### 404 Not Found -- Wrong Endpoint or Deleted Resource ```bash # Verify endpoint format -- all endpoints end with .json curl -s -H "Authorization: Bearer $TOKEN" \ https://api.salesloft.com/v2/people/12345.json # NOT /people/12345 (missing .json suffix) ``` ### 422 Unprocessable Entity -- Validation Errors ```json { "errors": [ { "attribute": "email_address", "message": "is required" }, { "attribute": "email_address", "message": "has already been taken" } ...