---
title: "Register someone for an event date"
method: PUT
path: "/event/register"
tags: ["Registration"]
---

# Register someone for an event date

`PUT /event/register`

## Request

- Base URL: `https://my.demio.com/api/v1`
- URL: `https://my.demio.com/api/v1/event/register`
- Auth: API key in header `Api-Key` and API key in header `Api-Secret`

Registers a person and returns the link they use to join.

Identify the event either by `id` or by `ref_url`, its registration
page link. Omit `date_id` to place the registrant on the event's next
date. The person's name goes in the single `name` field. `POST`
behaves identically to `PUT` on this endpoint.

## Request body

- RegistrationRequest: Identify the event with `id` or `ref_url`, and the person with `name` and `email`.
  - `id` integer: The event id. Use this or `ref_url`.
  - `ref_url` string, uri: The event's registration page link. Use this or `id`.
  - `date_id` integer: The event date to register for. Omit it to use the event's next date.
  - `name` string, required: The person's full name, as one field. It must not contain a URL.
  - `email` string, email, required

## Response `201`

The person is registered.

- RegistrationResult
  - `hash` string, required: The registrant's identifier for this event date.
  - `join_link` string, uri, required: The link the person opens to join.

## Other responses

- `400`: The payload was rejected. Each problem is listed.
- `401`: The credentials were missing or rejected.
- `403`: The account is not active, or the id in the path is not one your account may read. An id that does not exist answers here too, so the API does not reveal whether it exists.
- `417`: The per-minute request rate or the account's daily API allowance was exceeded.
- `500`: Something failed on our side. The message is always generic; no internal detail is returned.

---

[API](https://skmtc.dev/demio/apis/public-demio-api.md) - [All operations](https://skmtc.dev/demio/apis/public-demio-api/llms.txt) - [OpenAPI document](https://skmtc.dev/demio/apis/public-demio-api/revisions/619f81d5263f?raw)