Install Jentic One Beta

Connect the Minimo API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Minimo API, 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://jentic.com/install.sh?src=apis&api=%2Fapis%2Fminimo.it%2Fminimo" | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fminimo.it%2Fminimo" | 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 Minimo API.

Create or update a contact in one call with POST /public/v1/contacts

Look up a contact record by email via GET /public/v1/contacts/by-email/{email}

Update or delete an existing contact through PUT and DELETE /public/v1/contacts/{id}

Define custom fields on the contact schema with POST /public/v1/custom-fields and list them via GET /public/v1/custom-fields

GET STARTED

Start building with Minimo API

Explore with Jentic One

View OpenAPI Document

Use Cases

Patterns agents use Minimo API for, with concrete tasks.

★ Web Signup to CRM

Push new website signups into Minimo with POST /public/v1/contacts using upsert semantics. Custom fields capture business attributes such as plan tier or referral source. The flow keeps Minimo in sync with marketing site forms without a separate integration platform.

POST /public/v1/contacts with email, name, and a custom field for source=website-signup, returning the contact id

Templated Email Sending

Trigger transactional emails from saved Minimo templates with POST /api/templates/email/send. The API resolves the recipient and substitutes contact attributes into the template variables. Use it for welcome sequences, password resets, or post-purchase follow-ups without coding HTML in the application.

POST /api/templates/email/send with template_id, contact_email, and the variable substitutions for first_name and order_number

WhatsApp Customer Confirmations

Use Minimo's pre-approved WhatsApp templates to deliver order confirmations, appointment reminders, or shipping updates. The agent first lists available templates, then sends the selected one with personalisation parameters. Suited to Italian businesses already operating on WhatsApp.

GET /public/v1/templates/whatsapp to find the order_confirmation template, then post a send request with the customer phone number and order id

Email Performance Reporting

Pull engagement metrics for each email template via GET /api/templates/email/{id}/stats to understand which messages drive opens and clicks. Reports can roll up per template across the account, surfacing which copy or subject lines perform best.

GET /api/templates/email/{id}/stats for each active template and rank by open rate

Agent-Driven Marketing Operations

An AI agent runs the daily marketing checks: ingests new contacts from a web export, sends the welcome email, and pulls yesterday's stats. Jentic isolates the bearer token, so the agent calls Minimo through scoped execution requests without holding the secret directly.

Search Jentic for 'send a templated email', load the Minimo email send schema, and send the welcome template to every contact added today

Key Endpoints

11 endpoints — jentic publishes the only available openapi specification for minimo api, keeping it validated and agent-ready.

METHOD

PATH

DESCRIPTION

POST

/public/v1/contacts

Create or update a contact

GET

/public/v1/contacts/by-email/{email}

Look up a contact by email

PUT

/public/v1/contacts/{id}

Update a contact

POST

/public/v1/custom-fields

Create a custom field

POST

/api/templates/email/send

Send an email from a template

GET

/api/templates/email/{id}/stats

Get email template engagement stats

GET

/public/v1/templates/whatsapp

List approved WhatsApp templates

POST

/public/v1/contacts

Create or update a contact

GET

/public/v1/contacts/by-email/{email}

Look up a contact by email

PUT

/public/v1/contacts/{id}

Update a contact

POST

/public/v1/custom-fields

Create a custom field

POST

/api/templates/email/send

Send an email from a template

GET

/api/templates/email/{id}/stats

Get email template engagement stats

GET

/public/v1/templates/whatsapp

List approved WhatsApp templates

Why Jentic?

What agents get from Jentic-routed access to this vendor.

Setup

Wiring Minimo by hand means handling its bearer auth against api.minimo.it and coding the contact, custom-field, and email or WhatsApp template calls yourself. Through Jentic you install once, import Minimo from the API Directory, store the token once, and your agent calls it.

Permission scoping

Minimo puts the contact id and email in the URL path (/public/v1/contacts/{id}, /contacts/by-email/{email}), so a rule can pin your agent to a specific contact for reads and updates. You choose the operations it may call, so sending a templated email is not included unless you add it.

Credential isolation

Your Minimo bearer token 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.

Intent-based discovery

Agents search Jentic by intent such as 'add a contact' or 'send a templated email', and Jentic returns the matching Minimo operation with its input schema, including any required custom field values, so the agent calls the right endpoint without browsing the reference docs.

FAQs

Specific to using Minimo API through Jentic.

Why is there no official OpenAPI spec for Minimo API?

Minimo does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Minimo API via structured tooling. It is validated against the live API and kept up to date. Get started with Jentic One, the self-hosted execution layer.

What authentication does the Minimo API use?

Minimo uses HTTP bearer token authentication. The token is sent in the Authorization header as `Bearer <token>`. Through Jentic the bearer token is stored in the vault and supplied at execution time.

Can I send WhatsApp messages with the Minimo API?

Yes, but only through approved templates. Call GET /public/v1/templates/whatsapp to list templates available on your account, then send a chosen template with the recipient phone number and parameter substitutions.

How do I send a transactional email through Jentic?

Run `pip install jentic`, search Jentic for 'send a templated email', and Jentic returns the Minimo POST /api/templates/email/send operation. Provide the template id, the recipient contact email, and any variable substitutions, then execute.

Can I add custom fields to contacts in Minimo?

Yes. Use POST /public/v1/custom-fields to define a new attribute on the contact schema (for example, plan_tier or signup_source), then include the field on subsequent POST /public/v1/contacts calls.

How do I report on email engagement?

GET /api/templates/email/{id}/stats returns per-template aggregate metrics - sends, opens, and clicks - that can be charted or surfaced in a dashboard.

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

Yes. Jentic One is self-hosted, so your own rules decide which Minimo operations and credentials the agent may use. Because Minimo puts the contact id and email in the URL path (/public/v1/contacts/{id} and /contacts/by-email/{email}), you can pin the agent to a specific contact for reads and updates. You also choose the operations it may call, so a higher-impact action like POST /api/templates/email/send or a WhatsApp template send is available only if you explicitly allow it.

Minimo It Minimo API

Name: Minimo API
Brand: Minimo API
Availability: InStock

Agent-ready OpenAPI document · curated by JenticMarketingMarketing Automationbearer11 EndpointsREST

Know of an official OpenAPI document? Contribute it →

For Agents

Manage contacts and custom fields, then send email or WhatsApp template messages with tracking through the Minimo API. Suited to small business marketing automation in Italian and EU markets.

Use for: Add a new contact captured from the website signup form, Update the phone number on contact id 123, Find the contact with email anna@example.it, Send the welcome email template to the new customer

Not supported: Does not handle SMS messaging, payments, or full deal pipeline tracking - use for contact management and email or WhatsApp template delivery only.

Jentic publishes the only available OpenAPI specification for Minimo API, keeping it validated and agent-ready. Minimo is an Italian customer engagement platform exposing endpoints for managing contacts, custom fields, and outbound messages across email and WhatsApp channels. Eleven endpoints cover contact upserts, custom field schema, email template send and stats, and WhatsApp template send. Useful for SMB marketing teams running multi-channel campaigns from a single account.

Jentic One on Github View OpenAPI Document

Connect the Minimo API to your agent

Capabilities

Start building with Minimo API

Use Cases

Key Endpoints

Why Jentic?

Related APIs

FAQs

Minimo It Minimo API