Appointment Completed
Understanding the Event
The appointment.completed event is automatically triggered when the notary appointment date has passed.
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: appointment.completed
messagestringProvides a human-readable message indicating the result of the webhook event.
Value: The notary appointment date has passed.
incorporation_idstringThe unique identifier for the incorporation in a UUID format.
Example: 123e4567-e89b-12d3-a456-426614174000
namestringThe legal name of the company.
Example: Acme Holdings GmbH
typestringThe type of company incorporated.
Possible values: gmbh or ug
capitalnumberThe total share capital of the company in EUR.
Example: 25000
statusstringThe status of the incorporation.
Value: appointment-confirmed
urlstringThe URL of the incorporation.
Example: https://app.beglaubigt.de/incorporate/acme-holding-gmbh/123e4567-e89b-12d3-a456-426614174000
notarizationobjectDetails about the notarization process.
typestringThe method of notarization.
Possible values: offline or online
expressbooleanRequests expedited notarization.
preferred_locationstringThe client's preferred location for notarization, specified as a city name in either German or English. Example: Munich
preferred_timeframenumberThe client's preferred timeframe for notarization, expressed as the number of days from the request date.
Possible values: 7, 14, 30
datestringNotarization date in YYYY-MM-DD format.
Example: 2025-04-16
timestringNotarization date in HH:mm format.
Example: 14:30
appointment_statusstringThe current status of the notarization appointment.
Possible values: pending or confirmed
notaryobjectNotary responsible for the notarization.
officestringThe name of the notary’s office.
Example: Notariat Schiller & Partner
namestringThe full name of the notary.
Example: Dr. Anna Becker
emailstringThe email address of the notary.
Example: dr.becker@notariat-schiller.de
phonestringThe contact phone number of the notary.
Example: +49 89 12345678
addressstringThe full address of the notary's office, formatted as street name and number, postal code, city.
Example: Schillerstraße 15, 10117, Berlin
client_referencestringYour custom reference string provided during incorporation creation.
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": "appointment.completed",
"message": "The notary appointment date has passed.",
"incorporation_id": "123e4567-e89b-12d3-a456-426614174000",
"name": "Acme Holdings GmbH",
"type": "gmbh",
"capital": 12500,
"status": "appointment-completed",
"url": "https://app.beglaubigt.de/incorporate/acme-holding-gmbh/123e4567-e89b-12d3-a456-426614174000",
"notarization": {
"type": "online",
"express": false,
"preferred_location": "Berlin",
"preferred_timeframe": 7,
"date": "2025-05-16",
"time": "14:30",
"appointment_status": "confirmed",
"notary": {
"office": "Notariat Schiller & Partner",
"name": "Dr. Anna Becker",
"email": "dr.becker@notariat-schiller.de",
"phone": "+49 89 12345678",
"address": "Schillerstraße 15, 10117, Berlin"
}
},
"client_reference": "REF-2025-001",
"timestamp": "2025-10-18T12:00:00Z"
}