---
title: "Changes to Create consent"
method: POST
path: "/v1/consents"
---

# Changes to Create consent

`POST /v1/consents`

> Every recorded change to this endpoint, newest first.
> 50 revisions in range; 1 not diffed.

## Timeline

Changed in 5 of 50 revisions.

- **2021-02-22** `15c902aafc60` — 3 breaking, 12 info
- **2021-02-19** `0d82c4699548` — 8 breaking, 9 warning, 26 info
- **2021-02-10** `b51fe6ddb1fc` — 32 breaking, 36 warning, 18 info
- **2021-02-10** `3cc5b6a584f1` — 7 breaking, 6 warning, 27 info
- **2021-02-10** `f324b23056bf` — 2 breaking, 3 warning, 12 info

## Changes

- **2021-02-22** `15c902aafc60` — 3 breaking, 12 info
  - the `access/additionalInformation/ownerName/items/` request property type changed from no type to `object`
  - the `access/additionalInformation/trustedBeneficiaries/items/` request property type changed from no type to `object`
  - the `access/transactions/items/` request property type changed from no type to `object`
  - added the new optional request property `access/additionalInformation/ownerName/items/cashAccountType`
  - added the new optional request property `access/additionalInformation/ownerName/items/currency`
  - added the new optional request property `access/additionalInformation/ownerName/items/iban`
  - added the new optional request property `access/additionalInformation/ownerName/items/otherAccountIdentification`
  - added the new optional request property `access/additionalInformation/trustedBeneficiaries/items/cashAccountType`
  - added the new optional request property `access/additionalInformation/trustedBeneficiaries/items/currency`
  - added the new optional request property `access/additionalInformation/trustedBeneficiaries/items/iban`
  - added the new optional request property `access/additionalInformation/trustedBeneficiaries/items/otherAccountIdentification`
  - added the new optional request property `access/transactions/items/cashAccountType`
  - added the new optional request property `access/transactions/items/currency`
  - added the new optional request property `access/transactions/items/iban`
  - added the new optional request property `access/transactions/items/otherAccountIdentification`
- **2021-02-19** `0d82c4699548` — 8 breaking, 9 warning, 26 info
  - the `header` request parameter `PSU-IP-Address` became required
  - removed the enum value `false` from the `header` request parameter `TPP-Explicit-Authorisation-Preferred`
  - removed the enum value `false` from the `header` request parameter `TPP-Redirect-Preferred`
  - removed the enum value `true` from the `header` request parameter `TPP-Explicit-Authorisation-Preferred`
  - removed the enum value `true` from the `header` request parameter `TPP-Redirect-Preferred`
  - for the `header` request parameter `TPP-Explicit-Authorisation-Preferred`, the type changed from `string` to `boolean`
  - for the `header` request parameter `TPP-Redirect-Preferred`, the type changed from `string` to `boolean`
  - the `access/transactions/items/` request property type changed from `object` to no type
  - removed the request property `access/transactions/items/currency`
  - removed the request property `access/transactions/items/iban`
  - removed the request property `access/transactions/items/otherAccountIdentification`
  - removed the optional property `message` from the response with the `201` status
  - added the new `SCA_INVALID` enum value to the `additionalErrors/items/code` response property for the response status `400` (media type: application/problem+json)
  - added the new `SCA_INVALID` enum value to the `code` response property for the response status `400` (media type: application/problem+json)
  - added the new `SCA_INVALID` enum value to the `tppMessages/items/code` response property for the response status `400` (media type: application/json)
  - added the new `SMTP_OTP` enum value to the `scaMethods/items/authenticationType` response property for the response status `201`
  - added the new `partiallyAuthorised` enum value to the `consentStatus` response property for the response status `201`
  - added the new optional `header` request parameter `TPP-Brand-Logging-Information`
  - added the new optional request property `access/accounts/items/cashAccountType`
  - added the new optional request property `access/additionalInformation`
  - added the new optional request property `access/balances/items/cashAccountType`
  - added the new optional request property `access/restrictedTo`
  - added the new `allAccountsWithOwnerName` enum value to the request property `access/allPsd2`
  - added the new `allAccountsWithOwnerName` enum value to the request property `access/availableAccounts`
  - added the new `allAccountsWithOwnerName` enum value to the request property `access/availableAccountsWithBalance`
  - added the optional property `_links/confirmation` to the response with the `201` status
  - added the optional property `_links/confirmation` to the response with the `400` status (media type: application/json)
  - added the optional property `_links/confirmation` to the response with the `400` status (media type: application/problem+json)
  - added the optional property `_links/confirmation` to the response with the `401` status (media type: application/json)
  - added the optional property `_links/confirmation` to the response with the `401` status (media type: application/problem+json)
  - added the optional property `_links/confirmation` to the response with the `403` status (media type: application/json)
  - added the optional property `_links/confirmation` to the response with the `403` status (media type: application/problem+json)
  - added the optional property `_links/confirmation` to the response with the `404` status (media type: application/json)
  - added the optional property `_links/confirmation` to the response with the `404` status (media type: application/problem+json)
  - added the optional property `_links/confirmation` to the response with the `405` status (media type: application/json)
  - added the optional property `_links/confirmation` to the response with the `405` status (media type: application/problem+json)
  - added the optional property `_links/confirmation` to the response with the `406` status (media type: application/json)
  - added the optional property `_links/confirmation` to the response with the `406` status (media type: application/problem+json)
  - added the optional property `_links/confirmation` to the response with the `409` status (media type: application/json)
  - added the optional property `_links/confirmation` to the response with the `409` status (media type: application/problem+json)
  - …3 more
