Partner-API: Kunden-Workspaces anlegen und verwalten

Die Partner-API verbindet dein eigenes System mit meetergo. Lege einen Kunden-Workspace an, sobald eine Bestellung bezahlt ist, starte ihn aus einer Branchenvorlage, richte ihn über die Platform API ein und verwalte seine Nutzer. Jeder Aufruf folgt denselben Regeln wie das Partnerportal.

Bevor du startest

• Deine Partnerfirma hat freigegebene kommerzielle Konditionen, und du hast die aktuellen Partnerbedingungen akzeptiert.
• Du bist Admin deiner Partnerfirma.
• Für Partner zahlt meetergo ist die Partner-Abrechnung eingerichtet. Siehe Kunden-Workspace anlegen und einrichten.

API-Schlüssel erstellen

1. Öffne Partnerportal > API.
2. Wähle API-Schlüssel erstellen und gib dem Schlüssel einen Namen, zum Beispiel „Produktion“.
3. Kopiere den Schlüssel. Er beginnt mit mgp_ und wird nur einmal angezeigt.

Speichere den Schlüssel als Secret auf deinem Server. Nutze ihn nie in einer Website oder App: Wer den Schlüssel hat, kann Workspaces anlegen, die dir berechnet werden.

Der Schlüssel handelt als der Partneradmin, der ihn erstellt hat. Er funktioniert nicht mehr, wenn du ihn widerrufst oder wenn diese Person kein Admin deiner Partnerfirma mehr ist. Du kannst zwei aktive Schlüssel haben. So wechselst du zu einem neuen Schlüssel, bevor du den alten widerrufst.

Authentifizierung

Sende den Schlüssel bei jeder Anfrage als Bearer-Token:

Authorization: Bearer mgp_...

Basis-URL: https://api.meetergo.com

Alle Endpunkte stehen in der OpenAPI-Spezifikation unter api.meetergo.com/spec/v2 mit dem Tag Partner API.

Endpunkte

Kunden anlegen

POST /v4/partner/customers

curl -X POST https://api.meetergo.com/v4/partner/customers \
  -H "Authorization: Bearer $MEETERGO_PARTNER_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "requestId": "6f1c2a8e-3b4d-4e5f-8a9b-0c1d2e3f4a5b",
    "companyName": "Friseur Muster",
    "adminFirstName": "Max",
    "adminLastName": "Muster",
    "adminEmail": "max@friseur-muster.de",
    "language": "de",
    "timezone": "Europe/Berlin",
    "billingResponsibility": "partner",
    "suiteTier": "suite",
    "communicationOwner": "partner",
    "contactConsentConfirmed": true,
    "templateKey": "beauty"
  }'

Die Antwort enthält:

Der Admin deines Kunden bekommt eine Einladung per E-Mail und legt sein Passwort selbst fest. Die Buchungsseite nimmt sofort Buchungen an, auch vor der Annahme der Einladung.

Branchenvorlagen

Mit templateKey startet der Workspace mit den Terminarten, wöchentlichen Öffnungszeiten, E-Mail-Erinnerungen und, wo sinnvoll, einem Routing-Formular der Branche. Die Inhalte der Vorlagen sind auf Deutsch.

Ohne templateKey bekommt der Workspace wie bisher eine Start-Buchungsseite. Die Vorlage wird einmal beim Anlegen angewendet. Änderungen danach machst du mit einem Workspace-Token.

Kunden auflisten und abrufen

curl "https://api.meetergo.com/v4/partner/customers?limit=50&offset=0" \
  -H "Authorization: Bearer $MEETERGO_PARTNER_KEY"

curl https://api.meetergo.com/v4/partner/customers/{companyId} \
  -H "Authorization: Bearer $MEETERGO_PARTNER_KEY"

Die Liste liefert deine aktiven Kunden, die neuesten zuerst. limit liegt zwischen 1 und 100. hasMore zeigt, ob es eine weitere Seite gibt.

Kunden ändern

Sende companyName, communicationOwner oder beides. Die Antwort ist der geänderte Kunde.

curl -X PATCH https://api.meetergo.com/v4/partner/customers/{companyId} \
  -H "Authorization: Bearer $MEETERGO_PARTNER_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "companyName": "Friseur Muster GmbH", "communicationOwner": "meetergo" }'

Workspace-Token

Mit einem Workspace-Token richtet dein System genau einen Kunden-Workspace über die normale Platform API ein: Terminarten, Verfügbarkeit, Buchungsseite, Routing-Formulare und mehr.

Token holen

