# Create a next period for this subscription

Create a next period for this subscription

Endpoint: POST /subscriptions/{id}/subscription_periods
Version: v1
Security: apiKey

## Security:

  - `apiKey` (unknown)
    http bearer API key

## Path parameters:

  - `id` (string, required)
    ID of the subscription

## Request fields (application/json):

  - `amount` (integer, required)
    The amount that the customer will have to pay in the next period.

  - `description` (string)
    Description of the subscription. This will be shown to customers and in the PayPro dashboard

## Response 201:

  - `201` (unknown)
    subscription period created

## Response 201 fields (application/json):

  - `id` (string, required)

  - `type` (string, required)
    Enum: "subscription_period"

  - `amount` (integer, required)

  - `period_number` (integer, required)

  - `subscription` (string, required)

  - `state` (string, required)
    Enum: "open", "pending", "paid", "canceled", "reversed", "refunded"

  - `payments` (object, required)

  - `payments.type` (string, required)
    Enum: "list"

  - `payments.data` (array, required)

  - `payments.data.id` (string, required)

  - `payments.data.type` (string, required)
    Enum: "payment"

  - `payments.data.amount` (integer, required)

  - `payments.data.description` (string, required)

  - `payments.data.currency` (string, required)
    Enum: "EUR"

  - `payments.data.pay_method` (any, required)

  - `payments.data.pay_method.id` (string, required)

  - `payments.data.pay_method.type` (string, required)
    Enum: "pay_method"

  - `payments.data.pay_method.name` (string, required)

  - `payments.data.pay_method.currencies` (array)

  - `payments.data.pay_method.minimum_amount` (integer)

  - `payments.data.pay_method.maximum_amount` (integer)

  - `payments.data.pay_method.details` (object)

  - `payments.data.pay_method.details.issuers` (array)

  - `payments.data.pay_method.details.issuers.code` (string)

  - `payments.data.pay_method.details.issuers.name` (string)

  - `payments.data.pay_method.details.iban` (string)

  - `payments.data.pay_method.details.bic` (string)

  - `payments.data.pay_method.details.account_name` (string)

  - `payments.data.pay_method.details.routing_number` (string)

  - `payments.data.pay_method.details.account_number` (string)

  - `payments.data.state` (string, required)

  - `payments.data.refunded_amount` (integer, required)

  - `payments.data.return_url` (string, required)

  - `payments.data.cancel_url` (string, required)

  - `payments.data.metadata` (object, required)

  - `payments.data.customer` (string, required)

  - `payments.data.mandate` (string, required)

  - `payments.data.subscription` (string, required)

  - `payments.data.installment_plan` (string, required)

  - `payments.data.locale` (string, required)
    Enum: "de", "en", "fr", "nl"

  - `payments.data.paid_at` (string, required)

  - `payments.data.fail_reason` (string)
    Enum: "The transaction amount or count exceeds the permitted frequency for this card or account.", "The card holder lacks sufficient funds to complete the transaction.", "The transaction could not be processed with the provided card number.", "The issuer has declined the transaction for authentication reasons.", "The transaction is suspected to be fraudulent.", "The issuer did not allow this transaction against this card based on internal reasons, such as the transaction originated from a specifically restricted industry or country.", "The payment is declined."

  - `payments.data.created_at` (string, required)

  - `payments.data._links` (object, required)

  - `payments.data._links.self` (string, required)

  - `payments.data._links.customer` (string)

  - `payments.data._links.mandate` (string)

  - `payments.data._links.subscription` (string)

  - `payments.data._links.installment_plan` (string)

  - `payments.data._links.checkout` (string)

  - `payments.count` (integer, required)

  - `payments._links` (object, required)

  - `payments._links.self` (string, required)

  - `created_at` (string, required)

  - `_links` (object, required)

  - `_links.self` (string, required)

  - `_links.subscription` (string, required)

## Response 404:

  - `404` (unknown)
    subscription not found

## Response 404 fields (application/json):

  - `error` (object, required)

  - `error.message` (string, required)
    The error message

  - `error.type` (string, required)
    Type of error
    Enum: "invalid_request"