Apacta

Name: Apacta API
Brand: Apacta
Availability: InStock

✓ Official Vendor SpecProductivityTask ManagementapiKey290 EndpointsREST

For Agents

Register working hours, material usage, project files, and invoices for trades businesses across 290 endpoints, authenticated with an X-Auth-Token API key.

Install Jentic One Beta

Connect the Apacta to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Apacta, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with Apacta API.

Create and update time entries linked to a specific activity and project

Manage contacts, contact persons, and companies in the trades business CRM

GET STARTED

Start building with Apacta API

Explore with Jentic

View OpenAPI Document

Apacta is a field service platform for craftsmen and trades businesses (electricians, plumbers, builders) to register working hours, material usage, project files, and quality assurance forms. The HTTP API exposes 290 endpoints across companies, contacts, projects, time entries, clocking records, invoices, forms, and project files so back-office tools and field apps can push and pull operational data. Authentication is an API key passed either as the X-Auth-Token header or as the api_token query parameter. The API supports pagination via ?page= on list endpoints and ordering on selected resources.

Use Cases

Patterns agents use Apacta API for, with concrete tasks.

★ Daily payroll-ready timesheets

Aggregate the day's clock-in and clock-out events from craftsmen into payroll-ready timesheets. The agent calls /clocking_records and /time_entries scoped to a date range, applies project and activity codes, and writes the result into a payroll system. This replaces manual timesheet capture at the end of the week.

GET /clocking_records and /time_entries filtered to today's date, group by employee and project, and POST a daily summary to the payroll system

Project-to-invoice automation

Convert logged time and materials on a project into a draft invoice and email it to the customer. The agent uses /projects to find the project context, /time_entries and /activities to gather billable lines, then creates an invoice and posts the email via /invoices and /invoice_emails. Invoice files (PDF) can be attached via /invoice_files.

Read time entries and activities for a closed project, create a draft invoice, attach the PDF via /invoice_files, and send it via /invoice_emails to the project contact

Quality assurance form capture

Capture quality assurance form submissions from the field and tie them to projects. The agent retrieves form templates via /companies/{company_id}/form_templates and posts responses against the relevant project. Photos and attachments uploaded to /projects/{project_id}/files form the audit trail required by the customer.

Fetch the form template for a company, submit a completed response tied to a project id, and upload photos via /projects/{project_id}/files

Contact and company sync to a CRM

Mirror Apacta contacts, contact persons, and companies into a separate CRM (HubSpot, Salesforce) so the sales team sees the same customer records as the field team. The agent pages through /contacts and /companies, applying ?page= and the search filters on supported endpoints, and upserts each record into the destination CRM.

Page /contacts and /companies, dedupe by email and company name, and upsert each into the destination CRM

AI agent integration via Jentic

An agent supporting an Apacta-using business can search Jentic for 'create a time entry' and Jentic returns the matching Apacta operation and schema. Jentic stores the X-Auth-Token API key, so the agent does not handle the secret or wire up the api_token query fallback.

Search Jentic for 'create a time entry in Apacta', load the /time_entries schema, and POST a new entry for the user-named project and activity

Key Endpoints

290 endpoints — apacta is a field service platform for craftsmen and trades businesses (electricians, plumbers, builders) to register working hours, material usage, project files, and quality assurance forms.

METHOD

PATH

DESCRIPTION

GET

/clocking_records

List clock-in and clock-out events

POST

/clocking_records/checkout

GET

/time_entries

List logged time entries

POST

/activities

Create a new activity classification

GET

/contacts

List contacts in the trades business CRM

GET

/companies

List companies in the CRM

POST

/invoices

Create an invoice

POST

/invoice_emails

Email an invoice to a customer

GET

/clocking_records

List clock-in and clock-out events

POST

/clocking_records/checkout

GET

/time_entries

List logged time entries

POST

/activities

Create a new activity classification

GET

/contacts

List contacts in the trades business CRM

Why Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

Your Apacta API key is stored once, encrypted, by your own Jentic One instance and injected as the X-Auth-Token header at execution time. It never enters the agent's prompt, logs, or context.

Intent-based discovery

Agents search Jentic by intent such as 'register a clock-in' or 'create an invoice', and Jentic returns the matching Apacta operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

Time to first call

FAQs

Specific to using Apacta API through Jentic.

What authentication does the Apacta API use?

API key auth with two transport options: X-Auth-Token in the request header (preferred) or api_token as a URL query parameter. Through Jentic the key is held in the encrypted Jentic One instance and attached as the X-Auth-Token header server-side, so the secret never appears in URLs or logs.

Can I create invoices from logged hours through the Apacta API?

Yes. Pull /time_entries and /activities for the project, POST to /invoices to create the draft, attach the PDF via /invoice_files, and send it through /invoice_emails. This is the project-to-invoice path the API was designed for.

How do I register a clock-in through Jentic?

Search Jentic for 'register a clock-in for a craftsman', load the schema for /clocking_records (POST), and execute it with the employee, project, and start time. Use /clocking_records/checkout to close the same record at end of shift.

What are the rate limits for the Apacta API?

Apacta does not document specific per-minute limits in the OpenAPI spec; in practice the platform applies plan-based throttling. Use ?page= for paginated reads to keep request volumes bounded.

Does the API support search and ordering on list endpoints?

Search is experimental on selected endpoints (see the per-endpoint docs). Ordering is also experimental and follows the pattern ?sort=ResourceName.field&direction=desc, for example sorting invoices by invoice number descending.

How do I upload a file to a project?

There are two paths: /projects/{project_id}/files for files coming from wall posts or form submissions, and /projects/{project_id}/project_files for general project files not tied to a form. Pick based on whether the file is form-attached or free-standing.

Can I limit what my agent is allowed to do with the Apacta API?

Yes. Because Jentic One is self-hosted, your own rules decide which Apacta operations and credentials the agent can use, so you grant only the endpoints it needs, such as listing time entries with GET /time_entries or creating a draft with POST /invoices. Apacta's collection routes take their work through the request body rather than resource ids in the path, which keeps each allowed operation tightly scoped. Separate actions like emailing an invoice through /invoice_emails are reachable only when you include them in the allowed set, so the agent cannot send mail unless you permit it.

Apacta

Connect the Apacta to your agent

Capabilities

Start building with Apacta API

Use Cases

Key Endpoints

Why Jentic?

Related APIs

FAQs