REST API · MCP · Webhooks
Build on the jobs your field team already runs in FieldTask
Create jobs, customers and draft quotes from your own systems with the REST API, or let an AI client do it in plain language through MCP. Both use the same permissions, checks and records.
Building with an AI assistant?llms.txt
curl "$FIELDTASK_API_ORIGIN/public/v1/jobs" \--header "Authorization: Bearer $FIELDTASK_API_TOKEN" \--header "Content-Type: application/json" \--header "Idempotency-Key: $IDEMPOTENCY_KEY" \--data '{"name": "Inspect rooftop unit","customer_id": "11111111-1111-4111-8111-111111111111","description": "Annual inspection. Ask at reception for roof access.","external_reference": "example-crm-job-10482"}'
201 Created abbreviated
{"data": {"id": "66666666-6666-4666-8666-666666666666","name": "Inspect rooftop unit","status": "unscheduled","schedule": {"mode":"unscheduled"},"customer_id": "11111111-1111-4111-8111-111111111111","created_at": "2026-11-03T14:05:12.481Z",…}}
Two ways in, one set of records
A job created through MCP is the same job you’d create through REST. Pick the one that fits who’s making the call.
REST API
For your own apps, scripts and integrations- You send
- HTTP requests with record IDs
- Credentials
- An API token or OAuth client credentials
- Safe retries
Idempotency-Key
MCP
For AI clients such as Claude or ChatGPT- You send
- Requests in plain language, through the client
- Credentials
- An owner or admin signs in from the client
- Safe retries
operation_key
What you can read and create
Each resource is available through REST and as MCP tools.
- JobsReadCreateList, filter by scheduled day and get jobs. Create unscheduled or timed jobs with a location, assignees and line items.
- Job itemsReadCreateA job’s line items. Add catalog items to an existing job.
- CustomersReadCreateList, get and create customers.
- Customer locationsReadCreateJob sites saved for a customer, with address and radius.
- Products & pricesReadCreateYour catalog, with named prices to use on job items.
- QuotesReadCreateRead quotes and create drafts for a customer.
- InvoicesReadCreateRead invoices and create drafts, where invoicing is enabled.
- MembersReadYour team, used to assign people to jobs.
- Member invitationsReadCreateInvite people to your organization and track invitations.
- TimesheetsReadTime entries and totals for a date range.
Read these before you ship
The conventions every request follows: how to authenticate, page through lists, retry safely and handle errors.
- AuthenticationAPI tokens, OAuth client credentials and MCP sign-in.
- PermissionsWhat each permission allows, and which ones depend on others.
- PaginationCursor-based pages. Cursors expire within 24 hours.
- Dates and timesResponses use UTC. Scheduled-day filters use your organization’s time zone.
- Idempotency and recoveryRetry creates safely, and find out what happened to a request that timed out.
- ErrorsThe error format, every error code and what to do about each.
- Rate limits and quotasPer-minute, concurrency and daily limits, and how to handle 429.
Know when records change
Webhooks and an event feed report created, updated and deleted events for customers, customer locations, jobs and members.
What’s changing
2026-11-03-review.2The contract these docs describe. It’s a review contract and may change before release.- The API and these docs are in beta.