Speakers
Create speaker
2 min
{ "tab" "examples", "url" "https //api brella io/api/integration/organizations/{organizationid}/events/{eventid}/speakers/", "name" "create new speaker", "method" "post", "request" { "pathparameters" \[ { "kind" "required", "name" "{organizationid}", "type" "number", "children" \[], "description" "the id of the brella organization you are trying to retrieve data from" }, { "kind" "required", "name" "{eventid}", "type" "number", "children" \[], "description" "the id of the brella event you are trying to retrieve data from" } ], "queryparameters" \[], "headerparameters" \[ { "kind" "required", "name" "brella api access token", "type" "string", "children" \[], "description" "your unique brella api key" }, { "kind" "required", "name" "accept", "type" "string", "children" \[], "description" "application/vnd brella v4+json" }, { "kind" "required", "name" "content type", "type" "string", "children" \[], "description" "application/json" } ], "bodydataparameters" \[], "formdataparameters" \[] }, "results" { "languages" \[ { "id" "psobomoj9uo00ibrqhmgp", "code" "{\n \\"data\\" {\n \\"id\\" \\"126830\\",\n \\"type\\" \\"speaker\\",\n \\"attributes\\" {\n \\"honorific\\" \\"dr\\",\n \\"first name\\" \\"john\\",\n \\"middle name\\" \\"masters\\",\n \\"last name\\" \\"smithsonian\\",\n \\"job title\\" \\"cto\\",\n \\"company name\\" \\"brella co ,\\",\n \\"photo url\\" \\"https //brella test brella io/uploads/speaker/pics/93568/48bobaz9894 jpg\\",\n \\"bio\\" {\n \\"blocks\\" \[\n {\n \\"text\\" \\"this is our bio \<div>and it supports rich text\</div>\\",\n \\"type\\" \\"unstyled\\",\n \\"entity ranges\\" \[]\n }\n ]\n },\n \\"highlight position\\" 1,\n \\"external id\\" \\"ba019290\\",\n \\"position\\" 1\n },\n \\"relationships\\" {\n \\"speaker assignments\\" {\n \\"data\\" \[]\n }\n }\n },\n \\"included\\" \[]\n}", "language" "200", "customlabel" "" } ], "selectedlanguageid" "psobomoj9uo00ibrqhmgp" }, "examples" { "languages" \[ { "id" "crajpoumtvuqzjful oz", "code" "curl location g request post 'https //api brella io/api/integration/organizations/{organizationid}/events/{eventid}/speakers/' \\\\\n header 'brella api access token string' \\\\\n header 'accept application/vnd brella v4+json' \\\\\n header 'content type application/json'\\\\\n data '{\n \\"speaker\\" {\n \\"first name\\" \\"{{speaker first name}}\\", \n \\"last name\\" \\"{{speaker last name}}\\", \n \\"middle name\\" \\"{{speaker middle name}}\\", \n \\"job title\\" \\"{{job title}}\\", \n \\"honorific\\" \\"{{honorific}}\\", \n \\"company name\\" \\"{{company name}}\\", \n \\"photo\\" \\"{{speaker photo url}}\\", \n \\"highlight position\\" {{speaker highlight position}}, \n \\"bio\\" \\"{{bio rich text supported}}\\",\n \\"position\\" {{number}},\n \\"external id\\" {{external id}}\n }\n}'\n\n\n\n\n\n\n\n\n\n\n\n\n\n'", "language" "curl", "customlabel" "" } ], "selectedlanguageid" "crajpoumtvuqzjful oz" }, "description" "create a new sponsor in an event", "currentnewparameter" { "label" "body parameter", "value" "bodydataparameters" } } 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