---
uuid: 9a5b82d4-05c8-4186-851a-31327dad4eec
date_created: 2025-07-05T08:07:52.037Z
date_updated: 2026-03-11T09:25:53.710Z
outdated: true
end_of_support_date: 2025-09-01
routes: 
  - POST /v0/subscriptions
---

# Migration of the endpoint POST /v0/subscriptions to POST /v1/subscriptions

## Context

Upgrade from **POST** - `/v0/subscriptions` to **POST** - `/v1/subscriptions`

⭐ **Key benefit :**

* Deletion of deprecated and unuseful fields, to make the endpoint easier to use

## Impacts

Route to call :

* **POST** - `/v1/subscriptions`

**Input became**

```diff
{
  "email": "name@email.com",
  "gender": "M",
  "civility_code": "MR",
  "first_name": "Jean",
  "unicode_first_name": "牛仔裤",
  "last_name": "Chang",
  "unicode_last_name": "昌",
  "phone": "+33145789632",
  "birthdate": "1999-12-20",
- "birthday": "20100430",
- "legal_informations": [
-   {
-     "id": "general_selling_notice",
-     "agreement": true
-   }
- ],
  "optins": [
    {
      "channel": "EMAIL",
      "optin": true,
-     "optin_partners": true
    }
  ],
  "origin_code": "CUSTOMER_ACCOUNT",
  "newsletter_subscriptions": [
    "CLUBMED"
  ]
}
```

* We deleted `birthday` which was deprecated
* We deleted `legal_informations` because the customer's agreement is mandatory for newsletter subscriptions anyway, and the array of `optins` already allows us to confirm that the customer accepted the optins
* We deleted the `optin_partners`, which is no longer used and therefore irrelevant
* We made `optins` and `newsletter_subscriptions` mandatory, to avoid errors