Recipes

This page documents the legacy API v0. New integrations should use API v1.

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:

• Authentication
• Requests and Responses
• Pagination and Filtering
• Errors and Rate Limits

Production Checklist

• Store the TeamGrid API token in a secret manager.
• Use https://api.teamgrid.app as the API base URL.
• Verify tokens with GET /teams.
• Add retry behavior for 429 and transient 5xx responses.
• Avoid blind retries for create requests unless your own system can detect duplicates.
• Log TeamGrid ids returned by create requests.