Speakers
Update speaker

2min
Update an existing speaker in an event
PATCH
Request
Path Params
{organizationId}
required
Number
The id of the Brella organization you are trying to retrieve data from
{eventId}
required
Number
The id of the Brella event you are trying to retrieve data from
{speakerId}
required
Number
The id of the speaker you are trying to update
Header Parameters
Brella-API-Access-Token
required
String
Your unique Brella API key
Accept
required
String
application/vnd.brella.v4+json
Content-Type
required
String
application/json
Curl
curl --location -g --request PATCH 'https://api.brella.io/api/integration/organizations/{organizationId}/events/{eventId}/speakers/{speakerId}' \
--header 'Accept: application/json' \
--header 'Brella-API-Access-Token: String' \
--header 'Accept: string' \
--header 'Content-Type: string'
--data '{
    "speaker": {
         "first_name": "{{speaker_first_name}}",    
         "last_name": "{{speaker_last_name}}",    
         "middle_name": "{{speaker_middle_name}}",    
         "job_title": "{{job_title}}",    
         "honorific": "{{honorific}}",    
         "company_name": "{{company_name}}",    
         "photo": "{{speaker_photo_url}}",    
         "highlight_position": {{speaker_highlight_position}},    
         "bio": "{{bio_rich_text_supported}}",
         "position":{{number}},
         "external_id":{{external_id}}
  }
}'
curl --location -g --request PATCH 'https://api.brella.io/api/integration/organizations/{organizationId}/events/{eventId}/speakers/{speakerId}' \
--header 'Accept: application/json' \
--header 'Brella-API-Access-Token: String' \
--header 'Accept: string' \
--header 'Content-Type: string'
--data '{
    "speaker": {
         "first_name": "{{speaker_first_name}}",    
         "last_name": "{{speaker_last_name}}",    
         "middle_name": "{{speaker_middle_name}}",    
         "job_title": "{{job_title}}",    
         "honorific": "{{honorific}}",    
         "company_name": "{{company_name}}",    
         "photo": "{{speaker_photo_url}}",    
         "highlight_position": {{speaker_highlight_position}},    
         "bio": "{{bio_rich_text_supported}}",
         "position":{{number}},
         "external_id":{{external_id}}
  }
}'
Responses
200
{
    "data": {
        "id": "126830",
        "type": "speaker",
        "attributes": {
            "honorific": "Dr",
            "first-name": "Jonathan",
            "middle-name": "Masters",
            "last-name": "Smithsonian",
            "job-title": "Chief Technology Officer",
            "company-name": "Brella Co.,",
            "photo-url": null,
            "bio": {
                "blocks": [
                    {
                        "text": "This is our bio <div>and it supports rich-text</div>",
                        "type": "unstyled",
                        "entity_ranges": []
                    }
                ]
            },
            "highlight-position": 1,
            "external-id": "ba019290",
            "position": 1
        },
        "relationships": {
            "speaker-assignments": {
                "data": []
            }
        }
    },
    "included": []
}
{
    "data": {
        "id": "126830",
        "type": "speaker",
        "attributes": {
            "honorific": "Dr",
            "first-name": "Jonathan",
            "middle-name": "Masters",
            "last-name": "Smithsonian",
            "job-title": "Chief Technology Officer",
            "company-name": "Brella Co.,",
            "photo-url": null,
            "bio": {
                "blocks": [
                    {
                        "text": "This is our bio <div>and it supports rich-text</div>",
                        "type": "unstyled",
                        "entity_ranges": []
                    }
                ]
            },
            "highlight-position": 1,
            "external-id": "ba019290",
            "position": 1
        },
        "relationships": {
            "speaker-assignments": {
                "data": []
            }
        }
    },
    "included": []
}
﻿
REQUEST BODY
{
  "speaker": {
     "first_name": "{{speaker_first_name}}",    
     "last_name": "{{speaker_last_name}}",    
     "middle_name": "{{speaker_middle_name}}",    
     "job_title": "{{job_title}}",    
     "honorific": "{{honorific}}",    
     "company_name": "{{company_name}}",    
     "photo": "{{speaker_photo_url}}",    
     "highlight_position": {{speaker_highlight_position}},    
     "bio": "{{bio_rich_text_supported}}",
     "position":{{number}}
 }
}
Required attributes:
first_name String / typically the speaker's first name
last_name String / typically the speaker's last name
Notes:
01: This endpoint creates speaker profiles. Speaker profiles can only be edited via the Admin Panel or API, and are only used in the schedule, speakers tab and speaker widget. If you want your speakers to join the event and network with other attendees or have access to Brella features, please add them as "invites" using the /invites endpoint. If you wish to give them special privileges, you can create a special "speakers" user group in the Admin Panel, and assign all invites created for speakers there. 
02: The photo attribute allows for automatic uploading sponsor head-shot / profile picture from web-based sources. To use this, pass a URL leading to a valid image resource (JPG / JPEG / PNG etc.) as a string.
03: highlight_position determines the order in which your speakers are displayed in Brella. If left empty, they will not be highlighted.
04: bio supports rich text. Pass either formatted or unformatted rich text snippets within a string.
Updated 05 Aug 2024
Did this page help you?
Create speaker
Delete speaker