Skip to content

Update consents

Consent management in tebio makes it possible to record customer consents relevant to data protection law in a structured manner. Typical use cases include consent to receive newsletters or marketing emails and acceptance of updated terms and conditions.

  • A customer asks you by phone or email to remove them from the marketing mailing list (opt-out).
  • You have received express verbal or written permission from a B2B contact to send them product-related information (opt-in).
  • You are logged in to the tebio business portal.
  • You are in the customer profile.

[!IMPORTANT] Requirement in the business portal: Configure consent types In order for consents to be selectable via dropdown in the tebio business portal, they must be configured in advance. To do this, navigate to General Settings > Platform > Custom Fields. Create a new field there with the entity Customer and the entity type Consent. This step is not necessary for direct use via the API, as consents can be processed there as a flexible JSON document.

To view a customer’s existing consent:

  1. Open the customer’s detailed view.
  2. Click on the three-dot menu (…) at the top right.
  3. Select the item Consent.

A tabular overview of all recorded consents opens.

[!TIP] Historization of consent tebio does not simply overwrite consent. To ensure that it remains traceable from when to when consent was given, previous states are historicized. Please note the Valid from and Valid to columns. The Channel column shows which channel the consent was collected through, for example via the self-care / customer portal.

If you would like to change a consent:

  1. Above the table, click Update consents.
  2. The Consent Management dialog opens.

Adjust existing consents In the upper area of the dialog you can see all types of consent currently active for this customer, for example marketing. Use the switch to change the status from Yes to No or vice versa.

Add new consents If the customer has not yet made a decision about a specific consent type, that consent type will not appear in the list.

  1. Click + Add consent.
  2. The Consent Type drop-down box appears.
  3. Select the desired type of consent, for example marketing, from the list. Only consent types that have been previously configured appear here.
  4. The switch defaults to Yes.
  5. Click Update Consents.

tebio saves your entries, historicizes previous states and reloads the overview.

  • Missing consent types: If the dropdown is empty when adding a new consent, no appropriate consent types have been configured in the General Settings yet.
  • Deletion of consent: Deletion in the traditional sense is not provided for in the business portal. Previous states are historicized so that changes remain traceable.

In the API, consents are managed as a sub-resource of the respective customer. Unlike the Business Portal, the API does not require pre-configuration of consent types. The API can process the consent content as a flexible JSON document.

The following endpoints are available:

End pointMethodDescriptionOperationId
/v1/customer/consentGETSearch or list consentssearchCustomerConsent
/v1/customer/consentPOSTCreate consent for a customercreateCustomerConsent
/v1/customer/consent/{uuid}GETGet consent detailsgetCustomerConsent
/v1/customer/consent/{uuid}PATCHUpdate consentupdateCustomerConsent
/v1/customer/consent/{uuid}PUTReplace consentreplaceCustomerConsent
/v1/customer/consent/{uuid}DELETEDelete consentdeleteCustomerConsent

Consent types are prepared in the Business Portal via custom fields with the Consent entity type.