v2

latestSwagger 2.02026-08-0610101.9 MB
Open banking

Register Tell consent

Register a Tell consent for open banking on your customers' accounts.

After granting a consent with Tell Money, register it with Griffin so that Griffin can validate Tell's subsequent resource requests.

tell-consent-permissions behaviour depends on tell-consent-scope:

  • accounts scope requires at least one permission; this controls which AISP operations the TPP can perform (e.g. reading balances or transactions).
  • payments scope does not use permissions — Tell Money returns them empty and Griffin authorises payment operations from the scope alone. Pass [] (matching Tell's response) or any value; the field is still required in the request.
post/v0/organizations/{organization-id}/open-banking/tell-consents

Path parameters

organization-idstring required

Request body

tell-consent-idstring uuid required
tell-gateway-idstring uuid required
tell-consent-scope'payments' | 'accounts' required
tell-consent-permissionsstring[] required

Permissions granted by the consent. For accounts scope, must list at least one permission. For payments scope, pass [] — Tell Money returns no permissions and Griffin authorises payments from the scope alone.

tell-consent-expirystring date-time

ISO 8601 formatted date-time.

Response

Created

tell-consent-expirystring date-time

ISO 8601 formatted date-time.

tell-gateway-idstring uuid required
created-atstring date-time required

ISO 8601 formatted date-time.

tell-consent-idstring uuid required
tell-consent-consumed-atstring date-time

ISO 8601 formatted date-time.

tell-consent-revoked-atstring date-time

ISO 8601 formatted date-time.