canonical: https://jentic.com/apis/minimo.it/minimo

# Minimo It Minimo API

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.

## For AI 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.

## Scope

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

## Capabilities

- 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`
- Send a transactional email from a saved template using POST `/api/templates/email/send`
- Read per-template email engagement statistics via GET `/api/templates/email/{id}/stats`
- List approved WhatsApp templates with GET `/public/v1/templates/whatsapp`

## Use cases

### 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.

Example prompt: 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.

Example prompt: 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.

Example prompt: 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.

Example prompt: 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.

Example prompt: 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

| 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 |

## Key resources

- **Contacts** — Create, read, update, and delete contact records with custom fields
- **Custom Fields** — Define and list custom attributes on the contact schema
- **Email Templates** — Send and report on transactional email templates
- **WhatsApp Templates** — List approved WhatsApp templates for outbound messaging

## Why Jentic

- **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 handling:** 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.
- **Discovery method:** 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.

## Related APIs

- **Brevo** — Brevo offers a broader marketing automation suite with email, SMS, and WhatsApp
- **Mailchimp** — Mailchimp focuses on email-first marketing automation and audience management
- **HubSpot** — HubSpot provides a deeper CRM upstream that can feed contacts into Minimo for delivery

## FAQ

### 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.