---
title: "Create new permits linked to a recurring contract."
method: POST
path: "/createPermit"
tags: ["General"]
---

# Create new permits linked to a recurring contract.

`POST /createPermit`

Create permits for a recurring contract, including support for defining restrictions.

## Request body

- CreatePermitRequest
  - `merchantAccount` string, required — The merchant account identifier, with which you want to process the transaction.
  - `permits` Permit[], required — The permits to create for this recurring contract.
    - `partnerId` string — Partner ID (when using the permit-per-partner token sharing model).
    - `profileReference` string — The profile to apply to this permit (when using the shared permits model).
    - `restriction` PermitRestriction
      - `maxAmount` Amount
        - `currency` string, required — The three-character [ISO currency code](https://docs.adyen.com/development-resources/currency-codes).
        - `value` integer, required — The amount of the transaction, in [minor units](https://docs.adyen.com/development-resources/currency-codes).
      - `singleTransactionLimit` Amount
        - `currency` string, required — The three-character [ISO currency code](https://docs.adyen.com/development-resources/currency-codes).
        - `value` integer, required — The amount of the transaction, in [minor units](https://docs.adyen.com/development-resources/currency-codes).
      - `singleUse` boolean — Only a single payment can be made using this permit if set to true, otherwise multiple payments are allowed.
    - `resultKey` string — The key to link permit requests to permit results.
    - `validTillDate` string, date-time — The expiry date for this permit.
  - `recurringDetailReference` string, required — The recurring contract the new permits will use.
  - `shopperReference` string, required — The shopper's reference to uniquely identify this shopper (e.g. user ID or account ID).

## Response `200`

OK - the request has succeeded.

- CreatePermitResult
  - `permitResultList` PermitResult[] — List of new permits.
    - `resultKey` string — The key to link permit requests to permit results.
    - `token` string — The permit token which is used to make payments by the partner company.
  - `pspReference` string — A unique reference associated with the request. This value is globally unique; quote it when communicating with us about this request.

## Other responses

- `400` — Bad Request - a problem reading or understanding the request.
- `401` — Unauthorized - authentication required.
- `403` — Forbidden - insufficient permissions to process the request.
- `422` — Unprocessable Entity - a request validation error.
- `500` — Internal Server Error - the server could not process the request.

## Changes

- **2023-03-13** (v68) `a02eae2ddd70` — 12 breaking
  - the request's body type changed from no type to `object`
  - the `permits/items/` request property type changed from no type to `object`
  - the `permits/items/restriction` request property type changed from no type to `object`
  - the `permits/items/restriction/maxAmount` request property type changed from no type to `object`
  - …8 more
- **2023-01-12** (v68) `e0adb3284702` — 1 info
  - endpoint added
- **2022-09-27** (v68) `35b6c488630a` — 1 breaking
  - api path removed without deprecation
- **2022-09-27** (v68) `8c2c2f3de58d` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/adyen/apis/recurringservice/changes/createPermit/post.md)

---

[API](https://skmtc.dev/adyen/apis/recurringservice.md) · [All operations](https://skmtc.dev/adyen/apis/recurringservice/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/adyen/recurringservice/revisions/3280fa74deee/schema)