Speakers

Create and update speakers with complete curl request examples.

Collection path: events/{event_id}/speakers

Input	Type	POST	PATCH	Notes
`external_id`	Scalar string or `null`	Optional	Optional	External identifier.
`honorific`	Scalar string or `null`	Optional	Optional	Honorific.
`first_name`	Scalar string	Required by the model	Optional	Speaker first name.
`middle_name`	Scalar string or `null`	Optional	Optional	Middle name.
`last_name`	Scalar string or `null`	Optional	Optional	Last name.
`job_title`	Scalar string or `null`	Optional	Optional	Job title.
`company_name`	Scalar string or `null`	Optional	Optional	Company name.
`bio`	Raw JSON or string	Optional	Optional	DraftJS JSON or HTML/text. Sanitized and stored as DraftJS content.
`highlight_position`	Scalar number or `null`	Optional	Optional	Featured order.
`position`	Scalar number or `null`	Optional	Optional	Display order.
`custom_fields_attributes`	Raw array	Optional	Optional	Entries use `key` plus `value` or `values`.
`photo`	Raw string	Optional	Optional	HTTP(S) URL or base64 data URI. Blank on PATCH removes the current photo.

Speaker assignments are not writable through this resource; manage them through the content-session speaker_assignments input.

POST a speaker

curl --request POST \
  --url "${BRELLA_API_BASE_URL}/api/core/organizations/${BRELLA_ORGANIZATION_ID}/events/${BRELLA_EVENT_ID}/speakers" \
  --header "Accept: application/vnd.brella.v4+json" \
  --header "Brella-API-Access-Token: ${BRELLA_API_ACCESS_TOKEN}" \
  --header "Content-Type: application/json" \
  --data-raw '{
    "external_id": "SPEAKER-42",
    "honorific": "Dr",
    "first_name": "Taylor",
    "last_name": "Ng",
    "job_title": "CEO",
    "company_name": "Example Ltd",
    "bio": "Taylor leads Example Ltd.",
    "highlight_position": 1,
    "position": 10,
    "custom_fields_attributes": [
      { "key": "linkedin_url", "value": "https://www.linkedin.com/in/example" }
    ],
    "photo": "https://example.com/taylor.jpg"
  }'

The response type is speaker. Useful write-response fields include external_id, first_name, last_name, job_title, company_name, photo_url, and updated_at.

PATCH a speaker

curl --request PATCH \
  --url "${BRELLA_API_BASE_URL}/api/core/organizations/${BRELLA_ORGANIZATION_ID}/events/${BRELLA_EVENT_ID}/speakers/801" \
  --header "Accept: application/vnd.brella.v4+json" \
  --header "Brella-API-Access-Token: ${BRELLA_API_ACCESS_TOKEN}" \
  --header "Content-Type: application/json" \
  --data-raw '{
    "job_title": "Founder and CEO",
    "bio": "Taylor founded and leads Example Ltd.",
    "highlight_position": 2
  }'