Beglaubigt.de API
Events

Incorporation Submitted

Understanding the Event

The incorporation.submitted event is automatically triggered when the client completes the incorporation process or when an incorporation is submitted via the API.

Payload Fields

webhook_idstring

A unique identifier for this webhook in a UUID format.
Example: 123e4567-e89b-12d3-a456-426614174000

eventstring

The name of the event that triggered this webhook.
Value: incorporation.submitted

messagestring

Provides a human-readable message indicating the result of the webhook event.
Value: The incorporation has been submitted.

incorporation_idstring

The unique identifier for the incorporation in a UUID format.
Example123e4567-e89b-12d3-a456-426614174000

statusstring

The status of the incorporation.
Values: submitted

urlstring

The URL of the incorporation.
Examplehttps://app.beglaubigt.de/incorporate/acme-holding-gmbh/123e4567-e89b-12d3-a456-426614174000

client_referencestring

Your custom reference string provided during incorporation creation.
Example: REF-2025-001

timestampstring

The exact date and time when the webhook was triggered, formatted as an ISO 8601 string in UTC.
Example2025-06-01T08:00:00.443Z

Response
{
  "webhook_id": "123e4567-e89b-12d3-a456-426614174000",
  "event": "incorporation.submitted",
  "message": "The incorporation has been submitted.",
  "incorporation_id": "123e4567-e89b-12d3-a456-426614174000",
  "status": "submitted",
  "url": "https://app.beglaubigt.de/incorporate/acme-holding-gmbh/123e4567-e89b-12d3-a456-426614174000",
  "client_reference": "REF-2025-001",
  "timestamp": "2025-10-18T12:00:00Z"
}

On this page