Schedule
Create timeslot
3 min
{ "tab" "examples", "url" "https //api brella io/api/integration/organizations/{organizationid}/events/{eventid}/timeslots/import", "name" "create new timeslot", "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 {\n \\"id\\" \\"107877\\",\n \\"type\\" \\"timeslot\\",\n \\"attributes\\" {\n \\"title\\" \\"title of your session\\",\n \\"reservable\\" \\"false\\",\n \\"duration\\" \\"90\\",\n \\"location\\" \\"main hall and venue\\",\n \\"content\\" {\n \\"blocks\\" \[\n {\n \\"text\\" \\"you can write \\",\n \\"type\\" \\"unstyled\\",\n \\"depth\\" \\"0\\",\n \\"entity ranges\\" \[],\n \\"inline style ranges\\" \[]\n },\n {\n \\"text\\" \\"html\\",\n \\"type\\" \\"unstyled\\",\n \\"depth\\" \\"0\\",\n \\"entity ranges\\" \[],\n \\"inline style ranges\\" \[]\n },\n {\n \\"text\\" \\" or just have a string anything here will be converted to draftjs consumable object\\",\n \\"type\\" \\"unstyled\\",\n \\"depth\\" \\"0\\",\n \\"entity ranges\\" \[],\n \\"inline style ranges\\" \[]\n }\n ],\n \\"entity map\\" {}\n },\n \\"subtitle\\" \\"\\",\n \\"highlight position\\" {},\n \\"stream link\\" {},\n \\"chat channel id\\" \\"timeslot 107877\\",\n \\"start time\\" \\"2025 11 27t00 30 00 000z\\",\n \\"end time\\" \\"2025 11 27t02 00 00 000z\\",\n \\"tag order\\" \[\n \\"74339\\",\n \\"74340\\",\n \\"74341\\",\n \\"74342\\",\n \\"74583\\"\n ]\n },\n \\"relationships\\" {\n \\"tags\\" {\n \\"data\\" \[\n {\n \\"id\\" \\"74339\\",\n \\"type\\" \\"tag\\"\n },\n {\n \\"id\\" \\"74340\\",\n \\"type\\" \\"tag\\"\n },\n {\n \\"id\\" \\"74341\\",\n \\"type\\" \\"tag\\"\n },\n {\n \\"id\\" \\"74342\\",\n \\"type\\" \\"tag\\"\n },\n {\n \\"id\\" \\"74583\\",\n \\"type\\" \\"tag\\"\n }\n ]\n },\n \\"locations\\" {\n \\"data\\" \[\n {\n \\"id\\" \\"74343\\",\n \\"type\\" \\"tag\\"\n }\n ]\n },\n \\"speaker assignments\\" {\n \\"data\\" \[]\n },\n \\"speakers\\" {\n \\"data\\" \[]\n },\n \\"tabs\\" {\n \\"data\\" \[]\n },\n \\"attendee groups\\" {\n \\"data\\" \[]\n },\n \\"event\\" {\n \\"data\\" {\n \\"id\\" \\"197444\\",\n \\"type\\" \\"event\\"\n }\n },\n \\"track\\" {\n \\"data\\" {\n \\"id\\" \\"49128\\",\n \\"type\\" \\"track\\"\n }\n }\n }\n }\n ],\n \\"included\\" \[\n {\n \\"id\\" \\"49128\\",\n \\"type\\" \\"track\\",\n \\"attributes\\" {\n \\"name\\" \\"track x\\",\n \\"description\\" null,\n \\"position\\" 3,\n \\"enabled\\" true,\n \\"default\\" false,\n \\"togglable\\" true,\n \\"color\\" \\"#0080c0\\",\n \\"show highlighted speakers\\" false,\n \\"track type\\" \\"contenttrack\\"\n }\n },\n {\n \\"id\\" \\"74339\\",\n \\"type\\" \\"tag\\",\n \\"attributes\\" {\n \\"name\\" \\"track 1\\",\n \\"color\\" \\"#58d78e\\",\n \\"updated at\\" \\"2023 03 24t10 06 02 026z\\",\n \\"created at\\" \\"2023 03 24t10 06 02 026z\\"\n },\n \\"relationships\\" {\n \\"event\\" {\n \\"data\\" {\n \\"id\\" \\"197444\\",\n \\"type\\" \\"event\\"\n }\n }\n }\n },\n {\n \\"id\\" \\"74340\\",\n \\"type\\" \\"tag\\",\n \\"attributes\\" {\n \\"name\\" \\"keynote 1\\",\n \\"color\\" \\"#58d78e\\",\n \\"updated at\\" \\"2023 03 24t10 06 02 038z\\",\n \\"created at\\" \\"2023 03 24t10 06 02 038z\\"\n },\n \\"relationships\\" {\n \\"event\\" {\n \\"data\\" {\n \\"id\\" \\"197444\\",\n \\"type\\" \\"event\\"\n }\n }\n }\n },\n {\n \\"id\\" \\"74341\\",\n \\"type\\" \\"tag\\",\n \\"attributes\\" {\n \\"name\\" \\"ux\\",\n \\"color\\" \\"#58d78e\\",\n \\"updated at\\" \\"2023 03 24t10 06 02 048z\\",\n \\"created at\\" \\"2023 03 24t10 06 02 048z\\"\n },\n \\"relationships\\" {\n \\"event\\" {\n \\"data\\" {\n \\"id\\" \\"197444\\",\n \\"type\\" \\"event\\"\n }\n }\n }\n },\n {\n \\"id\\" \\"74342\\",\n \\"type\\" \\"tag\\",\n \\"attributes\\" {\n \\"name\\" \\"ai\\",\n \\"color\\" \\"#58d78e\\",\n \\"updated at\\" \\"2023 03 24t10 06 02 057z\\",\n \\"created at\\" \\"2023 03 24t10 06 02 057z\\"\n },\n \\"relationships\\" {\n \\"event\\" {\n \\"data\\" {\n \\"id\\" \\"197444\\",\n \\"type\\" \\"event\\"\n }\n }\n }\n },\n {\n \\"id\\" \\"74583\\",\n \\"type\\" \\"tag\\",\n \\"attributes\\" {\n \\"name\\" \\"a test tag\\",\n \\"color\\" \\"#58d78e\\",\n \\"updated at\\" \\"2023 03 27t08 45 11 105z\\",\n \\"created at\\" \\"2023 03 27t08 45 11 105z\\"\n },\n \\"relationships\\" {\n \\"event\\" {\n \\"data\\" {\n \\"id\\" \\"197444\\",\n \\"type\\" \\"event\\"\n }\n }\n }\n },\n {\n \\"id\\" \\"74343\\",\n \\"type\\" \\"tag\\",\n \\"attributes\\" {\n \\"name\\" \\"main hall and venue\\",\n \\"color\\" \\"#58d78e\\",\n \\"updated at\\" \\"2023 03 24t10 06 02 065z\\",\n \\"created at\\" \\"2023 03 24t10 06 02 065z\\"\n },\n \\"relationships\\" {\n \\"event\\" {\n \\"data\\" {\n \\"id\\" \\"197444\\",\n \\"type\\" \\"event\\"\n }\n }\n }\n }\n ],\n \\"meta\\" {\n \\"failures\\" \[]\n }\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}/timeslots/import' \\\\\n header 'brella api access token string' \\\\\n header 'accept application/vnd brella v4+json' \\\\\n header 'content type application/json'\\\\\n data '{ \n \\"timeslots\\" \[{ \n \\"title\\" \\"{{session title}}\\", \n \\"start time\\" \\"{{yyyy mm ddthh\ mm\ ssz}}\\", \n \\"end time\\" \\"{{yyyy mm ddthh\ mm\ ssz}}\\", \n \\"content\\" \\"{{you can write \<p>html\</p> or just have a string anything here will be converted to draftjs consumable object}}\\",\n \\"track\\" \\"{{trackname}}\\", \n \\"location\\" \\"{{main hall and venue}}\\",\n \\"tags\\" \[\\"tag 01\\", \\"tag 02\\", \\"tag 03\\", \\"tag 04\\", \\"tag 05\\"],\n \\"external id\\" \\"{{someexternalid}}\\",\n \\"uses rsvp\\" true,\n \\"uses attendee list\\"\ true,\n \\"uses ticket qr code\\" true,\n \\"attendance registration open\\" true,\n \\"attendance cap\\" 123,\n \\"attendee group ids\\" \[21782,21988] \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 timeslot in an event", "currentnewparameter" { "label" "body parameter", "value" "bodydataparameters" } } request body { "timeslots" \[{ "title" "{{session title}}", "start time" "{{yyyy mm ddthh\ mm\ ssz}}", "end time" "{{yyyy mm ddthh\ mm\ ssz}}", "content" "{{you can write \<p>html\</p> or just have a string anything here will be converted to draftjs consumable object}}", "track" "{{trackname}}", "location" "{{main hall and venue}}", "tags" \["tag 01", "tag 02", "tag 03", "tag 04", "tag 05"], "external id" "d00byd11 01" }] } required attributes title string / the title of the session happening in this timeslot start time datetime / the start date and time; see notes for more information on formatting end time datetime / the start date and time; see notes for more information on formatting external id string / see notes for more information tags list / if not used, an empty list \[] must be sent notes 01 start time and end time must be specified in the following format yyyy mm ddthh\ mm\ ssz eg 2029 06 10t14 30 00+0200 the timezone of the event must be specified accurately, as the api will pass data in utc time in the example above +0200 refers to helsinki time make sure that the date and time are within the event dates specified in brella (if your event dates aren't correctly set up in brella, first do so via the admin panel (event > details) you may need to do some formatting within your integration before passing this data to brella 02 track is not technically required, but is highly recommended when passing timeslots via the api — especially if multiple sessions take place simultaneously a single track cannot have overlapping sessions — the endpoint will return an error if this is the case if the track attribute is empty / not passed, brella will automatically assign the timeslot being created by the request to the default track the tracks can be existing schedule tracks (created in the admin panel), or tracks that do not exist if the value passed in the track attribute doesn't match an existing track's name, brella will create a new track named with the value of the track attribute in the request and assign the timeslot there 03 external id is not technically required, but is highly recommended when passing timeslots via the api this value is used to update timeslots, and to find specific timeslots via the api typically, it would contain a shared value between the 3rd party system the data is coming from and brella (eg you could pass the unique identifier generated by the 3rd party system to the external id attribute in brella 04 uses rsvp , uses attendee list uses ticket qr code , attendance registration open and attendance cap allow you to control whether a session can be reserved /rsvpd in brella uses rsvp (boolean/ true or false) turns the feature on at the highest level also required in order to allow our rsvp endpoints to be used with this timeslot this alone will not allow attendees to register for the timeslot in the app uses attendee list (boolean/ true or false) show a list of all attendees within the app who have rsvpd for a particular session uses ticket qr code (boolean/ true or false) show the attendee's code in the session page of the app attendance registration open (boolean/ true or false) allow attendees to actually register for the ression via the app this can be turned off at any time, after which attendees can remove their rsvps, but not register for new sessions attendance cap (integer) limit how many attendees can register for a particular session 05 attendee group ids (array containing integers) if you have existing user groups in brella, you can allow only specific user groups to see / access this session send the group ids of the user groups that should be able to see this timeslot into this array