---
title: "Pause subscription"
method: POST
path: "/customers/{customerId}/subscriptions/{subscriptionId}/pause"
tags: ["Subscriptions"]
---

# Pause subscription

`POST /customers/{customerId}/subscriptions/{subscriptionId}/pause`

Pauses the subscription.

If the subscription is in dunning, it'll be taken out of dunning.

If the shop has an actions set to trigger when a subscription is paused, they'll be triggered (example: email notifications).

*NOTE: If the request to pause the subscription in Shopify fails, the subscription will still be paused in the Awtomic system to avoid future billing attempts.*

## Path parameters

- `customerId` string, required
- `subscriptionId` string, required

## Response `200`

Updated subscription

- SubscriptionDynamo
  - `SubscriptionId` string — Identifier
  - `SubscriptionStatus` string — Status
  - `NextBillingDate` string, date-time — Date of the next billing

## Other responses

- `401` — You do not have permission
- `404` — Not Found

---

[API](https://skmtc.net/awtomic/apis/awtomic-api.md) · [All operations](https://skmtc.net/awtomic/apis/awtomic-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/awtomic/awtomic-api/versions/dfe3dfce125c/schema)