Sign in

v1

latestOpenAPI 3.1.02026-07-22285495.1 KB
Speakers

Create a new speaker

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.

post/v1/events/{eventId}/speakers

Path parameters

eventIdstring required

Unique identifier of the event

Request body

firstNamestring required

First name of the speaker

lastNamestring required

Last name of the speaker

companystring

Company of the speaker

designationstring

Designation of the speaker

biostring

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.

linkedInProfilestring

LinkedIn profile URL of the speaker

twitterProfilestring

Twitter profile URL of the speaker

facebookProfilestring

Facebook profile URL of the speaker

websiteUrlstring

Personal website URL of the speaker

externalRefIdstring

A reference ID that you can use to map this speaker to your external systems or databases

emailstring required

Email of the speaker

Example request

{
  "firstName": "John",
  "lastName": "Doe",
  "company": "Tech Innovations Inc.",
  "designation": "Chief Technology Officer",
  "bio": "<p>John is a <strong>renowned expert</strong> in his field...</p>",
  "linkedInProfile": "https://www.linkedin.com/in/johndoe",
  "twitterProfile": "https://twitter.com/johndoe",
  "facebookProfile": "https://www.facebook.com/johndoe",
  "websiteUrl": "https://johndoe.com",
  "externalRefId": "d812a64f8865428990249a120792c3d8",
  "email": "john.doe@example.com"
}

Response

Speaker created successfully

kindstring
urlstring uri
idstring uuid

Unique identifier of the speaker

speakerOrderinteger

Order of appearance for this speaker

externalRefIdstring

A reference ID that you can use to map this speaker to your external systems or databases

Example response

{
  "id": "4fcebf73-3ddb-4fe6-b56d-5dd7dedb7c3d",
  "profile": {
    "firstName": "Alice",
    "lastName": "Smith",
    "bio": "<p>Alice is a <strong>renowned expert</strong>...</p>",
    "company": "Tech Innovators Inc.",
    "designation": "Chief Technology Officer",
    "headline": "Visionary Leader in Tech",
    "picUrl": "https://example.com/speakers/alice.jpg"
  },
  "socialLinks": {
    "linkedInProfile": "https://linkedin.com/in/alicesmith",
    "twitterProfile": "https://twitter.com/alicesmith",
    "facebookProfile": "https://facebook.com/alicesmith",
    "websiteUrl": "https://alicesmith.com"
  },
  "sessions": [
    {
      "sessionId": "4fcebf73-3ddb-4fe6-b56d-5dd7dedb7c4f",
      "url": "/api/v1/events/evt-abc123xyz/sessions/seg-123432"
    }
  ],
  "externalRefId": "d812a64f8865428990249a120792c3d8"
}