> ## Documentation Index
> Fetch the complete documentation index at: https://docs.minimo.it/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Welcome to the Minimo API - Build powerful messaging and CRM integrations

## What is the Minimo API?

The Minimo API is a RESTful API that allows you to integrate Minimo's messaging and contact management capabilities into your applications, websites, and workflows.

With the Minimo API, you can:

* **Manage contacts**: Create, update, and organize your contact database
* **Send messages**: Deliver emails and WhatsApp messages using approved templates
* **Track engagement**: Access message delivery statistics and analytics
* **Automate workflows**: Integrate with your existing systems and tools

## Who should use this API?

The Minimo API is designed for:

* **Developers** building custom integrations with Minimo
* **Product teams** embedding messaging capabilities into their applications
* **Technical users** automating contact management and messaging workflows
* **Agencies** managing multiple clients and campaigns programmatically

## API vs. Integrations

* **Use the API** when you want to build custom integrations, make direct HTTP requests, or have full programmatic control
* **Use Integrations** (Zapier, ActiveCampaign, etc.) for no-code/low-code automation between Minimo and other platforms

<Tip>
  If you prefer no-code solutions, check out our [Integrations & Apps](/product/introduction) section for ready-made
  connectors.
</Tip>

## Getting Started

Ready to start building? Follow these steps:

<Steps>
  <Step title="Create an API Key">
    Generate your API key in the Minimo dashboard under [Account Settings](https://app.minimo.it/account). Learn more in
    [Authentication & API Keys](/api-reference/overview/authentication).
  </Step>

  <Step title="Review API Conventions">
    Understand our API structure, error handling, and response formats. See [API
    Conventions](/api-reference/overview/conventions).
  </Step>

  <Step title="Make Your First Request">
    Start with a simple contact creation or template send. Browse available endpoints in the sidebar →
  </Step>
</Steps>

## API Architecture

The Minimo API is organized into logical sections:

### Core Data

Manage the foundational data objects like contacts, custom fields, and segments.

**Example**: Create or update a contact with custom attributes.

### Messaging Channels

Send messages through different channels (Email, WhatsApp) using approved templates.

**Example**: Send a WhatsApp notification or transactional email.

### Legacy

Deprecated endpoints maintained for backward compatibility. **Use the new endpoints instead.**

## Support & Resources

<CardGroup cols={2}>
  <Card title="API Status" icon="signal" href="https://status.minimo.it">
    Check real-time API uptime and performance
  </Card>

  <Card title="Contact Support" icon="envelope" href="mailto:info@minimo.it">
    Get help from our technical team
  </Card>

  <Card title="Dashboard" icon="gauge" href="https://app.minimo.it">
    Manage API keys and view analytics
  </Card>
</CardGroup>

## Rate Limits & Fair Use

All API endpoints are rate-limited to ensure service quality for all users. Current limits:

* **Standard Plan**: 100 requests per minute
* **Pro Plan**: 500 requests per minute
* **Enterprise**: Custom limits available

<Info>
  Rate limit details are returned in response headers: `X-RateLimit-Limit`, `X-RateLimit-Remaining`,
  `X-RateLimit-Reset`.
</Info>

Contact our team at [info@minimo.it](mailto:info@minimo.it) if you need higher limits.
