---
url: /kb/show-self-service/integrations/webhook-registration.md
---

# Webhook registration

A webhook registers a person on the event from HubSpot, Zapier, or another HTTP client. After a successful POST they **log in** on the event page with their email and the password from the webhook. They do not skip login.

The same URL is used for managed events and self-service:

`https://webcast.meetyoo.de/wh/register/{eventId}/{type}`

`eventId` is the 12-character webcast ID. `type` is `hs` (HubSpot) or `api` (generic JSON, including Zapier).

Authenticate with HTTP Basic: header `Authorization` and value `Basic …` from the hub **Client ID** and **Client secret**. Query parameters `registrar` and `registrarpw` also work; prefer Basic so secrets stay out of URLs and logs.

The credential must be **activated** on that event. Otherwise registration is rejected.

You can turn off the public registration form and still accept webhook users. They use the login page.

## HubSpot (`hs`)

POST the **full contact object**. Email, first name, and last name come from the contact. The login password defaults to HubSpot `vid`.

## Generic / Zapier (`api`)

POST JSON:

```json
{
  "email": "user@example.com",
  "firstname": "Tim",
  "lastname": "Adelmann",
  "password": "secret"
}
```

Required: `email`, `firstname`, `lastname`, `password`. Keys prefixed `profile:` become custom registration properties.

A `200` response with `{ "message": "OK" }` means the person was created or updated. They appear under Event → Users.

## Configure in ContentHub Admin

Webhook credentials live on the **hub**. You activate them per event.

## Request credentials

1. Open **Settings** → **Integrations**.
2. On the **SSO** card, choose **Request SSO credentials** (Starter and above; Free shows an upgrade prompt).
3. When ops have issued them, copy **Client ID**, **Client secret**, and **Authorization value** from the table.

A request emails `webcast@meetyoo.de`. It is not instant. There is a 24-hour rate limit.

## Activate on the event

1. Open the event. Under **Event Configuration** → **General**, open the **Access** tab.
2. Set access to **Registration** (the webhook block is hidden otherwise).
3. Optionally select **Disable registration page** if people should only arrive via webhook, then log in.
4. Under **Webhook and SSO registration**, turn on the **Webhook** credential.
5. Copy the **HubSpot** URL (`…/hs`) or the **Webhook** URL (`…/api`).
6. Choose **Save**.

### HubSpot

In a HubSpot workflow, action **Send webhook**, method **POST**. Paste the HubSpot URL. Auth type **API key**, header name `Authorization`, value the **Authorization value** including `Basic `. Payload: **Full contact object**.

### Zapier or generic HTTP

POST JSON to the **Webhook** URL with the same Basic header. Body: `email`, `firstname`, `lastname`, `password`.

Registered people appear under **Users**. If the hub has no credentials yet, the Access tab links to **Settings → Integrations**.
