customer > GDPR
Request Customer Anonymization
Request anonymization of a customer's personal data for GDPR compliance.
This endpoint supports three different ways to identify the customer for anonymization:
Option 1: Customer Number Only
- Send only customerNo in the request body
- Use for company-level anonymization when no specific contact needs to be identified
- Example: { "customerNo": "C00001" }
Option 2: Customer Number with Contact Number
- Send both customerNo and contactNo in the request body
- Use for person-level anonymization when the customer is linked to a specific contact
- Example: { "customerNo": "C00001", "contactNo": "CT00001" }
Option 3: Email Address Only
- Send only email in the request body
- The system will locate the customer using the email address
- Example: { "email": "customer@example.com" }
The anonymization process will:
- Verify if the customer exists in the system
- Check if anonymization is allowed (e.g., no active memberships or pending transactions)
- Create an anonymization request entry for audit purposes
- Return the status and relevant identifiers
Important Notes:
- The customer must not have any active memberships or pending transactions
- The anonymization process is irreversible once executed
- A response code will indicate the reason if anonymization is not possible
- When using email, customer records must exist
Use Cases:
- GDPR "Right to be Forgotten" requests
- Customer account closure with data removal
- Self-service customer data removal via email
- Compliance with data retention policies
post/{tenant}/{environment}/{company}/customer/requestAnonymize
Path parameters
tenantstring required
Your Entra Tenant ID. More details.
environmentstring required
Your Business Central Environment. More details.
companystring required
Your Business Central Company. More details.
Headers
x-np-api-keystring required
x-api-versionstring date
Used for API versioning. More details.
Request body
ServiceGdprAnonymizeCustomerRequest required— unresolved $ref
Response
Response with status 200
ServiceGdprAnonymizeCustomerResponse required— unresolved $ref
Changes
No recorded changes to this endpoint across all 1 revision of this API.