# FieldTask Developers

> Documentation for FieldTask's public REST API, MCP server for AI clients, webhooks and event feed. Built from contract 2026-11-03-review.2 (a review contract that is not released and may change).

Each link points to a Markdown version of the page. Every page is also available at the same URL without `.md` as HTML.

## Guides

- [Authentication](https://developer.fieldtask.io/guides/authentication.md): API tokens, OAuth client credentials and MCP sign-in for FieldTask, including expiry, rotation and revocation.
- [Dates and times](https://developer.fieldtask.io/guides/conventions/dates-and-times.md): Timestamp formats, time zones and calendar dates in the FieldTask API.
- [Errors](https://developer.fieldtask.io/guides/conventions/errors.md): The FieldTask API error format, every error code, and what to do about each.
- [External references](https://developer.fieldtask.io/guides/conventions/external-references.md): Store your own system's identifiers on FieldTask jobs and customers and look records up by them.
- [Idempotency and recovery](https://developer.fieldtask.io/guides/conventions/idempotency.md): Retry FieldTask create requests safely with Idempotency-Key and operation_key, and recover their outcome.
- [Pagination](https://developer.fieldtask.io/guides/conventions/pagination.md): How FieldTask list endpoints and MCP list tools return results one page at a time.
- [Rate limits and quotas](https://developer.fieldtask.io/guides/conventions/rate-limits.md): Per-minute, concurrency and daily limits on FieldTask API and MCP requests, and how to handle 429 responses.
- [MCP quickstart](https://developer.fieldtask.io/guides/mcp-quickstart.md): Connect an AI client to FieldTask and create your first job by describing it.
- [Overview](https://developer.fieldtask.io/guides/overview.md): What you can do with FieldTask's REST API and MCP server, and how to choose between them.
- [Permissions](https://developer.fieldtask.io/guides/permissions.md): The permissions a FieldTask connection can hold, how they depend on each other, and how to change them.
- [REST quickstart](https://developer.fieldtask.io/guides/rest-quickstart.md): Create a FieldTask API token, read your customers and create your first job.
- [Troubleshooting](https://developer.fieldtask.io/guides/troubleshooting.md): Fix common problems connecting to and using the FieldTask API and MCP server.
- [Common workflows](https://developer.fieldtask.io/guides/workflows.md): Step-by-step sequences for common FieldTask integrations, from creating a scheduled job to drafting an invoice.

## REST API reference

- [Create a customer location](https://developer.fieldtask.io/rest/reference/create-customer-location.md): Creates one service location for an existing customer: a named address where your team works, with an optional map position and geofence radius.
- [Create a customer](https://developer.fieldtask.io/rest/reference/create-customer.md): Creates one customer in the organization your credential is connected to.
- [Create a draft invoice](https://developer.fieldtask.io/rest/reference/create-invoice.md): Creates one **draft** invoice for an existing customer, priced from your product and service catalog, with optional taxes and a discount.
- [Add a job item](https://developer.fieldtask.io/rest/reference/create-job-item.md): Adds one catalog product or service to an existing job as a line item, priced from the catalog.
- [Create a job](https://developer.fieldtask.io/rest/reference/create-job.md): Creates one field job for an existing customer in the organization your credential is connected to.
- [Invite a member](https://developer.fieldtask.io/rest/reference/create-member-invitation.md): Invites one person, by email address, to join your organization as an ordinary member.
- [Create a product](https://developer.fieldtask.io/rest/reference/create-product.md): Creates one catalog product or service, with 1–20 one-time prices, in the organization your credential is connected to.
- [Create a draft quote](https://developer.fieldtask.io/rest/reference/create-quote.md): Creates one **draft** quote for an existing customer, priced from your product and service catalog.
- [Customer locations](https://developer.fieldtask.io/rest/reference/customer-locations.md): Customer locations
- [Customers](https://developer.fieldtask.io/rest/reference/customers.md): Customers
- [Events](https://developer.fieldtask.io/rest/reference/events.md): Events
- [Get a customer location](https://developer.fieldtask.io/rest/reference/get-customer-location.md): Returns one customer location by its ID.
- [Get a customer](https://developer.fieldtask.io/rest/reference/get-customer.md): Returns one customer by its ID.
- [Get an invoice](https://developer.fieldtask.io/rest/reference/get-invoice.md): Returns one invoice by its ID, with its line items, taxes and discount.
- [Get a job item](https://developer.fieldtask.io/rest/reference/get-job-item.md): Returns one item on a job by its ID.
- [Get a job](https://developer.fieldtask.io/rest/reference/get-job.md): Returns one job by its ID.
- [Get a member invitation](https://developer.fieldtask.io/rest/reference/get-member-invitation.md): Returns one ordinary-member invitation by its ID.
- [Get a member](https://developer.fieldtask.io/rest/reference/get-member.md): Returns one active member of your organization by their member ID.
- [Get an operation](https://developer.fieldtask.io/rest/reference/get-operation.md): Returns what happened to a create request: which record it created, and the status of any follow-up work that runs after the record is saved.
- [Get a product](https://developer.fieldtask.io/rest/reference/get-product.md): Returns one product or service, with its price options, by its ID.
- [Get a quote](https://developer.fieldtask.io/rest/reference/get-quote.md): Returns one quote by its ID, with its line items, terms and customer note.
- [Get a member's timesheet totals](https://developer.fieldtask.io/rest/reference/get-timesheet-range.md): Returns how long one member worked on each day of a date range, and the total, in seconds.
- [Invoices](https://developer.fieldtask.io/rest/reference/invoices.md): Invoices
- [Job items](https://developer.fieldtask.io/rest/reference/job-items.md): Job items
- [Jobs](https://developer.fieldtask.io/rest/reference/jobs.md): Jobs
- [List events](https://developer.fieldtask.io/rest/reference/list-customer-events.md): Returns changes to customers, customer locations, jobs and members, in order, starting after a cursor you saved from an earlier response.
- [List a customer's locations](https://developer.fieldtask.io/rest/reference/list-customer-locations.md): Returns one customer's service locations, oldest first by default, one page at a time.
- [List customers](https://developer.fieldtask.io/rest/reference/list-customers.md): Returns the customers in your organization, oldest first by default, one page at a time.
- [List invoices](https://developer.fieldtask.io/rest/reference/list-invoices.md): Returns the invoices in your organization, oldest first by default, one page at a time.
- [List job items](https://developer.fieldtask.io/rest/reference/list-job-items.md): Returns the items on one job, oldest first by default, one page at a time.
- [List jobs](https://developer.fieldtask.io/rest/reference/list-jobs.md): Returns the jobs in your organization, oldest first by default, one page at a time.
- [List member invitations](https://developer.fieldtask.io/rest/reference/list-member-invitations.md): Returns the invitations for ordinary members of your organization, one page at a time, oldest first by default.
- [List members](https://developer.fieldtask.io/rest/reference/list-members.md): Returns the active members of your organization, one page at a time, in the order their memberships were created.
- [List products](https://developer.fieldtask.io/rest/reference/list-products.md): Returns the products and services in your organization's catalog, with their price options, oldest first by default, one page at a time.
- [List quotes](https://developer.fieldtask.io/rest/reference/list-quotes.md): Returns the quotes in your organization, oldest first by default, one page at a time.
- [List a member's timesheet entries](https://developer.fieldtask.io/rest/reference/list-timesheet-entries.md): Returns one member's individual timesheet entries for a date range of 1–31 days, one page at a time, ordered by start time.
- [Member invitations](https://developer.fieldtask.io/rest/reference/member-invitations.md): Member invitations
- [Members](https://developer.fieldtask.io/rest/reference/members.md): Members
- [Operations](https://developer.fieldtask.io/rest/reference/operations.md): Operations
- [Products](https://developer.fieldtask.io/rest/reference/products.md): Products
- [Quotes](https://developer.fieldtask.io/rest/reference/quotes.md): Quotes
- [Timesheets](https://developer.fieldtask.io/rest/reference/timesheets.md): Timesheets

## MCP

- [Connect an AI client](https://developer.fieldtask.io/mcp/connect-a-client.md): Connect Claude, ChatGPT, Cursor, VS Code, Claude Code, Codex or another MCP client to FieldTask.
- [How FieldTask tools work](https://developer.fieldtask.io/mcp/how-tools-work.md): How AI clients use FieldTask's MCP tools, resolve names into IDs, retry creates and handle errors.
- [Create a customer location](https://developer.fieldtask.io/mcp/tools/fieldtask-create-customer-location.md): Let an AI client add service locations to FieldTask customers through MCP, with coordinates, default locations, operation_key retries and recovery.
- [Create a customer](https://developer.fieldtask.io/mcp/tools/fieldtask-create-customer.md): Let an AI client create FieldTask customers through MCP, with permissions, duplicate checks, operation_key retries and recovery.
- [Create a draft invoice](https://developer.fieldtask.io/mcp/tools/fieldtask-create-invoice.md): Let an AI client create draft FieldTask invoices from catalog prices through MCP, with taxes, discounts, permissions, operation_key retries and recovery.
- [Add a job item](https://developer.fieldtask.io/mcp/tools/fieldtask-create-job-item.md): Let an AI client add a catalog product or service to a FieldTask job through MCP, with price selection, permissions, operation_key retries and recovery.
- [Create a job](https://developer.fieldtask.io/mcp/tools/fieldtask-create-job.md): Let an AI client create FieldTask jobs through MCP, with permissions, reference lookups, operation_key retries and recovery.
- [Invite a member](https://developer.fieldtask.io/mcp/tools/fieldtask-create-member-invitation.md): Let an AI client invite people to your FieldTask organization as ordinary members through MCP, with invitation authority, operation_key retries and email delivery checks.
- [Create a product](https://developer.fieldtask.io/mcp/tools/fieldtask-create-product.md): Let an AI client add a product or service with one-time prices to your FieldTask catalog through MCP, with permissions, operation_key retries and recovery.
- [Create a draft quote](https://developer.fieldtask.io/mcp/tools/fieldtask-create-quote.md): Let an AI client create draft FieldTask quotes from catalog prices through MCP, with permissions, reference lookups, discounts, operation_key retries and recovery.
- [Get a customer location](https://developer.fieldtask.io/mcp/tools/fieldtask-get-customer-location.md): Let an AI client read one FieldTask customer location by its ID through MCP, including coordinates found after it was created.
- [Get a customer](https://developer.fieldtask.io/mcp/tools/fieldtask-get-customer.md): Let an AI client read one FieldTask customer by its ID through MCP.
- [Get an invoice](https://developer.fieldtask.io/mcp/tools/fieldtask-get-invoice.md): Let an AI client read one FieldTask invoice, with its items, taxes, discount and balance, through MCP.
- [Get a job item](https://developer.fieldtask.io/mcp/tools/fieldtask-get-job-item.md): Let an AI client read one item on a FieldTask job by its ID through MCP.
- [Get a job](https://developer.fieldtask.io/mcp/tools/fieldtask-get-job.md): Let an AI client read one FieldTask job by its ID through MCP.
- [Get a member invitation](https://developer.fieldtask.io/mcp/tools/fieldtask-get-member-invitation.md): Let an AI client read one ordinary-member invitation by its ID through MCP, for example to check whether it was accepted.
- [Get an operation](https://developer.fieldtask.io/mcp/tools/fieldtask-get-operation.md): Let an AI client check the outcome of a FieldTask create call, including follow-up work, through MCP.
- [Get a product](https://developer.fieldtask.io/mcp/tools/fieldtask-get-product.md): Let an AI client read one FieldTask product or service, with its price options, by its ID through MCP.
- [Get a quote](https://developer.fieldtask.io/mcp/tools/fieldtask-get-quote.md): Let an AI client read one FieldTask quote, with its items, terms and totals, through MCP.
- [Get a member's timesheet totals](https://developer.fieldtask.io/mcp/tools/fieldtask-get-timesheet-range.md): Let an AI client read one member's daily and total worked time for up to 31 days through MCP.
- [List customer locations](https://developer.fieldtask.io/mcp/tools/fieldtask-list-customer-locations.md): Let an AI client list one FieldTask customer's service locations through MCP, for example to choose a job site.
- [List customers](https://developer.fieldtask.io/mcp/tools/fieldtask-list-customers.md): Let an AI client list FieldTask customers through MCP, and match the names you use to customer records.
- [List invoices](https://developer.fieldtask.io/mcp/tools/fieldtask-list-invoices.md): Let an AI client list FieldTask invoices, filtered by customer, status or issue date, through MCP.
- [List job items](https://developer.fieldtask.io/mcp/tools/fieldtask-list-job-items.md): Let an AI client list the items and work steps on a FieldTask job, with quantities, prices and status, through MCP.
- [List jobs](https://developer.fieldtask.io/mcp/tools/fieldtask-list-jobs.md): Let an AI client list FieldTask jobs, including the jobs scheduled on a given day, through MCP.
- [List member invitations](https://developer.fieldtask.io/mcp/tools/fieldtask-list-member-invitations.md): Let an AI client list your organization's ordinary-member invitations and their status through MCP.
- [List members](https://developer.fieldtask.io/mcp/tools/fieldtask-list-members.md): Let an AI client list your organization's active members through MCP, to resolve people's names into member IDs.
- [List products](https://developer.fieldtask.io/mcp/tools/fieldtask-list-products.md): Let an AI client search your FieldTask catalog of products and services, with their price options, through MCP.
- [List quotes](https://developer.fieldtask.io/mcp/tools/fieldtask-list-quotes.md): Let an AI client list FieldTask quotes, filtered by customer or status, through MCP.
- [List a member's timesheet entries](https://developer.fieldtask.io/mcp/tools/fieldtask-list-timesheet-entries.md): Let an AI client list one member's individual timesheet entries, with their jobs, for up to 31 days through MCP.

## Webhooks and events

- [Event feed](https://developer.fieldtask.io/webhooks/event-feed.md): Keep a copy of FieldTask customers, locations, jobs and members in sync by polling the event feed: bootstrap, backfill, poll and recover.
- [Event types](https://developer.fieldtask.io/webhooks/event-types.md): The FieldTask events for customers, customer locations, jobs and members, the event payload, deleted-record tombstones, ordering and revisions.
- [Receive webhooks](https://developer.fieldtask.io/webhooks/receive-webhooks.md): Add a FieldTask webhook, answer the verification challenge, verify Standard Webhooks signatures on the raw body, handle retries, pauses and replays, and rotate the signing secret.
- [Webhooks or polling?](https://developer.fieldtask.io/webhooks/webhooks-or-polling.md): Choose between FieldTask webhooks and the event feed for keeping customers, locations, jobs and members in sync, or use both.

## About

- [Changelog](https://developer.fieldtask.io/about/changelog.md): Changes to the FieldTask API contract and this documentation.
- [Release status](https://developer.fieldtask.io/about/release-status.md): Which FieldTask API contract this documentation describes and what is not yet decided.
- [Support and terms](https://developer.fieldtask.io/about/support.md): How to get help with the FieldTask API and which terms apply.
- [Versioning and changes](https://developer.fieldtask.io/about/versioning.md): How FieldTask API versions and changes are identified and announced.