# Create a next period for this subscription

Create a next period for this subscription

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

## Path parameters:

  - `id` (string, required)

## Request fields (application/json):

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

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

## Response 201 fields (application/json):

  - `id` (string, required)
    Example: "SPD344S1PDY8XX"

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

  - `amount` (integer, required)
    Example: 1500

  - `period_number` (integer, required)
    Example: 1

  - `subscription` (string, required)
    Example: "PSUJDW4VCMG9JS"

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

  - `payments` (object, required)
    Example: {"type":"list","data":[{"id":"PPH25H07JYWLR7PA82","type":"payment","amount":1000,"description":"Test Payment","currency":"EUR","state":"paid","refunded_amount":0,"return_url":"https://example.com/thank-you","cancel_url":"https://example.com/cancel","paid_at":"2023-06-30T12:44:35Z","created_at":"2023-06-30T12:40:10Z","_links":{"self":"https://api.paypro.nl/payments/PPH25H07JYWLR7PA82"}}],"count":1,"_links":{"self":"https://api.paypro.nl/subscription_periods/SPD344S1PDY8XX/payments"}}

  - `payments.data` (array, required)
    Example: [{"id":"PPH25H07JYWLR7PA82","type":"payment","amount":1000,"description":"Test Payment","currency":"EUR","state":"paid","refunded_amount":0,"return_url":"https://example.com/thank-you","cancel_url":"https://example.com/cancel","paid_at":"2023-06-30T12:44:35Z","created_at":"2023-06-30T12:40:10Z","_links":{"self":"https://api.paypro.nl/payments/PPH25H07JYWLR7PA82"}}]

  - `payments.data.description` (string, required)
    Example: "Test Payment"

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

  - `payments.data.pay_method` (any, required)
    Example: {"id":"ideal","type":"pay_method","name":"iDEAL","currencies":["EUR"],"minimum_amount":10,"maximum_amount":5000000,"details":{}}

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

  - `payments.data.return_url` (string,null, required)
    Example: "https://example.com/thank-you"

  - `payments.data.cancel_url` (string,null, required)
    Example: "https://example.com/cancel"

  - `payments.data.metadata` (object, required)
    Example: {}

  - `payments.data.customer` (string,null, required)
    Example: "CU7JRN6W6K3DA9"

  - `payments.data.mandate` (string,null, required)
    Example: "MD6ULYXJ4HP9RJ"

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

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

  - `payments.data.paid_at` (string,null, required)
    Example: "2023-06-30T12:44:35Z"

  - `payments.data.fail_reason` (string,null)

  - `payments.data.created_at` (string,null, required)
    Example: "2023-06-30T12:40:10Z"

  - `payments.data._links` (object, required)
    Example: {"self":"https://api.paypro.nl/payments/PPH25H07JYWLR7PA82","customer":"https://api.paypro.nl/customers/CU7JRN6W6K3DA9","mandate":"https://api.paypro.nl/mandates/MD6ULYXJ4HP9RJ"}

  - `payments.data._links.self` (string, required)
    Example: "https://api.paypro.nl/payments/PPH25H07JYWLR7PA82"

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

  - `payments.count` (integer, required)
    Example: 1

## 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"