---
title: "Transfer subscriptions"
method: POST
path: "/subscriptions/transfer"
tags: ["Subscriptions"]
---

# Transfer subscriptions

`POST /subscriptions/transfer`

Transfers up to 20 subscriptions from a source account to a target account within the same `siteId`.

  - `sourceAccountId` and `targetAccountId` (if provided) must reference the same `siteId`.
  - A maximum of 20 subscriptions can be transferred per request.


In the “Try It!” panel, open the **EXAMPLES** dropdown to select a request example:

  | **Request example**             | **When to use it**                                                                                          |
  | ---------------------------- | ---------------------------------------------------------------------------------------------------------- |
  | New Account Transfer     | Create a new target account **and** transfer subscriptions in one call.                                     |
  | Existing Account Transfer | Transfer subscriptions to an **existing** target account.                                                  |

## Request body

- object
  - `initiatedBy` string, required — Email address of the user initiating the transfer.
  - `sourceAccountId` string, required — Identifier of the account that currently owns the subscriptions to transfer.
  - `targetAccount` object, required
    - `email` string, required — Email address for the target account owner.
    - `account` object, required
      - `firstName` string — First name of the target account owner.
      - `lastName` string — Last name of the target account owner.
      - `company` string — Company name for the target account owner.
      - `phone` string — Phone number for the target account owner.
      - `language` string — Spoken language for the account owner (<a href="https://en.wikipedia.org/wiki/List_of_ISO_639_language_codes">two-letter language code - ISO 639</a>).
      - `address` object, required
        - `line1` string — Address line 1 (e.g., street, PO box, or company name).
        - `city` string — City, district, or suburb for the address.
        - `region` string — State, province, or region for the address. Some validations are applied for countries like USA, Canada, and Australia.
        - `country` string — Country code for the address (<a href="https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2">two-letter country code - ISO 3166-1 alpha-2</a>).
        - `postalCode` string — Postal or ZIP code for the address.
  - `subscriptions` string[], required — List of subscription IDs to be transferred.

## Response `200`

OK

- TransferSubscriptionSuccessResponse
  - `status` string — HTTP status code indicating the result of the transfer operation.
  - `siteId` string — Unique identifier of the site where the subscriptions reside.
  - `sourceAccountId` string — Unique identifier of the account from which subscriptions were transferred.
  - `targetAccountId` string — Unique identifier of the account to which subscriptions were transferred.
  - `transferredSubscriptions` string[] — List of subscription IDs that were successfully transferred.
  - `failedSubscriptions` object[] — Details of any subscriptions that failed to transfer.
    - `subscriptionId` string — The ID of the subscription that could not be transferred.
    - `errorMessage` string — Human-readable explanation of why the transfer failed.
    - `errorCode` string — Machine-readable code categorizing the failure reason.
  - `remainingSubscriptions` string[] — List of subscription IDs still associated with the source account after the transfer.

## Other responses

- `401` — Authentication credentials are missing or invalid.
- `429` — Rate limit exceeded. Retry after the number of seconds specified in the Retry-After header.
- `500` — Internal server error.

---

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