Tax Registration Initiated
Understanding the Event
The tax-registration.initiated event is automatically triggered once a tax registration case is created and a UUID has been assigned to it.
Payload Fields
webhook_idstringA unique identifier for this webhook in a UUID format.
Example: 123e4567-e89b-12d3-a456-426614174000
eventstringThe name of the event that triggered this webhook.
Value: tax-registration.initiated
messagestringProvides a human-readable message indicating the result of the webhook event.
Value: The tax registration has been initiated.
tax_registration_idstringThe unique identifier for the tax registration in a UUID format.
Example: 123e4567-e89b-12d3-a456-426614174000
statusstringThe status of the tax registration.
Value: initiated
urlstringThe URL of the tax registration.
Example: https://app.beglaubigt.de/register/tax/acme-holding-gmbh/123e4567-e89b-12d3-a456-426614174000
client_referencestringYour custom reference string provided when the tax registration was created.
Example: REF-2025-001
timestampstringThe exact date and time when the webhook was triggered, formatted as an ISO 8601 string in UTC.
Example: 2025-06-01T08:00:00.443Z
{
"webhook_id": "123e4567-e89b-12d3-a456-426614174000",
"event": "tax-registration.initiated",
"message": "The tax registration has been initiated.",
"tax_registration_id": "123e4567-e89b-12d3-a456-426614174000",
"status": "initiated",
"url": "https://app.beglaubigt.de/register/tax/acme-holding-gmbh/123e4567-e89b-12d3-a456-426614174000",
"client_reference": "REF-2025-001",
"timestamp": "2025-10-18T12:00:00Z"
}