Speakers
Create speaker

2min
Create a new sponsor in an event
POST
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
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 POST 'https://api.brella.io/api/integration/organizations/{organizationId}/events/{eventId}/speakers/' \
--header 'Brella-API-Access-Token: String' \
--header 'Accept: application/vnd.brella.v4+json' \
--header 'Content-Type: application/json'\
--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 POST 'https://api.brella.io/api/integration/organizations/{organizationId}/events/{eventId}/speakers/' \
--header 'Brella-API-Access-Token: String' \
--header 'Accept: application/vnd.brella.v4+json' \
--header 'Content-Type: application/json'\
--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": "John",
            "middle-name": "Masters",
            "last-name": "Smithsonian",
            "job-title": "CTO",
            "company-name": "Brella Co.,",
            "photo-url": "https://brella-test.brella.io/uploads/speaker/pics/93568/48bobaz9894.jpg",
            "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": "John",
            "middle-name": "Masters",
            "last-name": "Smithsonian",
            "job-title": "CTO",
            "company-name": "Brella Co.,",
            "photo-url": "https://brella-test.brella.io/uploads/speaker/pics/93568/48bobaz9894.jpg",
            "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: position attribute determines the order in which your speakers are displayed in Brella's speaker page (on the web app, iOS / Android natives and speaker widget). The position attribute is optional, and does not need to have a unique number. If left empty (or if multiple speakers have the same position), Brella will display those speakers by alphabetical first name (and if the first name is the same for multiple speakers, they will be ordered by last name). 
04: highlight_position determines the order in which your speakers are displayed in Brella's featured speakers' section (on the iOS / Android app homepages and the speaker widget). If left empty, they will not be highlighted. This attribute is independent of the position attribute.
05: bio supports rich text. Pass either formatted or unformatted rich text snippets within a string.
Updated 05 Aug 2024
Did this page help you?
Find speaker by external id
Update speaker