Recipes
Follow practical TeamGrid API integration recipes for projects, contacts, reporting, webhooks, and time tracking.
Recipes are practical integration patterns built from the API Reference and guides. Use them when you want to copy a working sequence rather than assemble individual endpoint calls from scratch.
Available Recipes
| Recipe | Use case |
|---|---|
| Create a project with tasks | Create a project, add tasks, and store returned ids. |
| Import contacts | Upsert customer or supplier contacts from another system. |
| Sync time entries for reporting | Pull time entries into a BI, payroll, or invoicing pipeline. |
| Build a webhook receiver | Receive TeamGrid events safely and idempotently. |
| Start and stop task time tracking | Start an active timer and close it with an end timestamp. |
Before You Start
Read these guides first:
Production Checklist
- Store the TeamGrid API token in a secret manager.
- Use
https://api.teamgrid.appas the API base URL. - Verify tokens with GET /teams.
- Add retry behavior for
429and transient5xxresponses. - Avoid blind retries for create requests unless your own system can detect duplicates.
- Log TeamGrid ids returned by create requests.