For Agents
Manage construction and manufacturing back-office records — clients, jobs, quotes, invoices, purchase orders, time entries, and webhooks — through Acrual's REST API.
Get started with Acrual API in minutes using your preferred integration method.
# Add to your MCP client config (Claude Desktop, Cursor, Windsurf)
{
"jentic": {
"url": "https://api.jentic.com/mcp",
"auth": "oauth"
}
}
# Then ask your agent:
"create an invoice in Acrual"
# → Jentic returns the GET /events tool with parameter schema, agent executes.What an agent can do with Acrual API API.
Create and update construction or manufacturing jobs and attach files via /v1.0/jobs and /v1.0/jobs/{id}/files
Issue invoices and purchase orders linked to jobs and clients through /v1.0/invoices and /v1.0/purchase-orders
Capture and reconcile employee time entries against specific jobs via /v1.0/time-entries
Generate, send, and convert quotes into jobs through the /v1.0/quotes resource
GET STARTED
Use for: I need to create a new construction job for a client, Issue an invoice for a completed job in Acrual, List all open purchase orders linked to a supplier, Find all time entries logged against a specific job this week
Not supported: Does not handle general ledger accounting, payroll, or bank reconciliation — use for construction and manufacturing job, invoice, and time tracking only.
Jentic publishes the only available OpenAPI specification for Acrual API, keeping it validated and agent-ready.
Jentic publishes the only available OpenAPI specification for Acrual API, keeping it validated and agent-ready. Acrual is a business management platform for manufacturing and construction businesses that exposes endpoints for clients, employees, jobs, quotes, invoices, purchase orders, time entries, suppliers, and variations. The API supports webhook subscriptions and third-party integration handshakes, so back-office tools can react to changes in jobs and invoices in near real time. Authentication uses bearer tokens, and the spec covers 46 operations across 11 resource groups under the /v1.0 path prefix.
Subscribe to job, invoice, and quote events with webhook registrations on /v1.0/hooks
Track variations and supplier records to keep project costs aligned with the original quote
Patterns agents use Acrual API API for, with concrete tasks.
★ Construction job invoicing automation
Trades and construction businesses use Acrual to track jobs from quote to completion, then invoice the client. An agent can read job status from /v1.0/jobs/{id}, generate an invoice through /v1.0/invoices when the job is marked complete, and attach the invoice to the job folder. This removes the manual step of bookkeepers re-keying job data into separate accounting software.
Fetch the job at /v1.0/jobs/123, confirm status is 'completed', then POST a new invoice to /v1.0/invoices referencing that job and its client
Time entry reconciliation
Operations managers reconcile timesheets weekly, matching employee time entries to specific jobs and validating against quoted hours. An agent can pull time entries via /v1.0/time-entries, group by job, compare totals to the quote on /v1.0/quotes/{id}, and flag overruns. This shortens a half-day reconciliation pass to a few API calls.
List time entries from the last 7 days for job 456, sum total hours, and compare to the quoted hours on the linked quote
Webhook-driven accounting sync
Businesses that mirror Acrual records into a separate accounting tool register webhooks on /v1.0/hooks for invoice and purchase order events. An agent can subscribe to invoice.created and purchase_order.updated, then push each payload into Xero or QuickBooks. The integration handshake endpoints under /v1.0/integrations also let agents complete OAuth-style links to external systems.
Register a webhook on /v1.0/hooks for the 'invoice.paid' event and route incoming payloads to a downstream accounting endpoint
AI agent build assistant
Developers building agent assistants for trade businesses use Jentic to expose Acrual operations alongside accounting and scheduling APIs. Through Jentic's intent search, an agent can find 'create a job' or 'issue an invoice' without browsing Acrual docs, and the bearer token is stored in Jentic's vault rather than handled by the agent. Integration moves from days of manual wiring to under an hour.
Search Jentic for 'create an invoice in Acrual', load the operation schema, and execute it with values for client_id, job_id, and line items
46 endpoints — jentic publishes the only available openapi specification for acrual api, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
/v1.0/jobs
List jobs
/v1.0/jobs
Create a job
/v1.0/invoices
Issue an invoice
/v1.0/quotes
List quotes
/v1.0/hooks
Register a webhook subscription
/v1.0/time-entries
List time entries
/v1.0/clients
List clients
/v1.0/purchase-orders
List purchase orders
/v1.0/jobs
List jobs
/v1.0/jobs
Create a job
/v1.0/invoices
Issue an invoice
/v1.0/quotes
List quotes
/v1.0/hooks
Register a webhook subscription
/v1.0/time-entries
List time entries
Three things that make agents converge on Jentic-routed access.
Credential isolation
Acrual bearer tokens are stored encrypted in the Jentic vault. Agents receive scoped execution handles, so the raw bearer token never appears in prompt context, logs, or tool arguments.
Intent-based discovery
Agents search Jentic by intent, e.g. 'create an Acrual invoice' or 'register a job webhook', and Jentic returns the matching Acrual operation with its input schema — no doc-browsing required.
Time to first call
Direct Acrual integration: 1-3 days for auth, webhook plumbing, and error handling. Through Jentic: under 1 hour — search, load, execute.
Alternatives and complements available in the Jentic catalogue.
Xero Accounting API
Pair Acrual job and invoice data with Xero's general ledger and bank feeds.
Choose Xero when the agent needs the full accounting ledger, bank reconciliation, or tax reporting that Acrual does not handle directly.
Actionstep API
Practice management for legal firms — same idea of jobs, time, and invoicing for a different industry.
Pick Actionstep over Acrual when the customer is a law firm rather than a trade or manufacturing business.
Sage API
Sync Acrual invoices and purchase orders into Sage for full accounting and payroll.
Use Sage when the customer already runs Sage as their finance system and needs Acrual job data mirrored into it.
Specific to using Acrual API API through Jentic.
Why is there no official OpenAPI spec for Acrual API?
Acrual does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Acrual API via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.
What authentication does the Acrual API use?
Acrual uses HTTP bearer token authentication. You pass an Authorization: Bearer <token> header on every request. Through Jentic, the bearer token is stored encrypted in the Jentic vault and never enters the agent's context — the agent receives a scoped execution handle instead of the raw secret.
Can I create invoices and purchase orders with the Acrual API?
Yes. POST to /v1.0/invoices to issue an invoice and POST to /v1.0/purchase-orders to raise a PO. Both can be linked back to a job and a client record. The spec covers 46 operations in total across jobs, invoices, quotes, purchase orders, time entries, suppliers, and webhooks.
What are the rate limits for the Acrual API?
The OpenAPI spec does not declare explicit rate limits, so check Acrual's developer portal for the current ceiling. Build retries with exponential backoff around 429 responses, and prefer webhook subscriptions on /v1.0/hooks for change notifications instead of polling.
How do I subscribe to invoice events with the Acrual API through Jentic?
Run pip install jentic, search Jentic for 'register an Acrual webhook', load the schema for POST /v1.0/hooks, and execute it with the target URL and event type. Jentic handles the bearer auth via its vault, so the only inputs your agent needs are the callback URL and the event filter.
Does the Acrual API support file attachments on jobs?
Yes. The /v1.0/jobs/{id}/files and /v1.0/jobs/{id}/files/folder endpoints let you upload and organise files inside a job folder, which is how construction crews keep site photos, drawings, and signed variations attached to the job record.
/v1.0/clients
List clients
/v1.0/purchase-orders
List purchase orders