curl -X POST https://api.meetergo.com/v4/partner/customers/{companyId}/token \
  -H "Authorization: Bearer $MEETERGO_PARTNER_KEY"

{
  "token": "mgw_...",
  "tokenType": "Bearer",
  "companyId": "3f2b...",
  "expiresAt": "2026-10-01T10:00:00.000Z",
  "expiresIn": 3600
}

Token nutzen

Sende den Token statt deines mgp_-Schlüssels:

curl https://api.meetergo.com/v4/meeting-type \
  -H "Authorization: Bearer $MEETERGO_WORKSPACE_TOKEN"

• Er gilt für genau diesen einen Kunden-Workspace.
• Er handelt mit deinem Partneradmin-Zugang in diesem Workspace, wie Workspace öffnen im Portal.
• Sende nicht den Header x-meetergo-api-user-id. Anfragen damit werden abgelehnt.

Token erneuern

Der Token gilt 1 Stunde. Hol dir danach mit deinem mgp_-Schlüssel einen neuen. Einen Refresh-Token gibt es nicht.

Was ein Workspace-Token nicht kann

Diese Anfragen liefern 403:

• API-Schlüssel oder persönliche Zugriffstoken im Kunden-Workspace erstellen
• alles, was den Kontakten des Kunden Nachrichten sendet: WhatsApp, SMS, E-Mail-Versand, Newsletter und ausgehende Mira-Nachrichten
• interne Dashboard-Endpunkte (/rpc)

Der Kunde behält die Kontrolle

Jede Anfrage mit einem Workspace-Token wird protokolliert. Die Admins deines Kunden sehen unter Einstellungen > Entwickler den Hinweis Dein Partner (Name) hat API-Zugang mit deinen letzten API-Änderungen.

Sie können diesen Zugang entziehen und jederzeit wiederherstellen. Solange er entzogen ist, liefern das Holen eines Tokens und jeder bestehende Token 403 mit dem Hinweis, dass der Kunde den Partner-API-Zugang entzogen hat. Der Dashboard-Zugang über Workspace öffnen wird getrennt davon verwaltet. Siehe Partnerzugang, Übergabe und Entzug.

Kundennutzer verwalten

Es gelten dieselben Regeln wie unter Nutzer verwalten. Siehe Kundennutzer und abrechenbare Plätze verwalten.

# Nutzer auflisten
curl https://api.meetergo.com/v4/partner/customers/{companyId}/users \
  -H "Authorization: Bearer $MEETERGO_PARTNER_KEY"

# 1 bis 100 Nutzer einladen
curl -X POST https://api.meetergo.com/v4/partner/customers/{companyId}/users \
  -H "Authorization: Bearer $MEETERGO_PARTNER_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "emails": ["anna@friseur-muster.de"] }'

# Nutzer entfernen oder offene Einladung stornieren
curl -X DELETE https://api.meetergo.com/v4/partner/customers/{companyId}/users/{userId} \
  -H "Authorization: Bearer $MEETERGO_PARTNER_KEY"

• Die Liste liefert companyName und items. Jeder Eintrag hat id, name, email, type, isAdmin, status (active oder pending) und billable.
• Einladungen liefern processedEmails, unprocessedEmails und deliveryFailedEmails. Eingeladene Nutzer bekommen die normale Einladungs-E-Mail von meetergo. Du legst nie Passwörter fest.
• Ist eine Zustellung fehlgeschlagen, sende dieselbe Adresse erneut.
• Entfernen liefert removedUserId und removedStatus.

Abrechnung und Provision

Siehe Refer-Provisionskonto und Auszahlungen.

Buchungsseite einbetten

Füge die zurückgegebene bookingPageUrl in die Website deines Kunden ein:

<div
  style="min-width:330px"
  class="meetergo-iframe"
  data-src="{bookingPageUrl}"
></div>
<script src="https://cdn.meetergo.com/v4/integration.js"></script>

Fehler

Fehler kommen als JSON mit statusCode und message.

Schlüssel widerrufen

Öffne Partnerportal > API und wähle Widerrufen neben dem Schlüssel. Anfragen damit schlagen sofort fehl, ebenso Workspace-Tokens, die mit ihm geholt wurden. Bereits angelegte Kunden sind nicht betroffen.

Verwandte Artikel

• Kunden-Workspace mit Buchungsseite in 10 Minuten
• Kunden-Workspaces mit Claude oder ChatGPT über meetergo MCP einrichten
• API-Dokumentation Übersicht
• Kunden-Workspace anlegen und einrichten
• Kundennutzer und abrechenbare Plätze verwalten
• Partnerzugang, Übergabe und Entzug