Minimo It Minimo API

Name: Minimo API
Brand: Minimo API
Availability: InStock

★ Only Publicly Available OpenAPI DocumentMarketingMarketing Automationbearer11 EndpointsREST

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.

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://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 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}

GET STARTED

Start building with Minimo API

Explore with Jentic

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

Why Jentic?

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

Credential isolation

The Minimo bearer token is stored encrypted in the Jentic vault. Agents call Minimo through scoped execution requests so the token never enters agent context, prompts, or logs.

Intent-based discovery

Agents search Jentic for intents like '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.

Time to first call

Direct Minimo integration: half a day to wire bearer auth, custom fields, and template sending. Through Jentic: under 30 minutes — search, load schema, execute.

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 at https://app.jentic.com/sign-up.

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.

Minimo It Minimo API

Connect the Minimo API to your agent

Capabilities

Start building with Minimo API

Use Cases

Key Endpoints

Why Jentic?

Related APIs

FAQs