Overview
Programmatic access to TeamGrid contacts, projects, tasks, time entries, webhooks, scheduled work, journal entries, and project templates.
The TeamGrid API provides programmatic access to the data in a TeamGrid team. Use it to connect TeamGrid with reporting tools, import or synchronize contacts, create projects and tasks, track time, register webhooks, and build operational workflows around your TeamGrid workspace.
The API accepts JSON request bodies and returns JSON responses. All requests are scoped to the team that owns the API token. A token cannot be used to read or write data from another team.
Base URL
https://api.teamgrid.appUse this URL as the canonical API base URL in new integrations. The legacy
https://api.teamgridapp.com host is also reachable for existing integrations,
but examples and generated reference snippets use https://api.teamgrid.app
consistently.
Main Resources
The API is organized around the core TeamGrid work objects:
- Teams and users
- Contacts
- Projects
- Tasks
- Time entries
- Services, tags, and lists
- Webhooks
- Scheduled work
- Project journal entries
- Project templates
Data Ownership
TeamGrid API tokens are team-specific. When you create or update records through
the API, TeamGrid determines the team from the token and applies that team scope
on the server. Do not send teamId to choose a team. Treat teamId in API
responses as read-only metadata.
Recommended First Steps
- Create an API token in TeamGrid.
- Make a test request to GET /teams.
- Retrieve users and contacts.
- Create a test project or task.
- Register a webhook in a test environment.
- Use Recipes for copyable integration sequences.
Keep production tokens secure. A TeamGrid API token grants broad access to the team data exposed by the API.