Create customer workspaces with the Partner API

The Partner API creates customer workspaces from your own system, for example when an order is paid. Each call follows the same rules as Add customer in the Partner portal.

Before you begin

• Your Partner company has approved commercial terms, and you accepted the current Partner Terms.
• You are an admin of your Partner company.
• For Partner pays meetergo, the Partner billing setup is complete. See Create and set up a customer workspace.

Create an API key

1. Open Partner portal > API.
2. Select Create API key and give the key a name, for example "Production".
3. Copy the key. It starts with mgp_ and is shown only once.

Store the key as a secret on your server. Never put it in a website or app: anyone with the key can create workspaces billed to you.

The key acts with your admin rights. It stops working when you revoke it, or when the person who created it is no longer an admin of your Partner company. You can have two active keys, so you can switch to a new key before revoking the old one.

Authentication

Send the key as a bearer token on every request:

Authorization: Bearer mgp_...

Base URL: https://api.meetergo.com

Create a customer

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
  }'

The response contains the new customer with its companyId and bookingPageUrl. The customer's admin gets an invite email and sets their own password. The booking page takes bookings right away, before they accept.

List and read customers

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"

The list returns your active customers, newest first. limit is 1 to 100. hasMore tells you whether another page exists.

Embed the booking page

Put the returned bookingPageUrl on the customer's website:

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

Errors

Errors return JSON with statusCode and message.

Revoke a key

Open Partner portal > API and select Revoke next to the key. Requests with it fail immediately. Customers you already created are not affected.