---
title: "POST /v1/livequestions/{section_uuid}/{content_container_uuid}/hosts"
method: POST
path: "/v1/livequestions/{section_uuid}/{content_container_uuid}/hosts"
tags: ["QuestionHost"]
---

# POST /v1/livequestions/{section_uuid}/{content_container_uuid}/hosts

`POST /v1/livequestions/{section_uuid}/{content_container_uuid}/hosts`

## Request

- Base URL: `https://livequestions.viafoura.co`
- URL: `https://livequestions.viafoura.co/v1/livequestions/{section_uuid}/{content_container_uuid}/hosts`
- Auth: one of:
  - HTTP basic
  - API key in header `X-REQUEST_SIGNATURE`

Add a host to the container

## Path parameters

- `section_uuid` string, uuid, required
- `content_container_uuid` string, uuid, required

## Request body

- HostCreate
  - `user_uuid` string, uuid, required
  - `badge` Badge
    - `badge_text` string, nullable
    - `badge_color` string, nullable
  - `display_name` string, nullable: Optional event-specific display name override for this host.
  - `cta_url` string, nullable: Event-page URL for the host-added email CTA. Mandatory when is_guest is true. Capped to match auth-service's destination_url limit (COM-1523) so an oversized value fails fast with a 400 here, rather than downstream at the magic-link mint call.
  - `is_guest` boolean: True when the front-end just created a new account for this user via auth-service. When true, display_name and cta_url are mandatory, and badge_text defaults to "Host" when no badge is supplied.

## Response `201`

Created

- Host
  - `user_uuid` string, uuid, required
  - `badge` Badge
    - `badge_text` string, nullable
    - `badge_color` string, nullable
  - `display_name` string, nullable: Event-specific display name override for this host. Applies only to this Live Q&A container; does not affect the user's account profile name. Null means no override (clients fall back to the account name).
  - `avatar` Avatar
    - `avatar_uuid` string, uuid
    - `image_url` string, uri, nullable
  - `is_guest` boolean: Staff-facing only. True when this host was added via the new-account guest-invite flow (is_guest=true on HostCreate).
  - `date_created` integer, nullable
  - `date_modified` integer, nullable

## Other responses

- `400`: BadRequest
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `409`: Conflict

---

[API](https://skmtc.dev/viafoura/apis/questions-answers-api.md) - [All operations](https://skmtc.dev/viafoura/apis/questions-answers-api/llms.txt) - [OpenAPI document](https://skmtc.dev/viafoura/apis/questions-answers-api/revisions/662022ce1517?raw)