finta-common-errors

# Finta Common Errors ## Overview Finta is a fundraising CRM that manages investor pipelines, deal rooms, email sync, and payment collection for startups raising capital. Common errors involve round state transition violations (e.g., moving a round backward from "Closing" to "Outreach"), investor deduplication failures during CSV imports, and pipeline sync breakdowns between email providers and the deal tracker. Aurora AI suggestions depend on complete company profiles, and incomplete data is the top cause of empty recommendations. This reference covers API-level errors and CRM workflow issues that disrupt fundraising operations. ## Error Reference | Code | Message | Cause | Fix | |------|---------|-------|-----| | `400` | `Invalid round transition` | Moving round to an invalid state | Follow valid transitions: Draft > Active > Closing > Closed | | `401` | `Invalid API key` | Expired or revoked `FINTA_API_KEY` | Regenerate at Settings > API Access | | `404` | `Investor not found` | Deleted or merged investor record | Search by email to find merged record | | `409` | `Duplicate investor` | Email already exists in pipeline | Use dedup endpoint before CSV import | | `422` | `Missing required fields` | Incomplete investor or round data | Include `name`, `email`, `stage` at minimum | | `429` | `Rate limit exceeded` | Too many API calls | Implement backoff; batch operations where possible | | `500` | `Pipeline sync failed` | Email provider OAuth expired | Reconnect Gmail/Outloo...