Skip to main content

Create Institution Disclosure

Loading...
API endpoint path: /db-disclosures/v1/institution-disclosures

This endpoint is part of the Disclosures Service, which manages disclosure definitions for financial institutions and tracks user acceptance of those disclosures in digital banking applications. Institution disclosures define the disclosures that must be presented to users (for example, online statements or regulatory agreements) and serve as the source of truth for downstream user disclosure workflows.

Creates a new institution disclosure definition for the financial institution associated with the authenticated caller. The service validates the request, persists the disclosure, returns the created record (including the newly assigned disclosure identifier), and evicts the institution disclosures cache for that financial institution.

Use this endpoint to:

  • Create a new disclosure definition for a financial institution.
  • Configure disclosure content that will later be presented to users during onboarding or account-related flows.
  • Enable an institution to manage which disclosures are available for user acceptance.

Behavior and capabilities:

  • The request body must include institutionDisclosureName. Do not send institutionDisclosureId on create; the identifier is assigned by the downstream service and returned in the response.
  • Optional disclosure content is supported only as a URL; if institutionDisclosureData is present, institutionDisclosureDataType must be URL. If both data and type are omitted, the disclosure is created without URL content.
  • All request values must be printable ASCII and comply with field length limits enforced by the service.

Request​

Responses​

Success