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

# Legacy API (Deprecated)

> Deprecated endpoints maintained for backward compatibility

<Warning>
  **This section contains deprecated endpoints that will be removed on June 1, 2026.** Please migrate to the new
  endpoints in the [Messaging Channels](/api-reference/messaging-channels/email/send-template) section.
</Warning>

## Why These Endpoints Are Deprecated

The original "Transactionals" API had several limitations:

* ❌ Inconsistent naming and structure
* ❌ Limited template management capabilities
* ❌ No support for WhatsApp and other channels
* ❌ Unclear separation between channels
* ❌ Missing analytics and tracking features

The new **Messaging Channels** API addresses all these issues with:

* ✅ Consistent structure across all channels
* ✅ Better template management
* ✅ Multi-channel support (Email, WhatsApp, SMS coming soon)
* ✅ Enhanced analytics and stats
* ✅ Improved error handling and validation

## Migration Guide

### Email Transactionals → Email Templates

**Old endpoint** (deprecated):

```bash theme={null}
POST /api/transactionals
```

**New endpoint**:

```bash theme={null}
POST /api/templates/email/send
```

### Request Structure Comparison

<CodeGroup>
  ```json Old (Deprecated) theme={null}
  {
    "uid": "unique_template_id",
    "recipient": "customer@example.com",
    "customFields": {
      "name": "John Doe",
      "orderNumber": "12345"
    }
  }
  ```

  ```json New (Recommended) theme={null}
  {
    "templateId": "tmpl_abc123",
    "recipient": "customer@example.com",
    "customFields": {
      "name": "John Doe",
      "orderNumber": "12345"
    }
  }
  ```
</CodeGroup>

**Key changes**:

* `uid` → `templateId` (more descriptive)
* Template IDs now use `tmpl_` prefix for clarity
* Response includes more metadata

### WhatsApp Migration

**Old endpoint** (deprecated):

```bash theme={null}
POST /api/transactionals/whatsapp/send
GET /api/transactionals/whatsapp/templates
```

**New endpoints** (on `api.minimo.it`):

```bash theme={null}
POST https://api.minimo.it/public/v1/templates/whatsapp/send
GET  https://api.minimo.it/public/v1/templates/whatsapp
```

The structure is largely the same, but with improved error messages and validation. Note the new endpoints are served from the `api.minimo.it` domain.

## Migration Timeline

| Date              | Milestone                                           |
| ----------------- | --------------------------------------------------- |
| **November 2025** | New API released, legacy API deprecated             |
| **December 2025** | Migration guide published                           |
| **March 2026**    | Legacy API enters maintenance mode (bug fixes only) |
| **May 2026**      | Final migration warnings sent to all users          |
| **June 1, 2026**  | **Legacy API removed**                              |

<Info>
  You have until **June 1, 2026** to migrate. After this date, the legacy endpoints will return `410 Gone` errors.
</Info>

## How to Migrate

<Steps>
  <Step title="Audit Your Integration">
    Identify where you're using the old endpoints:

    ```bash theme={null}
    # Search your codebase
    grep -r "/api/transactionals" .
    ```
  </Step>

  <Step title="Update API Calls">
    Replace old endpoints with new ones:

    * `/api/transactionals` → `/api/templates/email/send`
    * `/api/transactionals/whatsapp/send` → `/api/templates/whatsapp/send`
    * `/api/transactionals/whatsapp/templates` → `/api/templates/whatsapp`
  </Step>

  <Step title="Update Request Payloads">
    Change `uid` to `templateId` in your requests:

    ```javascript theme={null}
    // Before
    { uid: "abc123", recipient: "user@example.com" }

    // After
    { templateId: "tmpl_abc123", recipient: "user@example.com" }
    ```
  </Step>

  <Step title="Test in Staging">
    Verify the new endpoints work as expected in your staging environment before deploying to production.
  </Step>

  <Step title="Deploy to Production">
    Once tested, deploy your changes to production.
  </Step>

  <Step title="Monitor & Verify">
    Check logs to ensure no errors and that messages are being delivered successfully.
  </Step>
</Steps>

## Get Migration Help

Need assistance migrating?

* **Email support**: [info@minimo.it](mailto:info@minimo.it)
* **Documentation**: [New Messaging Channels API](/api-reference/messaging-channels/email/send-template)
* **Dashboard**: Check your API usage at [app.minimo.it/account](https://app.minimo.it/account)

<Tip>We're here to help! If you encounter any issues during migration, reach out to our support team.</Tip>

## Still Using Legacy Endpoints?

If you're still using the deprecated endpoints below, you'll see deprecation warnings in API responses:

```json theme={null}
{
  "data": {
    /* your response */
  },
  "warning": {
    "message": "This endpoint is deprecated and will be removed on June 1, 2026",
    "deprecationDate": "2026-06-01",
    "migrateTo": "/api/templates/email/send",
    "docsUrl": "https://docs.minimo.it/api-reference/messaging-channels/email/send-template"
  }
}
```

Use these warnings to track which integrations need updating.