---
title: "Upgrade to Flowroute Messaging API v2.1"
slug: "upgrade-to-flowroute-messaging-api-v21"
description: "For new customers who take advantage of Flowroute's messaging capabilities, you will be interacting with the Messaging v2.1 by default."
updated: 2025-09-02T20:21:27Z
published: 2025-09-02T20:21:27Z
canonical: "support.bcmone.com/upgrade-to-flowroute-messaging-api-v21"
---

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

# Upgrade to Flowroute Messaging API v2.1

All new Flowroute customers will be interacting with the Messaging v2.1 by default.

For existing customers who are using the Messaging API v2, opting into v2.1 is fairly straightforward. If you're wondering or hesitating, here are some good reasons to upgrade to v2.1:

- Ability to send and receive MMS messages
- Embedded delivery receipt information for outbound SMS
- Ability to configure separate callback URLs for SMS and MMS
- Ability to send compact *and* JSON API requests

## To Get Started With the Upgrade:

1. Log in to your [Flowroute account](https://manage.flowroute.com).
2. Visit **Preferences > API Control** to update your SMS or MMS settings.
3. Select v2.1 in the **SMS Format** drop-down list and click **Save**.

> [!WARNING]
> **IMPORTANT:** Reverting to v2 is currently not an option.

While you can still hit any of the v2 messages endpoint, your Message Detail Records (MDRs) will be rendered in the v2.1 format with embedded delivery receipt information for every outbound SMS that you send.

![](https://cdn.document360.io/505a9638-8582-4eef-8206-3c7a24d46a36/Images/Documentation/outboundMDR sms flowroute.png)

If you want to take advantage of Flowroute's MMS Callback service, configure your [Callback URL with this article.](/flowroute-support/docs/configure-a-callback-url-in-manage-portal)

Enabling MMS will add new attributes from v2.1 to your inbound SMS message detail records (MDRs) as shown below:

![](https://cdn.document360.io/505a9638-8582-4eef-8206-3c7a24d46a36/Images/Documentation/inboundsmsv2.1 flowroute sms(1).png)