Hosted Consent Pages

Create Hosted Consent Request

Changed on Jul 13, 2026

Used to initiate a consent request using Yapily Hosted Pages.

post/hosted/consent-requests

Request

Base URL
https://api.yapily.com
Auth
HTTP basic

Headers

sub-applicationstring uuid

The sub-application ID to which event type is being subscribed to

Request body

userIdstring uuid

Conditional. Yapily Identifier for the User returned by the create user step POST /users. You must provide either a userId or applicationUserId.

applicationUserIdstring

Conditional. Your own User reference. This field allows you to use your own unique references for individual users. Where the User reference doesn't have an associated Yapily userId, a new userId is created and linked to it. You must provide either a userId or applicationUserId.

redirectUrlstring required

URL of your server to redirect the user after completion of the consent flow.

oneTimeTokenboolean

Used to receive a oneTimeToken rather than a consentToken at the redirectUrl for additional security.

Example request

{
  "institutionIdentifiers": {
    "institutionCountryCode": "GB"
  },
  "userSettings": {
    "language": "en",
    "location": "GB"
  },
  "redirectUrl": "https://tpp-application.com",
  "accountRequest": {
    "transactionFrom": "2020-01-01T00:00:00Z",
    "transactionTo": "2021-01-01T00:00:00Z",
    "expiresAt": "2025-01-01T00:00:00Z"
  }
}

Response

Created

Example response

{
  "data": {
    "institutionIdentifiers": {
      "institutionCountryCode": "GB"
    },
    "userSettings": {
      "language": "en",
      "location": "GB"
    },
    "redirectUrl": "https://tpp-application.com",
    "accountRequestDetails": {
      "transactionFrom": "2020-01-01T00:00:00Z",
      "transactionTo": "2021-01-01T00:00:00Z",
      "expiresAt": "2025-01-01T00:00:00Z"
    }
  }
}

Changes

Jul 13, 2026f229468213dd Revision changes
- warning
  removed the optional property / from the response with the status
- warning
  removed the optional property / from the response with the status
- warning
  removed the optional property / from the response with the status
- warning
  removed the optional property / from the response with the status
- warning
  removed the optional property / from the response with the status
- warning
  removed the optional property / from the response with the status
- warning
  removed the optional property / from the response with the status
- warning
  removed the optional property / from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  the response property / became required for the status
- info
  the response property / became required for the status
- info
  the response property / became required for the status
- info
  the response property / became required for the status
- info
  the response property / became required for the status
- info
  the response property / became required for the status
- info
  the response property / became required for the status
- info
  the response property / became required for the status
- info
  the response property / became required for the status
- info
  the response property / became required for the status
- info
  the response property / became required for the status
- info
  the response property / became required for the status
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status

Operation history