---
title: "Create a new speaker"
method: POST
path: "/v1/events/{eventId}/speakers"
tags: ["Speakers"]
---

# Create a new speaker

`POST /v1/events/{eventId}/speakers`

## Request

- The document declares no server URL.
- Auth: none required
- TypeScript: <https://skmtc.dev/zuddl/apis/zuddl-webhook-documentation/docs/v1/events/:eventId/speakers/post.ts> (a function with typed inputs; its response is checked against the schema)

Use this endpoint to create a new speaker for a specific event type in your Zuddl organization.

Required API key scopes: `WRITE`

**This API can only be called with an access key that was generated for Backend usage.**

## Path parameters

- `eventId` string, required

## Request body

- OrgEventsAppDomainApiProductEventSpeakerDtosSpeakerCreateRequest
  - `firstName` string, required: First name of the speaker
  - `lastName` string, required: Last name of the speaker
  - `company` string: Company of the speaker
  - `designation` string: Designation of the speaker
  - `bio` string: Bio of the speaker. May contain rich-text HTML markup (e.g. bold, italic, lists, links). Plain text is also accepted and stored as-is. Disallowed content (script/iframe tags, javascript: URLs, inline event handlers) is rejected.
  - `linkedInProfile` string: LinkedIn profile URL of the speaker
  - `twitterProfile` string: Twitter profile URL of the speaker
  - `facebookProfile` string: Facebook profile URL of the speaker
  - `websiteUrl` string: Personal website URL of the speaker
  - `externalRefId` string: A reference ID that you can use to map this speaker to your external systems or databases
  - `email` string, required: Email of the speaker

## Response `200`

Speaker created successfully

- OrgEventsAppDomainApiProductEventSpeakerDtosSpeakerDetails
  - `kind` string
  - `url` string, uri
  - `id` string, uuid: Unique identifier of the speaker
  - `speakerOrder` integer: Order of appearance for this speaker
  - `profile` OrgEventsAppDomainApiProductEventSpeakerDtosSpeakerDetailsProfile: Speaker profile information
    - `firstName` string
    - `lastName` string
    - `bio` string: Bio of the speaker. May contain rich-text HTML markup (e.g. bold, italic, lists, links). Legacy speakers may still return plain text.
    - `company` string
    - `designation` string
    - `headline` string
    - `picUrl` string: Profile picture URL
  - `socialLinks` OrgEventsAppDomainApiProductEventSpeakerDtosSpeakerDetailsSocialLinks: Speaker's social and website links
    - `linkedInProfile` string
    - `twitterProfile` string
    - `facebookProfile` string
    - `websiteUrl` string
  - `sessions` OrgEventsAppDomainApiProductEventSpeakerDtosSpeakerDetailsSessionRef[]: Sessions where this speaker appears
    - `sessionId` string: Unique identifier of the session
    - `url` string, uri: API URL to retrieve session details
  - `externalRefId` string: A reference ID that you can use to map this speaker to your external systems or databases

## Other responses

- `400`: Invalid event ID supplied
- `401`: Unauthorized access to event
- `404`: Event not found

---

[API](https://skmtc.dev/zuddl/apis/zuddl-webhook-documentation.md) - [All operations](https://skmtc.dev/zuddl/apis/zuddl-webhook-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/zuddl/apis/zuddl-webhook-documentation/revisions/571c1d41e62a?raw)