- **2021-02-10** `b51fe6ddb1fc` — 32 breaking, 36 warning, 18 info
  - the `TPP-Explicit-Authorisation-Preferred` request header's property undefined was restricted to a list of enum values
  - the `TPP-Redirect-Preferred` request header's property undefined was restricted to a list of enum values
  - the `header` request parameter `TPP-Explicit-Authorisation-Preferred` was restricted to a list of enum values
  - the `header` request parameter `TPP-Redirect-Preferred` was restricted to a list of enum values
  - removed the enum value `allAccountsWithOwnerName` of the request property `access/allPsd2`
  - removed the enum value `allAccountsWithOwnerName` of the request property `access/availableAccounts`
  - removed the enum value `allAccountsWithOwnerName` of the request property `access/availableAccountsWithBalance`
  - the `additionalErrors/items/detail` response property's maxLength was increased from `500` to `512` for the response status `400` (media type: application/problem+json)
  - the `additionalErrors/items/detail` response property's maxLength was increased from `500` to `512` for the response status `401` (media type: application/problem+json)
  - the `additionalErrors/items/detail` response property's maxLength was increased from `500` to `512` for the response status `403` (media type: application/problem+json)
  - the `additionalErrors/items/detail` response property's maxLength was increased from `500` to `512` for the response status `404` (media type: application/problem+json)
  - the `additionalErrors/items/detail` response property's maxLength was increased from `500` to `512` for the response status `405` (media type: application/problem+json)
  - the `additionalErrors/items/detail` response property's maxLength was increased from `500` to `512` for the response status `406` (media type: application/problem+json)
  - the `additionalErrors/items/detail` response property's maxLength was increased from `500` to `512` for the response status `409` (media type: application/problem+json)
  - the `additionalErrors/items/detail` response property's maxLength was increased from `500` to `512` for the response status `429` (media type: application/problem+json)
  - the `detail` response property's maxLength was increased from `500` to `512` for the response status `400` (media type: application/problem+json)
  - the `detail` response property's maxLength was increased from `500` to `512` for the response status `401` (media type: application/problem+json)
  - the `detail` response property's maxLength was increased from `500` to `512` for the response status `403` (media type: application/problem+json)
  - the `detail` response property's maxLength was increased from `500` to `512` for the response status `404` (media type: application/problem+json)
  - the `detail` response property's maxLength was increased from `500` to `512` for the response status `405` (media type: application/problem+json)
  - the `detail` response property's maxLength was increased from `500` to `512` for the response status `406` (media type: application/problem+json)
  - the `detail` response property's maxLength was increased from `500` to `512` for the response status `409` (media type: application/problem+json)
  - the `detail` response property's maxLength was increased from `500` to `512` for the response status `429` (media type: application/problem+json)
  - the `tppMessages/items/text` response property's maxLength was increased from `500` to `512` for the response status `400` (media type: application/json)
  - the `tppMessages/items/text` response property's maxLength was increased from `500` to `512` for the response status `401` (media type: application/json)
  - the `tppMessages/items/text` response property's maxLength was increased from `500` to `512` for the response status `403` (media type: application/json)
  - the `tppMessages/items/text` response property's maxLength was increased from `500` to `512` for the response status `404` (media type: application/json)
  - the `tppMessages/items/text` response property's maxLength was increased from `500` to `512` for the response status `405` (media type: application/json)
  - the `tppMessages/items/text` response property's maxLength was increased from `500` to `512` for the response status `406` (media type: application/json)
  - the `tppMessages/items/text` response property's maxLength was increased from `500` to `512` for the response status `409` (media type: application/json)
  - the `tppMessages/items/text` response property's maxLength was increased from `500` to `512` for the response status `429` (media type: application/json)
  - the `challengeData/imageLink` response's property format changed from `url` to no format for status `201`
  - deleted the `header` request parameter `TPP-Brand-Logging-Information`
  - removed the request property `access/accounts/items/bban`
  - removed the request property `access/accounts/items/cashAccountType`
  - removed the request property `access/accounts/items/maskedPan`
  - removed the request property `access/accounts/items/msisdn`
  - removed the request property `access/accounts/items/pan`
  - removed the request property `access/additionalInformation`
  - removed the request property `access/balances/items/bban`
  - …46 more
