Project Description
I already have my Nimble API token; what I still need is a compact Python helper (let’s call it nimble_helper.py) that logs in with that token and exposes clean functions for all the day-to-day calls I’ll make from my own scripts or via Claude.
Scope
• Endpoints: Contacts, Deals, Notes and, if available, Messages.
• Operations: Create, Read and Update for each of those endpoints.
• Focus: just authentication and the API calls themselves—I’ll handle any higher-level data validation or prompting logic elsewhere.
Technical expectations
– Pure Python 3, no heavyweight frameworks.
– Use requests (or httpx if you prefer) and type hints.
– Token should be read from an environment variable for security.
– Return JSON responses directly; surface any API error codes or messages cleanly.
Deliverables
1. nimble_helper.py with well-named functions such as create_contact(), get_deal(), update_note(), etc.
2. A short README or docstring block showing example usage (e.g., grabbing all contacts from a given company and updating their status).
3. Brief inline comments so I can extend the file later.
Acceptance
If I can drop the file into my project, run a quick test that creates, fetches and updates a dummy contact, deal and note without manual tweaks, the job is done.
That’s it—lean, readable code that simply works.