What problem does it solve? Working with the HeyReach API requires repeating the same setup instructions, authentication logic, and error handling across every integration point. This Skill centralizes the shared API client, configuration checker, operation scripts, and reference documentation into one internal library so HeyReach operations stay consistent and maintainable. ## Core Features & Use Cases - Shared API Client: A Python client (heyreach_client.py) with automatic retry, exponential backoff, rate limit handling (300 req/min), and consistent error responses for all HeyReach endpoints. - Configuration Validation: A pre-flight checker (check_heyreach_config.py) that validates the API key, tests the connection, and returns structured JSON with an ai_action field guiding the next step. - Operation Scripts: Ready-to-run scripts for listing campaigns, adding leads, toggling campaign status, retrieving conversations, and pulling analytics. - Use Case: Before running any HeyReach operation, run the config checker; if it returns prompt_for_api_key, ask the user for their key, write it to .env, and proceed with campaign management tasks like adding leads or pausing a campaign. ## Quick Start Run the HeyReach config checker script with the --json flag to verify my API key is configured, then list all my HeyReach campaigns.