- **2021-02-10** `3cc5b6a584f1` — 7 breaking, 6 warning, 27 info
  - the `header` request parameter `PSU-IP-Address` became required
  - removed the enum value `false` from the `header` request parameter `TPP-Explicit-Authorisation-Preferred`
  - removed the enum value `false` from the `header` request parameter `TPP-Redirect-Preferred`
  - removed the enum value `true` from the `header` request parameter `TPP-Explicit-Authorisation-Preferred`
  - removed the enum value `true` from the `header` request parameter `TPP-Redirect-Preferred`
  - for the `header` request parameter `TPP-Explicit-Authorisation-Preferred`, the type changed from `string` to `boolean`
  - for the `header` request parameter `TPP-Redirect-Preferred`, the type changed from `string` to `boolean`
  - removed the optional property `message` from the response with the `201` status
  - added the new `SCA_INVALID` enum value to the `additionalErrors/items/code` response property for the response status `400` (media type: application/problem+json)
  - added the new `SCA_INVALID` enum value to the `code` response property for the response status `400` (media type: application/problem+json)
  - added the new `SCA_INVALID` enum value to the `tppMessages/items/code` response property for the response status `400` (media type: application/json)
  - added the new `SMTP_OTP` enum value to the `scaMethods/items/authenticationType` response property for the response status `201`
  - added the new `partiallyAuthorised` enum value to the `consentStatus` response property for the response status `201`
  - added the new optional `header` request parameter `TPP-Brand-Logging-Information`
  - added the new optional request property `access/accounts/items/cashAccountType`
  - added the new optional request property `access/additionalInformation`
  - added the new optional request property `access/balances/items/cashAccountType`
  - added the new optional request property `access/restrictedTo`
  - added the new optional request property `access/transactions/items/cashAccountType`
  - added the new `allAccountsWithOwnerName` enum value to the request property `access/allPsd2`
  - added the new `allAccountsWithOwnerName` enum value to the request property `access/availableAccounts`
  - added the new `allAccountsWithOwnerName` enum value to the request property `access/availableAccountsWithBalance`
  - added the optional property `_links/confirmation` to the response with the `201` status
  - added the optional property `_links/confirmation` to the response with the `400` status (media type: application/json)
  - added the optional property `_links/confirmation` to the response with the `400` status (media type: application/problem+json)
  - added the optional property `_links/confirmation` to the response with the `401` status (media type: application/json)
  - added the optional property `_links/confirmation` to the response with the `401` status (media type: application/problem+json)
  - added the optional property `_links/confirmation` to the response with the `403` status (media type: application/json)
  - added the optional property `_links/confirmation` to the response with the `403` status (media type: application/problem+json)
  - added the optional property `_links/confirmation` to the response with the `404` status (media type: application/json)
  - added the optional property `_links/confirmation` to the response with the `404` status (media type: application/problem+json)
  - added the optional property `_links/confirmation` to the response with the `405` status (media type: application/json)
  - added the optional property `_links/confirmation` to the response with the `405` status (media type: application/problem+json)
  - added the optional property `_links/confirmation` to the response with the `406` status (media type: application/json)
  - added the optional property `_links/confirmation` to the response with the `406` status (media type: application/problem+json)
  - added the optional property `_links/confirmation` to the response with the `409` status (media type: application/json)
  - added the optional property `_links/confirmation` to the response with the `409` status (media type: application/problem+json)
  - added the optional property `_links/confirmation` to the response with the `429` status (media type: application/json)
  - added the optional property `_links/confirmation` to the response with the `429` status (media type: application/problem+json)
  - added the optional property `psuMessage` to the response with the `201` status
- **2021-02-10** `f324b23056bf` — 2 breaking, 3 warning, 12 info
  - for the `header` request parameter `PSU-Device-ID`, the format changed from no format to `uuid`
  - for the `header` request parameter `X-Request-ID`, the format changed from no format to `uuid`
  - removed the request property `access/accounts/items/otherAccountIdentification`
  - removed the request property `access/balances/items/otherAccountIdentification`
  - removed the request property `access/transactions/items/otherAccountIdentification`
  - added the new optional request property `access/accounts/items/bban`
  - added the new optional request property `access/accounts/items/maskedPan`
  - added the new optional request property `access/accounts/items/msisdn`
  - added the new optional request property `access/accounts/items/pan`
  - added the new optional request property `access/balances/items/bban`
  - added the new optional request property `access/balances/items/maskedPan`
  - added the new optional request property `access/balances/items/msisdn`
  - added the new optional request property `access/balances/items/pan`
  - added the new optional request property `access/transactions/items/bban`
  - added the new optional request property `access/transactions/items/maskedPan`
  - added the new optional request property `access/transactions/items/msisdn`
  - added the new optional request property `access/transactions/items/pan`

---

[Operation](https://skmtc.dev/openbankingproject-ch/apis/swiss-nextgen-banking-api-framework/docs/v1/consents/post.md) · [API](https://skmtc.dev/openbankingproject-ch/apis/swiss-nextgen-banking-api-framework.md) · [Page](https://skmtc.dev/openbankingproject-ch/apis/swiss-nextgen-banking-api-framework/changes/v1/consents/post)