{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"EMS Developers","description":"Connect your systems to EMS with the public API.","colors":{"primary":"#C83A1E","light":"#E35D43","dark":"#C83A1E"},"logo":{"light":"/logo/light.svg","dark":"/logo/dark.svg","href":"https://ems.aventia.africa"},"favicon":"/favicon.svg","api":{"openapi":"api-reference/openapi.json","playground":{"display":"simple"},"examples":{"languages":["curl","javascript","python","php","go"]}},"background":{"color":{"light":"#F7F1E8","dark":"#251B2F"}},"navbar":{"primary":{"type":"button","label":"Get API keys","href":"https://ems.aventia.africa/settings/api-keys"}},"footer":{"socials":{"website":"https://ems.aventia.africa"}},"fonts":{"heading":{"family":"Noto Serif","weight":700},"body":{"family":"Noto Sans"}},"integrations":{"telemetry":{"enabled":false}},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"hasAudioNarration":false,"customDomains":[],"gitSource":{"type":"github","owner":"local","repo":"local","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":"local","isBase":true},"buildId":"local","clientVersion":"0.0.4071"},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[],"googleFontsInlined":false,"isLoggedInCli":false,"mintExport":{}},"customCss":[],"page":{"pagePath":"api-reference/speakers/create","slug":"/api-reference/speakers/create","pageMetadata":{"title":"Create a speaker","description":"Add a speaker to an event. Needs speakers:write.","openapi":"api-reference/openapi.json POST /api/public/v1/events/{eventID}/speakers","href":"/api-reference/speakers/create"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Add a speaker to an event. Needs speakers:write.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Create a speaker","description":"Add a speaker to an event. Needs speakers:write.","openapi":"api-reference/openapi.json POST /api/public/v1/events/{eventID}/speakers","href":"/api-reference/speakers/create"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["public-api"],"summary":"Create a speaker","parameters":["e42fc861-4fb8-483b-a87c-ab2ab3e81b22"],"requestBody":"c3ab961b-99e2-4a96-b424-9550c159a71a","responses":{"201":"3eaf08d6-e0cd-44c3-8e1d-7f1575c02a64","401":"756ae6f1-7b32-47ff-8d0b-76d0da891fc4","403":"c7380227-8835-457d-9415-753944650eb6","404":"d91f6268-bb35-4b9b-a31a-74717170e90d","422":"d674eebc-447b-429b-9363-c081c49b19c5"},"security":["9a210dd1-2b85-4b94-85dc-cf53d4ec8ea6"],"method":"post","type":"path","servers":["4c37dfd0-ea43-43db-8369-349b968dc154"],"path":"/api/public/v1/events/{eventID}/speakers","baseUrlOptions":["https://ems-api.aventia.africa"],"title":"Create a speaker","description":"Add a speaker to an event. Needs speakers:write.","codeSamples":[],"requestExampleLanguages":["bash","javascript","python","php","go"],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"e42fc861-4fb8-483b-a87c-ab2ab3e81b22":{"description":"Event ID","name":"eventID","in":"path","required":true,"schema":{"type":"string","isRequired":true,"description":"Event ID","uniqueKey":"","typeLabel":"string"}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"address":{"type":"string","example":"Nairobi","uniqueKey":"address","typeLabel":"string"},"category_id":{"type":"string","example":"","uniqueKey":"category_id","typeLabel":"string"},"company":{"type":"string","example":"PSSF","uniqueKey":"company","typeLabel":"string"},"country":{"type":"string","example":"KE","uniqueKey":"country","typeLabel":"string"},"description":{"type":"string","example":"\u003cp>Pensions leader.\u003c/p>","uniqueKey":"description","typeLabel":"string"},"designation":{"type":"string","example":"Chief Executive Officer","uniqueKey":"designation","typeLabel":"string"},"email":{"type":"string","example":"jonah@example.co.ke","uniqueKey":"email","typeLabel":"string"},"first_name":{"type":"string","example":"Jonah","uniqueKey":"first_name","typeLabel":"string"},"last_name":{"type":"string","example":"Aiyabei","uniqueKey":"last_name","typeLabel":"string"},"phone":{"type":"object","properties":{"code":{"type":"string","example":"+254","uniqueKey":"phone.code","typeLabel":"string"},"number":{"type":"string","example":"712345678","uniqueKey":"phone.number","typeLabel":"string"}},"uniqueKey":"phone","typeLabel":"object"},"phone_alt":{"type":"object","properties":{"code":{"type":"string","example":"+254","uniqueKey":"phone_alt.code","typeLabel":"string"},"number":{"type":"string","example":"712345678","uniqueKey":"phone_alt.number","typeLabel":"string"}},"uniqueKey":"phone_alt","typeLabel":"object"},"photo_media_id":{"type":"string","example":"","uniqueKey":"photo_media_id","typeLabel":"string"},"skills":{"type":"array","items":{"type":"string","uniqueKey":"skills.items.[INDEX]","typeLabel":"string"},"uniqueKey":"skills","typeLabel":"string[]"},"social_links":{"type":"object","additionalProperties":{"type":"string","uniqueKey":"social_links.additionalProperties","typeLabel":"string"},"uniqueKey":"social_links","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"address":"Nairobi","category_id":"","company":"PSSF","country":"KE","description":"\u003cp>Pensions leader.\u003c/p>","designation":"Chief Executive Officer","email":"jonah@example.co.ke","first_name":"Jonah","last_name":"Aiyabei","phone":{"code":"+254","number":"712345678"},"phone_alt":{"code":"+254","number":"712345678"},"photo_media_id":"","skills":["\u003cstring>"],"social_links":{}}}},"exampleType":"generated"}},"description":"Speaker","required":true,"exampleType":"generated"},"responses":{"3eaf08d6-e0cd-44c3-8e1d-7f1575c02a64":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"address":{"type":"string","uniqueKey":"address","typeLabel":"string"},"category_id":{"type":"string","uniqueKey":"category_id","typeLabel":"string"},"company":{"type":"string","uniqueKey":"company","typeLabel":"string"},"contact_hidden":{"type":"boolean","uniqueKey":"contact_hidden","typeLabel":"boolean"},"country":{"type":"string","uniqueKey":"country","typeLabel":"string"},"description":{"description":"sanitised rich text","type":"string","uniqueKey":"description","typeLabel":"string"},"designation":{"type":"string","uniqueKey":"designation","typeLabel":"string"},"email":{"type":"string","uniqueKey":"email","typeLabel":"string"},"first_name":{"type":"string","uniqueKey":"first_name","typeLabel":"string"},"id":{"type":"string","uniqueKey":"id","typeLabel":"string"},"last_name":{"type":"string","uniqueKey":"last_name","typeLabel":"string"},"phone":{"type":"string","example":"+254712345678","uniqueKey":"phone","typeLabel":"string"},"phone_alt":{"type":"string","uniqueKey":"phone_alt","typeLabel":"string"},"photo":{"type":"object","properties":{"alt_text":{"type":"string","example":"Speaker on stage in front of a full hall","uniqueKey":"photo.alt_text","typeLabel":"string"},"content_type":{"type":"string","example":"image/jpeg","uniqueKey":"photo.content_type","typeLabel":"string"},"created_at":{"type":"string","example":"2026-11-02T09:00:00Z","uniqueKey":"photo.created_at","typeLabel":"string"},"filename":{"type":"string","example":"keynote-stage.jpg","uniqueKey":"photo.filename","typeLabel":"string"},"height":{"type":"integer","example":1080,"uniqueKey":"photo.height","typeLabel":"integer"},"id":{"type":"string","example":"019a4f2c-0000-7000-8000-000000000010","uniqueKey":"photo.id","typeLabel":"string"},"size_bytes":{"type":"integer","example":482113,"uniqueKey":"photo.size_bytes","typeLabel":"integer"},"thumb_url":{"type":"string","example":"http://localhost:9020/ems-media/orgs/.../media/..._thumb.jpg?X-Amz-Signature=...","uniqueKey":"photo.thumb_url","typeLabel":"string"},"title":{"type":"string","example":"Keynote stage","uniqueKey":"photo.title","typeLabel":"string"},"url":{"type":"string","example":"http://localhost:9020/ems-media/orgs/.../media/....jpg?X-Amz-Signature=...","uniqueKey":"photo.url","typeLabel":"string"},"url_expires_at":{"type":"string","example":"2026-11-02T10:00:00Z","uniqueKey":"photo.url_expires_at","typeLabel":"string"},"width":{"type":"integer","example":1920,"uniqueKey":"photo.width","typeLabel":"integer"}},"uniqueKey":"photo","typeLabel":"object"},"skills":{"type":"array","items":{"type":"string","uniqueKey":"skills.items.[INDEX]","typeLabel":"string"},"uniqueKey":"skills","typeLabel":"string[]"},"social_links":{"type":"object","additionalProperties":{"type":"string","uniqueKey":"social_links.additionalProperties","typeLabel":"string"},"uniqueKey":"social_links","typeLabel":"object"},"updated_at":{"type":"string","uniqueKey":"updated_at","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"address":"\u003cstring>","category_id":"\u003cstring>","company":"\u003cstring>","contact_hidden":true,"country":"\u003cstring>","description":"\u003cstring>","designation":"\u003cstring>","email":"\u003cstring>","first_name":"\u003cstring>","id":"\u003cstring>","last_name":"\u003cstring>","phone":"+254712345678","phone_alt":"\u003cstring>","photo":{"alt_text":"Speaker on stage in front of a full hall","content_type":"image/jpeg","created_at":"2026-11-02T09:00:00Z","filename":"keynote-stage.jpg","height":1080,"id":"019a4f2c-0000-7000-8000-000000000010","size_bytes":482113,"thumb_url":"http://localhost:9020/ems-media/orgs/.../media/..._thumb.jpg?X-Amz-Signature=...","title":"Keynote stage","url":"http://localhost:9020/ems-media/orgs/.../media/....jpg?X-Amz-Signature=...","url_expires_at":"2026-11-02T10:00:00Z","width":1920},"skills":["\u003cstring>"],"social_links":{},"updated_at":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"756ae6f1-7b32-47ff-8d0b-76d0da891fc4":{"description":"Invalid or missing API key","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"Not Found","uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"Not Found"}}},"exampleType":"generated"}},"exampleType":"generated"},"c7380227-8835-457d-9415-753944650eb6":{"description":"Key lacks speakers:write, or its creator can't edit this event","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"Not Found","uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"Not Found"}}},"exampleType":"generated"}},"exampleType":"generated"},"d91f6268-bb35-4b9b-a31a-74717170e90d":{"description":"No such event","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"Not Found","uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"Not Found"}}},"exampleType":"generated"}},"exampleType":"generated"},"d674eebc-447b-429b-9363-c081c49b19c5":{"description":"Invalid fields","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"validation failed","uniqueKey":"error","typeLabel":"string"},"fields":{"type":"object","additionalProperties":{"type":"string","uniqueKey":"fields.additionalProperties","typeLabel":"string"},"uniqueKey":"fields","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"validation failed","fields":{}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"9a210dd1-2b85-4b94-85dc-cf53d4ec8ea6":{"PublicAPIKey":{"type":"http","scheme":"basic","description":"Your API key pair from Settings › API keys: public key as the username, secret key as the password.","scopes":[],"schemeName":"PublicAPIKey"}}},"servers":{"4c37dfd0-ea43-43db-8369-349b968dc154":{"url":"https://ems-api.aventia.africa","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"basic","description":"Your API key pair from Settings › API keys: public key as the username, secret key as the password.","scopes":[],"schemeName":"PublicAPIKey"},"schema":{"title":"Basic Auth","type":"object","description":"Your API key pair from Settings › API keys: public key as the username, secret key as the password.","isRequired":true,"properties":{"username":{"type":"string","uniqueKey":"username","isRequired":true,"typeLabel":"string","deprecated":false},"password":{"type":"string","uniqueKey":"password","isRequired":true,"typeLabel":"string","deprecated":false}},"additionalProperties":false,"deprecated":false},"schemeName":"PublicAPIKey","name":"Authorization"}],"title":"PublicAPIKey"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"localhost","siteName":"EMS Developers","title":"Create a speaker - EMS Developers","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"originalFileLocation":"api-reference/speakers/create.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Add a speaker to an event. Needs speakers:write.\">\u003cmeta data-mint-head name=\"application-name\" content=\"EMS Developers\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/favicons/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/favicons/favicon-32x32.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/favicons/favicon-16x16.png\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/favicons/favicon.ico\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create a speaker - EMS Developers\">\u003cmeta data-mint-head property=\"og:description\" content=\"Add a speaker to an event. Needs speakers:write.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"EMS Developers\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://local./api-reference/speakers/create\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Create a speaker - EMS Developers\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Add a speaker to an event. Needs speakers:write.\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/favicons/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"EMS Developers\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#C83A1E\">\u003clink data-mint-head rel=\"canonical\" href=\"https://local./api-reference/speakers/create\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/speakers/create.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"EMS Developers\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"EMS Developers","nav":{"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":""}]},{"tab":"API reference","groups":[{"group":"Account","pages":[{"title":"Who am I","openapi":"api-reference/openapi.json GET /api/public/v1/whoami","href":"/api-reference/whoami"}]},{"group":"Events","pages":[{"title":"List events","openapi":"api-reference/openapi.json GET /api/public/v1/events","href":"/api-reference/events"}]},{"group":"Speakers","pages":[{"title":"List speakers","openapi":"api-reference/openapi.json GET /api/public/v1/events/{eventID}/speakers","href":"/api-reference/speakers/list"},{"title":"Get a speaker","description":"One speaker. Needs speakers:read.","openapi":"api-reference/openapi.json GET /api/public/v1/events/{eventID}/speakers/{speakerID}","href":"/api-reference/speakers/get"},{"title":"Create a speaker","openapi":"api-reference/openapi.json POST /api/public/v1/events/{eventID}/speakers","href":"/api-reference/speakers/create"},{"title":"Update a speaker","description":"Replace a speaker's profile. Needs speakers:write.","openapi":"api-reference/openapi.json PUT /api/public/v1/events/{eventID}/speakers/{speakerID}","href":"/api-reference/speakers/update"},{"title":"Delete a speaker","openapi":"api-reference/openapi.json DELETE /api/public/v1/events/{eventID}/speakers/{speakerID}","href":"/api-reference/speakers/delete"},{"title":"List speaker categories","openapi":"api-reference/openapi.json GET /api/public/v1/events/{eventID}/speaker-categories","href":"/api-reference/speakers/categories"},{"title":"Get speaker settings","openapi":"api-reference/openapi.json GET /api/public/v1/events/{eventID}/speaker-settings","href":"/api-reference/speakers/settings"},{"title":"Update speaker settings","openapi":"api-reference/openapi.json PUT /api/public/v1/events/{eventID}/speaker-settings","href":"/api-reference/speakers/update-settings"}]},{"group":"Photos","pages":[{"title":"Start a photo upload","openapi":"api-reference/openapi.json POST /api/public/v1/media/uploads","href":"/api-reference/media/start-upload"},{"title":"Complete a photo upload","openapi":"api-reference/openapi.json POST /api/public/v1/media/uploads/{uploadID}/complete","href":"/api-reference/media/complete-upload"},{"title":"Get a photo upload's status","openapi":"api-reference/openapi.json GET /api/public/v1/media/uploads/{uploadID}","href":"/api-reference/media/upload-status"}]}]}]},"basePath":"","title":"Create a speaker - EMS Developers","buildId":"660b7fc6c9f5","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-13ABqdTb.js","utils-CVibcMh2.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DSB3Xavk.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-6DE3lqKN.js","snippetPresets-3YmRj7Wd.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-DsaUpav6.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-KXmCtH22.js","shallow-Dq5-SwG1.js","getApiPlaygroundDisplay-BgRo4fbO.js","CodeSnippet-B30EB_zA.js","CodeSnippets-BVYNHQXB.js","Page-BSEQkQjn.js","getPastedJson-DugDon3a.js","icon-HMNWawTa.js","MethodPill-D3jclRQK.js","DuplicateIcon-DK5o2DOi.js","createIcon-BhUMOhLi.js","DynamicMarkdown-CB65PNP6.js","SectionHeading-CFm0ExWC.js","axios-vUo_bRtp.js","Markdown-DpTaXMU_.js","clsx-DfU2JnNK.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CD2M8nBr.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-hZLJ20IU.js"]}