Reset a client (test environment only)

Deletes a client and all associated data, allowing you to re-create the client from scratch.

⚠️ TEST ENVIRONMENT ONLY - This endpoint is only available on the test environment (testreferral-api.debitura.com). Calling this endpoint on production will return 403 Forbidden.

Use Cases

• Testing the full onboarding flow multiple times
• Resetting after changing your internal tenant structure during development
• Cleaning up test data without manual intervention

What Gets Deleted (cascade)

• All collection cases and invoices for the client
• All leads for the client
• The Creditor account (removes email from matching algorithm)
• The ReferralPartnerClientLink is archived
• Associated users are cleaned up if they have no other relations

After Reset

• You can call POST /clients with any externalTenantId using the same email
• The matching algorithm will not find the deleted client
• A completely new client will be created (IsAttributedClient=true)

Important

• You can only reset clients that are linked to your partner account
• Pending link requests (409 scenario) cannot be reset - only actual links