---
title: "Start subscription grace period [Early Access]"
method: POST
path: "/subscriptions/{subscriptionId}/grace-period"
---

# Start subscription grace period \[Early Access\]

`POST /subscriptions/{subscriptionId}/grace-period`

## Request

- Base URL: `https://api.sandbox.cleeng.com/3.1`
- URL: `https://api.sandbox.cleeng.com/3.1/subscriptions/{subscriptionId}/grace-period`
- Auth: API key in header `X-Publisher-Token`

**Please note that this an [Early Access](https://publisher.support.cleeng.com/hc/en-us/articles/10037994501532-Early-Access-Features) phase.** <br><br> Use this endpoint to notify Cleeng when an [externally-managed subscription](https://developers.cleeng.com/docs/externally-managed-subscriptions) (EMS) enters a grace period (a temporary state where a payment attempt has failed, but the customer retains access while the external billing system retries the charge). <br><br> This call registers the grace period's start and its anticipated end date (`gracePeriodEndDate`) in the subscription history to ensure a reliable audit trail. Whenever you retrieve subscription data and a subscription is in grace period, `gracePeriodEndDate` is returned with date, otherwise it is `null`.  <br><br> Note that this is a logging action; the endpoint does not alter the active subscription status itself, and the customer retains full access during this window.

## Path parameters

- `subscriptionId` integer, required

## Request body

- object
  - `gracePeriodEndDate` integer, required: Expected end date of the grace period, as provided by the external billing system. Format: Unix timestamp, seconds since epoch

## Response `200`

## Other responses

- `401`: Unauthorized
- `404`: Not Found
- `409`: Conflict
- `422`: Unprocessable Entity

---

[API](https://skmtc.dev/cleeng/apis/api-31.md) - [All operations](https://skmtc.dev/cleeng/apis/api-31/llms.txt) - [OpenAPI document](https://skmtc.dev/cleeng/apis/api-31/revisions/df55396cda4f?raw)