canonical: https://jentic.com/apis/activecalculator.com/activecalculator

# Activecalculator Management API

The ActiveCalculator Management API lists the interactive calculators in your account and manages the webhooks that fire when those calculators are used. You can register a webhook to receive calculator events, read or remove an existing webhook by id, list all your calculators, and read your account identity. It is the programmatic control surface for an ActiveCalculator workspace rather than the embed or builder itself.

## For AI agents

List the calculators in an ActiveCalculator account and register, read, or remove the webhooks that deliver calculator events.

## Scope

Does not build, embed, or render calculators, and does not collect responses directly. Use for listing calculators and managing their webhooks only.

## Capabilities

- List all interactive calculators in your account
- Register a webhook to receive calculator events
- Read an existing webhook by its id
- Remove a webhook you no longer need
- Read your account identity

## Use cases

### Agent-Managed Webhook Setup

A team wants calculator submissions to flow into their CRM automatically. An AI agent registers a webhook on the ActiveCalculator account that points at the destination, confirms it by reading the webhook back, and removes stale webhooks, so submission events reach downstream systems without manual configuration in the dashboard.

Example prompt: Register a webhook for calculator events pointing at a CRM endpoint, then read it back to confirm it was created

### Calculator Inventory Sync

An operations team keeps a record of every calculator published across the account. The ActiveCalculator Management API lists all calculators and reads the account identity, so an agent can pull the current inventory and keep an internal catalog of calculators and their owner in sync.

Example prompt: List all calculators in the account and record each one alongside the account identity

### Webhook Cleanup Routine

Over time an account accumulates webhooks pointing at endpoints that no longer exist. The API lists webhooks, reads each one by id, and removes the ones that are stale, letting an agent run a periodic cleanup so only live destinations keep receiving calculator events.

Example prompt: List the account's webhooks, identify ones pointing at dead endpoints, and remove them

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | `/calculators` | List all calculators in the account |
| GET | `/webhooks` | List all registered webhooks |
| POST | `/webhooks` | Register a webhook for calculator events |
| GET | `/webhooks/{webhookId}` | Read a webhook by its id |
| DELETE | `/webhooks/{webhookId}` | Remove a webhook |
| GET | `/me` | Read the caller's account identity |

## Key resources

- **Calculators** — List the interactive calculators in the account
- **Webhooks** — Register, read, and remove webhooks that deliver calculator events
- **Account** — Read the caller's account identity

## AI readiness

This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use.

- **Score:** 55 / 100
- **Maturity:** Foundational
- **Dimensions:**
  - Foundational Compliance: 67 / 100
  - Developer Experience & Jentic Compatibility: 71 / 100
  - AI-Readiness & Agent Experience: 32 / 100
  - Agent Usability: 94 / 100
  - Security: 50 / 100
  - AI Discoverability: 71 / 100
- **View full report:** https://jentic.com/apis/activecalculator.com/activecalculator/scorecard
- **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/
- **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview

### Score it yourself

Every API in the directory is allowlisted, so you can re-score it with no key required.

- **Score your own API:** https://jentic.com/scorecard.md
- **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md

```sh
npx @jentic/api-scorecard-cli score <openapi-url>
```

## Why Jentic

- **Setup:** Wiring the ActiveCalculator Management API by hand means handling its header API key and tracking which webhook ids you have registered. Through Jentic you install once, import it from the API Directory, store the key once, and your agent calls it.
- **Permission scoping:** You choose which ActiveCalculator operations your agent may call, so it can list calculators and read webhooks while the webhook register and remove operations stay out of the set unless you add them.
- **Credential handling:** Your ActiveCalculator key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'register a calculator webhook' or 'list my calculators', and Jentic returns the matching operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **Typeform API** — Typeform collects form and quiz responses; ActiveCalculator manages interactive calculators and their submission webhooks.
- **Jotform API** — Jotform builds and collects forms; ActiveCalculator focuses on interactive calculators and the webhooks they trigger.
- **Zapier** — Zapier routes the calculator events onward to other apps; ActiveCalculator is where the webhooks are registered.

## FAQ

### What authentication does the ActiveCalculator Management API use?

The ActiveCalculator Management API authenticates with an API key sent in a request header, per its OpenAPI spec. You generate the key in your ActiveCalculator account and send it with each request. Through Jentic the key is stored encrypted by your own Jentic One instance and injected at call time, so it never reaches the agent's context.

### Can I register a webhook for calculator events through an agent?

Yes. The API registers a webhook that fires when a calculator is used, and it lets you read the webhook back by its id or remove it later. An agent can set up, verify, and clean up webhooks so calculator submissions reach your downstream systems.

### What are the rate limits for the ActiveCalculator Management API?

The OpenAPI spec does not define rate limits. Check the ActiveCalculator documentation at https://activecalculator.com for the current limits that apply to the Management API.

### How do I set up calculator webhooks through Jentic?

Import the ActiveCalculator Management API from the Jentic directory and give your agent an intent such as 'register a calculator webhook'. Jentic returns the webhook-registration operation with its input schema, your agent supplies the destination and calls it, and your stored key is injected at execution time. To run it on your own infrastructure, install Jentic One from its GitHub repo.

### Can I limit what my agent is allowed to do with the ActiveCalculator Management API?

Yes. Write a rule that allows only the read operations, such as listing calculators and reading webhooks and the account, so your agent cannot register or remove webhooks, and every call it makes is logged.

### Is there an ActiveCalculator MCP server?

You don't need an MCP server to give your agent the ActiveCalculator Management API. Jentic connects it directly from the API Directory: import it, store your credential once, and your agent calls it, so no extra server's tool definitions sit in the agent's context.