{
"code": "40023",
"message": "Everyone joining the policy has to declare their medical history first. Still to declare: Sam New, Sara New.",
"employee_ids": [
"1333333333",
"1333333334"
]
}
{
"code": "40101",
"message": "Unauthenticated"
}
{
"code": "40401",
"message": "Not found"
}
Add employees
Adds the people on the company employee list who are not on this paid policy yet: new employees with their dependents, and new dependents of employees already covered. Everyone joining must have declared first. They are priced by the insurer of the policy for the days from today to the last day of the policy, and the response carries a payment link. Once paid they join this same policy. Calling again before payment replaces the unpaid addition. Removals are not supported yet.
{
"code": "40023",
"message": "Everyone joining the policy has to declare their medical history first. Still to declare: Sam New, Sara New.",
"employee_ids": [
"1333333333",
"1333333334"
]
}
{"docsConfig":{"theme":"linden","$schema":"https://mintlify.com/docs.json","name":"Yasmina embedded insurance","colors":{"primary":"#16A34A","light":"#07C983","dark":"#15803D"},"logo":{"light":"https://mintcdn.com/yasmina/gYT_wrUNH6DJHRcX/logo/light.svg?fit=max\u0026auto=format\u0026n=gYT_wrUNH6DJHRcX\u0026q=85\u0026s=8f104780e9e2be0f5ed858abf5daf565","dark":"https://mintcdn.com/yasmina/gYT_wrUNH6DJHRcX/logo/dark.svg?fit=max\u0026auto=format\u0026n=gYT_wrUNH6DJHRcX\u0026q=85\u0026s=4b99116ce5278adfe03cc2508a4ead66"},"favicon":"https://mintcdn.com/yasmina/gYT_wrUNH6DJHRcX/favicon.svg?fit=max\u0026auto=format\u0026n=gYT_wrUNH6DJHRcX\u0026q=85\u0026s=011065c671b0598099e2297a50ad5260","api":{"params":{"expanded":"all"},"playground":{"display":"interactive","proxy":false},"examples":{"defaults":"required"}},"background":{"color":{"light":"#FFF","dark":"#000"}},"navbar":{"primary":{"type":"button","label":"Portal","href":"https://portal.yasmina.ai"}},"fonts":{"family":"Inter, sans-serif"},"styling":{"eyebrows":"breadcrumbs","latex":false},"integrations":{"amplitude":{"apiKey":"3fd7f32ecb0ff851ba9ea3b6670cd855"},"intercom":{"appId":"yu8wo042"}},"contextual":{"options":["mcp"],"display":"header"},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"yasmina","hasAudioNarration":false,"actualSubdomain":"yasmina","customDomains":["docs.yasmina.ai"],"gitSource":{"type":"github","owner":"yasminaai","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"entitlements":{},"buildId":"6af1d2007ffc68b33005f696","clientVersion":"0.0.4088","searchFilterCounts":[{"language":"default","tag":"API Reference","count":61},{"language":"default","tag":"Policies","count":25},{"language":"default","tag":"Guide","count":21},{"language":"default","tag":"SME Medical APIs","count":18},{"language":"default","tag":"Motor Insurance APIs (Multiple Providers)","count":17},{"language":"default","tag":"SDKs","count":10},{"language":"default","tag":"Front-End SDKs","count":10},{"language":"default","tag":"Insurance Integration Guides","count":9},{"language":"default","tag":"Quotes","count":9},{"language":"default","tag":"Property Insurance APIs","count":8}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":".nav-logo{height:40px}#pagination{display:none!important}.ai-note{display:flex;align-items:flex-start;gap:0.65rem;margin:1rem 0 1.5rem;padding:0.9rem 1rem;border:1px solid #93c5fd;border-radius:0.75rem;background-color:#eff6ff;color:#1e40af}.ai-note svg{flex-shrink:0;margin-top:0.2rem}.ai-note p{margin:0;color:inherit}.ai-note a{color:inherit;font-weight:600;text-decoration:underline}.dark .ai-note{border-color:#1e40af;background-color:rgba(30, 58, 138, 0.25);color:#93c5fd}"}],"page":{"pagePath":"medical-api-reference/policies/add-employees","slug":"/medical-api-reference/policies/add-employees","pageMetadata":{"title":"Add employees","description":"Adds the people on the company employee list who are not on this paid policy yet: new employees with their dependents, and new dependents of employees already covered. Everyone joining must have declared first. They are priced by the insurer of the policy for the days from today to the last day of the policy, and the response carries a payment link. Once paid they join this same policy. Calling again before payment replaces the unpaid addition. Removals are not supported yet.","deprecated":null,"version":null,"openapi":"/medical-api-reference/openapi.json post /policies/{policyId}/additions","href":"/medical-api-reference/policies/add-employees","autogeneratedByOpenApi":true},"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: \"Adds the people on the company employee list who are not on this paid policy yet: new employees with their dependents, and new dependents of employees already covered. Everyone joining must have declared first. They are priced by the insurer of the policy for the days from today to the last day of the policy, and the response carries a payment link. Once paid they join this same policy. Calling again before payment replaces the unpaid addition. Removals are not supported yet.\"\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":"Add employees","description":"Adds the people on the company employee list who are not on this paid policy yet: new employees with their dependents, and new dependents of employees already covered. Everyone joining must have declared first. They are priced by the insurer of the policy for the days from today to the last day of the policy, and the response carries a payment link. Once paid they join this same policy. Calling again before payment replaces the unpaid addition. Removals are not supported yet.","deprecated":null,"version":null,"openapi":"/medical-api-reference/openapi.json post /policies/{policyId}/additions","href":"/medical-api-reference/policies/add-employees","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/yasmina/ccacd844f457d935/script.js"],"openApiReferenceData":{"operation":{"summary":"Add employees","tags":["Policies"],"description":"Adds the people on the company employee list who are not on this paid policy yet: new employees with their dependents, and new dependents of employees already covered. Everyone joining must have declared first. They are priced by the insurer of the policy for the days from today to the last day of the policy, and the response carries a payment link. Once paid they join this same policy. Calling again before payment replaces the unpaid addition. Removals are not supported yet.","parameters":["21101e47-ba3f-406a-8f78-aac1b9935d04"],"responses":{"201":"d2753661-355a-40a8-b72e-75a268040d16","400":"04965084-f826-4788-b123-79cd2b0e1d72","401":"9f7e33da-de92-4ec9-b8d8-3c17ceba3f9c","404":"28f284da-fe76-40b4-a421-f720004a55ac"},"method":"post","type":"path","servers":["d990ff39-7287-427c-a1a9-5b8bf7698628","b354b424-f38f-4be8-b3ae-66187d35f533"],"security":["2db49642-607b-4389-b0f5-a3240badb876"],"path":"/policies/{policyId}/additions","baseUrlOptions":["https://production.yasmina.ai/api/v1/medical","https://sandbox.yasmina.ai/api/v1/medical"],"title":"Add employees","codeSamples":[],"requiredOnlyExamples":true,"requestExampleType":"generated","responseExampleType":"generated","disableProxy":true},"dependencies":{"parameters":{"21101e47-ba3f-406a-8f78-aac1b9935d04":{"name":"policyId","required":true,"description":"The id of the paid policy","in":"path","schema":{"type":"integer","isRequired":true,"description":"The id of the paid policy","uniqueKey":"","typeLabel":"integer"}}},"responses":{"d2753661-355a-40a8-b72e-75a268040d16":{"description":"The addition, waiting to be paid","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid","uniqueKey":"id","typeLabel":"string\u003cuuid>"},"status":{"type":"string","enum":["pending","paid"],"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"insurance_provider":{"type":"string","description":"The insurer of the policy, which prices the addition","uniqueKey":"insurance_provider","typeLabel":"string"},"starts_on":{"type":"string","format":"date","description":"The first day the new people are covered: the day the addition was priced","uniqueKey":"starts_on","typeLabel":"string\u003cdate>"},"ends_on":{"type":"string","format":"date","description":"The last day of the policy","uniqueKey":"ends_on","typeLabel":"string\u003cdate>"},"days":{"type":"integer","description":"Days from starts_on to ends_on, both included","uniqueKey":"days","typeLabel":"integer"},"members":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","uniqueKey":"members.items.[INDEX].name","typeLabel":"string"},"identifier":{"type":"string","description":"National id or iqama","uniqueKey":"members.items.[INDEX].identifier","typeLabel":"string"},"type":{"type":"string","enum":["employee","dependent"],"uniqueKey":"members.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"category":{"type":"string","description":"The tier. A dependent is covered under the tier of the employee they are listed beneath","uniqueKey":"members.items.[INDEX].category","typeLabel":"string"},"price":{"type":"number","description":"What this person costs for the days covered. Dependents are not charged separately","uniqueKey":"members.items.[INDEX].price","typeLabel":"number"}},"uniqueKey":"members.items.[INDEX]","typeLabel":"object"},"description":"Everyone joining: new employees, their dependents, and new dependents of employees already covered","uniqueKey":"members","typeLabel":"object[]"},"total_price":{"type":"number","uniqueKey":"total_price","typeLabel":"number"},"currency":{"type":"string","example":"SAR","uniqueKey":"currency","typeLabel":"string"},"payment_link":{"oneOf":[{"type":"string","description":"Where the company pays for the addition. Null once it is paid","uniqueKey":"payment_link.oneOf.0","typeLabel":"string"},{"type":"null","description":"Where the company pays for the addition. Null once it is paid","uniqueKey":"payment_link.oneOf.1","typeLabel":"null"}],"uniqueKey":"payment_link","typeLabel":"string | null"},"created_at":{"type":"string","format":"date-time","uniqueKey":"created_at","typeLabel":"string\u003cdate-time>"},"paid_at":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"paid_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"paid_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"paid_at","typeLabel":"string\u003cdate-time> | null"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","status":"pending","insurance_provider":"\u003cstring>","starts_on":"2023-12-25","ends_on":"2023-12-25","days":123,"members":[{"name":"\u003cstring>","identifier":"\u003cstring>","type":"employee","category":"\u003cstring>","price":123}],"total_price":123,"currency":"SAR","payment_link":"\u003cstring>","created_at":"2023-11-07T05:31:56Z","paid_at":"2023-11-07T05:31:56Z"}}},"exampleType":"generated"}},"exampleType":"generated"},"04965084-f826-4788-b123-79cd2b0e1d72":{"description":"`40023` when someone joining has not declared yet (employee_ids lists them), `40024` when the policy would pass 250 employees, `40027` when the policy is unpaid, cancelled or expired, `40028` when nobody on the list is new.","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","uniqueKey":"code","typeLabel":"string"},"message":{"type":"string","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"code":"40023","message":"Everyone joining the policy has to declare their medical history first. Still to declare: Sam New, Sara New.","employee_ids":["1333333333","1333333334"]},"examples":{"Example":{"title":"Example","value":{"code":"40023","message":"Everyone joining the policy has to declare their medical history first. Still to declare: Sam New, Sara New.","employee_ids":["1333333333","1333333334"]}}},"exampleType":"examples"}},"exampleType":"examples"},"9f7e33da-de92-4ec9-b8d8-3c17ceba3f9c":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","example":"40101","uniqueKey":"code","typeLabel":"string"},"message":{"type":"string","example":"Unauthenticated","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"40101","message":"Unauthenticated"}}},"exampleType":"generated"}},"exampleType":"generated"},"28f284da-fe76-40b4-a421-f720004a55ac":{"description":"Record not found","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","example":"40401","uniqueKey":"code","typeLabel":"string"},"message":{"type":"string","example":"Not found","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"40401","message":"Not found"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"2db49642-607b-4389-b0f5-a3240badb876":{"bearerAuth":{"type":"http","scheme":"bearer","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"d990ff39-7287-427c-a1a9-5b8bf7698628":{"url":"https://production.yasmina.ai/api/v1/medical"},"b354b424-f38f-4be8-b3ae-66187d35f533":{"url":"https://sandbox.yasmina.ai/api/v1/medical"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"medical-api-reference/openapi.json"},"subdomain":"yasmina","siteName":"Yasmina embedded insurance","title":"Add employees - Yasmina embedded insurance","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-09T08:09:52.182Z","originalFileLocation":"medical-api-reference/policies/add-employees.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=\"Adds the people on the company employee list who are not on this paid policy yet: new employees with their dependents, and new dependents of employees already covered. Everyone joining must have declared first. They are priced by the insurer of the policy for the days from today to the last day of the policy, and the response carries a payment link. Once paid they join this same policy. Calling again before payment replaces the unpaid addition. Removals are not supported yet.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Yasmina embedded insurance\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/yasmina/Flkq5q_nHTtKlHnv/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/yasmina/Flkq5q_nHTtKlHnv/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/yasmina/Flkq5q_nHTtKlHnv/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/yasmina/Flkq5q_nHTtKlHnv/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/yasmina/Flkq5q_nHTtKlHnv/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/yasmina/Flkq5q_nHTtKlHnv/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/yasmina/Flkq5q_nHTtKlHnv/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/yasmina/Flkq5q_nHTtKlHnv/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/yasmina/Flkq5q_nHTtKlHnv/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Add employees - Yasmina embedded insurance\">\u003cmeta data-mint-head property=\"og:description\" content=\"Adds the people on the company employee list who are not on this paid policy yet: new employees with their dependents, and new dependents of employees already covered. Everyone joining must have declared first. They are priced by the insurer of the policy for the days from today to the last day of the policy, and the response carries a payment link. Once paid they join this same policy. Calling again before payment replaces the unpaid addition. Removals are not supported yet.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Yasmina embedded insurance\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.yasmina.ai/medical-api-reference/policies/add-employees\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://yasmina.mintlify.site/_mintlify/api/og/v2?division=Policies\u0026amp;title=Add+employees\u0026amp;description=Adds+the+people+on+the+company+employee+list+who+are+not+on+this+paid+policy+yet%3A+new+employees+with+their+dependents%2C+and+new+dependents+of+employees+already+c\u0026amp;theme=e2077e43cb421df0ca824625\u0026amp;signature=6ee9cfa0f67d904af58e56ca3b3b0b926645981c4ae2cb002c5c3f890806474a\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Add employees - Yasmina embedded insurance\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Adds the people on the company employee list who are not on this paid policy yet: new employees with their dependents, and new dependents of employees already covered. Everyone joining must have declared first. They are priced by the insurer of the policy for the days from today to the last day of the policy, and the response carries a payment link. Once paid they join this same policy. Calling again before payment replaces the unpaid addition. Removals are not supported yet.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://yasmina.mintlify.site/_mintlify/api/og/v2?division=Policies\u0026amp;title=Add+employees\u0026amp;description=Adds+the+people+on+the+company+employee+list+who+are+not+on+this+paid+policy+yet%3A+new+employees+with+their+dependents%2C+and+new+dependents+of+employees+already+c\u0026amp;theme=e2077e43cb421df0ca824625\u0026amp;signature=6ee9cfa0f67d904af58e56ca3b3b0b926645981c4ae2cb002c5c3f890806474a\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/yasmina/Flkq5q_nHTtKlHnv/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Yasmina embedded insurance\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#16A34A\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.yasmina.ai/medical-api-reference/policies/add-employees\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/medical-api-reference/policies/add-employees.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.yasmina.ai/#organization\",\"name\":\"Yasmina embedded insurance\",\"url\":\"https://docs.yasmina.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/yasmina/gYT_wrUNH6DJHRcX/logo/light.svg?fit=max\u0026auto=format\u0026n=gYT_wrUNH6DJHRcX\u0026q=85\u0026s=8f104780e9e2be0f5ed858abf5daf565\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.yasmina.ai#website\",\"name\":\"Yasmina embedded insurance\",\"url\":\"https://docs.yasmina.ai\",\"publisher\":{\"@id\":\"https://docs.yasmina.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.yasmina.ai/medical-api-reference/policies/add-employees#webpage\",\"url\":\"https://docs.yasmina.ai/medical-api-reference/policies/add-employees\",\"name\":\"Add employees\",\"description\":\"Adds the people on the company employee list who are not on this paid policy yet: new employees with their dependents, and new dependents of employees already covered. Everyone joining must have declared first. They are priced by the insurer of the policy for the days from today to the last day of the policy, and the response carries a payment link. Once paid they join this same policy. Calling again before payment replaces the unpaid addition. Removals are not supported yet.\",\"dateModified\":\"2026-11-09T08:09:52.182Z\",\"isPartOf\":{\"@id\":\"https://docs.yasmina.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.yasmina.ai/medical-api-reference/policies/add-employees#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.yasmina.ai/medical-api-reference/policies/add-employees#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"SME Medical APIs\",\"item\":\"https://docs.yasmina.ai/medical-api-reference/company/list-companies\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Policies\",\"item\":\"https://docs.yasmina.ai/medical-api-reference/policies/list-policies\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Add employees\",\"item\":\"https://docs.yasmina.ai/medical-api-reference/policies/add-employees\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.yasmina.ai/medical-api-reference/policies/add-employees#apireference\",\"headline\":\"Add employees\",\"name\":\"Add employees\",\"description\":\"Adds the people on the company employee list who are not on this paid policy yet: new employees with their dependents, and new dependents of employees already covered. Everyone joining must have declared first. They are priced by the insurer of the policy for the days from today to the last day of the policy, and the response carries a payment link. Once paid they join this same policy. Calling again before payment replaces the unpaid addition. Removals are not supported yet.\",\"url\":\"https://docs.yasmina.ai/medical-api-reference/policies/add-employees\",\"mainEntityOfPage\":{\"@id\":\"https://docs.yasmina.ai/medical-api-reference/policies/add-employees#webpage\"},\"dateModified\":\"2026-11-09T08:09:52.182Z\",\"publisher\":{\"@id\":\"https://docs.yasmina.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.yasmina.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Yasmina embedded insurance\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Yasmina embedded insurance","nav":{"global":null,"tabs":[{"tab":"Guide","icon":"book","pages":[{"title":"Guide","href":"/introduction"}]},{"tab":"API Reference","icon":"file-code","groups":[{"group":"Authentication","pages":[{"group":"Oauth 2.0","pages":[{"title":"Generate Token","deprecated":null,"version":null,"openapi":"/auth-api-reference/openapi.json post /oauth/token","href":"/auth-api-reference/oauth-20/generate-token"}]}]},{"group":"SME Medical APIs","pages":[{"group":"Company","pages":[{"title":"List companies","deprecated":null,"version":null,"openapi":"/medical-api-reference/openapi.json get /companies","href":"/medical-api-reference/company/list-companies"},{"title":"Create company","deprecated":null,"version":null,"openapi":"/medical-api-reference/openapi.json post /companies","href":"/medical-api-reference/company/create-company"},{"title":"Cancel policy","deprecated":null,"version":null,"openapi":"/medical-api-reference/openapi.json post /companies/{companyId}/policy-cancellation","href":"/medical-api-reference/company/cancel-policy"}]},{"group":"Employees","pages":[{"title":"List the employees","deprecated":null,"version":null,"openapi":"/medical-api-reference/openapi.json get /companies/{companyId}/employees","href":"/medical-api-reference/employees/list-the-employees"},{"title":"Save the employees","deprecated":null,"version":null,"openapi":"/medical-api-reference/openapi.json put /companies/{companyId}/employees","href":"/medical-api-reference/employees/save-the-employees"},{"title":"Fetch the employees","deprecated":null,"version":null,"openapi":"/medical-api-reference/openapi.json post /companies/{companyId}/employees/fetch","href":"/medical-api-reference/employees/fetch-the-employees"}]},{"group":"Medical Forms","pages":[{"title":"Submit the declarations","deprecated":null,"version":null,"openapi":"/medical-api-reference/openapi.json put /companies/{companyId}/declarations","href":"/medical-api-reference/medical-forms/submit-the-declarations"},{"title":"Download the declaration form","deprecated":null,"version":null,"openapi":"/medical-api-reference/openapi.json get /medical-forms/download","href":"/medical-api-reference/medical-forms/download-the-declaration-form"},{"title":"Get the Medical form questions","deprecated":null,"version":null,"openapi":"/medical-api-reference/openapi.json get /medical-forms","href":"/medical-api-reference/medical-forms/get-the-medical-form-questions"}]},{"group":"Quotes","pages":[{"title":"Get prices from every provider","deprecated":null,"version":null,"openapi":"/medical-api-reference/openapi.json post /quote-requests","href":"/medical-api-reference/quotes/get-prices-from-every-provider"},{"title":"Read a quote request","deprecated":null,"version":null,"openapi":"/medical-api-reference/openapi.json get /quote-requests/{quoteRequestId}","href":"/medical-api-reference/quotes/read-a-quote-request"}]},{"group":"Policies","pages":[{"title":"List policies","deprecated":null,"version":null,"openapi":"/medical-api-reference/openapi.json get /policies","href":"/medical-api-reference/policies/list-policies"},{"title":"Issue the policy","deprecated":null,"version":null,"openapi":"/medical-api-reference/openapi.json post /policies","href":"/medical-api-reference/policies/issue-the-policy"},{"title":"Read the policy","deprecated":null,"version":null,"openapi":"/medical-api-reference/openapi.json get /policies/{policyId}","href":"/medical-api-reference/policies/read-the-policy"},{"title":"Cancel a policy","description":"Cancel a policy. Important if, for example, someone resigns","deprecated":null,"version":null,"openapi":"/medical-api-reference/openapi.json post /policies/{policyId}/deletion","href":"/medical-api-reference/policies/cancel-a-policy"},{"title":"Add employees","deprecated":null,"version":null,"openapi":"/medical-api-reference/openapi.json post /policies/{policyId}/additions","href":"/medical-api-reference/policies/add-employees"}]},{"group":"Products","pages":[{"title":"List a network's facilities","description":"The hospitals, clinics, pharmacies and other facilities one tier of one provider gives access to, each with its `status` in that tier: `included` for direct access, `referral` when a referral is needed first. Filter by `city` to show one city at a time, or by `search` to match a facility's English or Arabic name. This is the `provider_list_url` the Categories and Quote APIs return with every tier.","deprecated":null,"version":null,"openapi":"/medical-api-reference/openapi.json get /products/networks","href":"/medical-api-reference/products/list-a-networks-facilities"},{"title":"List categories","deprecated":null,"version":null,"openapi":"/medical-api-reference/openapi.json get /products/categories","href":"/medical-api-reference/products/list-categories"}]}]},{"group":"Motor Insurance APIs (Multiple Providers)","pages":[{"group":"Vehicle lookups","pages":[{"title":"List vehicle makers","deprecated":null,"version":null,"openapi":"/car-api-reference/openapi.json get /vehicle-makers","href":"/car-api-reference/vehicle-lookups/list-vehicle-makers"},{"title":"List vehicle models","deprecated":null,"version":null,"openapi":"/car-api-reference/openapi.json get /vehicle-models","href":"/car-api-reference/vehicle-lookups/list-vehicle-models"},{"title":"List vehicle body types","deprecated":null,"version":null,"openapi":"/car-api-reference/openapi.json get /vehicle-body-types","href":"/car-api-reference/vehicle-lookups/list-vehicle-body-types"}]},{"group":"Quotes","pages":[{"title":"Show quote","deprecated":null,"version":null,"openapi":"/car-api-reference/openapi.json get /quote-requests/{id}","href":"/car-api-reference/quotes/show-quote"},{"title":"Delete quote","deprecated":null,"version":null,"openapi":"/car-api-reference/openapi.json delete /quote-requests/{id}","href":"/car-api-reference/quotes/delete-quote"},{"title":"List quotes","deprecated":null,"version":null,"openapi":"/car-api-reference/openapi.json get /quote-requests","href":"/car-api-reference/quotes/list-quotes"},{"title":"Request quotes","deprecated":null,"version":null,"openapi":"/car-api-reference/openapi.json post /quote-requests","href":"/car-api-reference/quotes/request-quotes"},{"title":"Guideline texts","deprecated":null,"version":null,"openapi":"/car-api-reference/openapi.json get /guideline-texts","href":"/car-api-reference/quotes/guideline-texts"},{"title":"Upload vehicle photos","deprecated":null,"version":null,"openapi":"/car-api-reference/openapi.json post /quote-requests/{id}/attachments","href":"/car-api-reference/quotes/upload-vehicle-photos"}]},{"group":"Embed sessions","pages":[{"title":"Create embed session","deprecated":null,"version":null,"openapi":"/car-api-reference/openapi.json post /embed-sessions","href":"/car-api-reference/embed-sessions/create-embed-session"},{"title":"Show embed session","deprecated":null,"version":null,"openapi":"/car-api-reference/openapi.json get /embed-sessions/{id}","href":"/car-api-reference/embed-sessions/show-embed-session"},{"title":"Store vehicle photos for an embed session","deprecated":null,"version":null,"openapi":"/car-api-reference/openapi.json post /embed-sessions/{id}/photos","href":"/car-api-reference/embed-sessions/store-vehicle-photos-for-an-embed-session"}]},{"group":"Policies","pages":[{"title":"Show policy","deprecated":null,"version":null,"openapi":"/car-api-reference/openapi.json get /policies/{carPolicy}","href":"/car-api-reference/policies/show-policy"},{"title":"List policies","deprecated":null,"version":null,"openapi":"/car-api-reference/openapi.json get /policies","href":"/car-api-reference/policies/list-policies"},{"title":"Issue policy","deprecated":null,"version":null,"openapi":"/car-api-reference/openapi.json post /policies","href":"/car-api-reference/policies/issue-policy"}]},{"group":"OTPs","pages":[{"title":"Request OTP for quote verification","deprecated":null,"version":null,"openapi":"/car-api-reference/openapi.json post /quote-otp","href":"/car-api-reference/otps/request-otp-for-quote-verification"},{"title":"Request OTP for Issuing Policy","deprecated":null,"version":null,"openapi":"/car-api-reference/openapi.json post /issue-otp","href":"/car-api-reference/otps/request-otp-for-issuing-policy"}]}]},{"group":"Property Insurance APIs","pages":[{"group":"Prices","pages":[{"title":"List prices","deprecated":null,"version":null,"openapi":"/property-api-reference/openapi.json get /prices","href":"/property-api-reference/prices/list-prices"}]},{"group":"Policies","pages":[{"title":"Show policy","deprecated":null,"version":null,"openapi":"/property-api-reference/openapi.json get /policies/{propertyPolicy}","href":"/property-api-reference/policies/show-policy"},{"title":"List policies","deprecated":null,"version":null,"openapi":"/property-api-reference/openapi.json get /policies","href":"/property-api-reference/policies/list-policies"},{"title":"Issue policy","deprecated":null,"version":null,"openapi":"/property-api-reference/openapi.json post /policies","href":"/property-api-reference/policies/issue-policy"},{"title":"Cancellation status","deprecated":null,"version":null,"openapi":"/property-api-reference/openapi.json get /policies/{propertyPolicy}/cancellation-status","href":"/property-api-reference/policies/cancellation-status"},{"title":"Upload documents","deprecated":null,"version":null,"openapi":"/property-api-reference/openapi.json post /policies/{propertyPolicy}/documents","href":"/property-api-reference/policies/upload-documents"}]},{"group":"Claims","pages":[{"title":"Issue claim","deprecated":null,"version":null,"openapi":"/property-api-reference/openapi.json post /policies/{propertyPolicy}/claims","href":"/property-api-reference/claims/issue-claim"}]},{"group":"Addresses","pages":[{"title":"Get full address from short address code","deprecated":null,"version":null,"openapi":"/property-api-reference/openapi.json get /address-from-short","href":"/property-api-reference/addresses/get-full-address-from-short-address-code"}]}]},{"group":"Travel Insurance APIs","pages":[{"group":"Quotes","pages":[{"title":"Request Quote","deprecated":null,"version":null,"openapi":"/yasmina-schengen-travel-insurance/openapi.json post /quotes","href":"/yasmina-schengen-travel-insurance/quotes/request-quote"}]},{"group":"Policies","pages":[{"title":"Show policy","deprecated":null,"version":null,"openapi":"/yasmina-schengen-travel-insurance/openapi.json get /policies/{travelPolicy}","href":"/yasmina-schengen-travel-insurance/policies/show-policy"},{"title":"List policies","deprecated":null,"version":null,"openapi":"/yasmina-schengen-travel-insurance/openapi.json get /policies","href":"/yasmina-schengen-travel-insurance/policies/list-policies"},{"title":"Purchase","deprecated":null,"version":null,"openapi":"/yasmina-schengen-travel-insurance/openapi.json post /policies","href":"/yasmina-schengen-travel-insurance/policies/purchase"}]}]},{"group":"Life (S\u0026P) Insurance APIs","pages":[{"group":"Offers","pages":[{"title":"Life S\u0026P Products","deprecated":null,"version":null,"openapi":"/life-snp/openapi.json post /offers","href":"/life-snp/offers/life-s\u0026p-products"}]},{"group":"Policies","pages":[{"title":"List policies","deprecated":null,"version":null,"openapi":"/life-snp/openapi.json get /policies","href":"/life-snp/policies/list-policies"},{"title":"Issue policy","deprecated":null,"version":null,"openapi":"/life-snp/openapi.json post /policies","href":"/life-snp/policies/issue-policy"},{"title":"Cancel policy","deprecated":null,"version":null,"openapi":"/life-snp/openapi.json post /policies/{lifePolicy}/cancellation","href":"/life-snp/policies/cancel-policy"}]},{"group":"Claims","pages":[{"title":"Submit claim","deprecated":null,"version":null,"openapi":"/life-snp/openapi.json post /policies/{policyId}/claims","href":"/life-snp/claims/submit-claim"}]}]},{"group":"TPL Motor Insurance - Flat Fee APIs V2","pages":[{"group":"Policies","pages":[{"title":"List policies","deprecated":null,"version":null,"openapi":"/cartpl-api-reference-v2/openapi.json get /v2/car/policies","href":"/cartpl-api-reference-v2/policies/list-policies"},{"title":"Issue policy","deprecated":null,"version":null,"openapi":"/cartpl-api-reference-v2/openapi.json post /v2/car/policies","href":"/cartpl-api-reference-v2/policies/issue-policy"},{"title":"Cancel policy","deprecated":null,"version":null,"openapi":"/cartpl-api-reference-v2/openapi.json post /v2/car/policies/{carPolicy}/cancellation","href":"/cartpl-api-reference-v2/policies/cancel-policy"},{"title":"Cancel policy by VIN","deprecated":null,"version":null,"openapi":"/cartpl-api-reference-v2/openapi.json post /v2/clients/policies/cancellation","href":"/cartpl-api-reference-v2/policies/cancel-policy-by-vin"}]}]},{"group":"Horse Insurance APIs","pages":[{"group":"Policies","pages":[{"title":"Create a horse policy","deprecated":null,"version":null,"openapi":"/horse-api-reference/openapi.json post /policies","href":"/horse-api-reference/policies/create-a-horse-policy"},{"title":"Cancel policy","deprecated":null,"version":null,"openapi":"/horse-api-reference/openapi.json post /policies/{horsePolicy}/cancellation","href":"/horse-api-reference/policies/cancel-policy"}]},{"group":"Claims","pages":[{"title":"Issue claim","deprecated":null,"version":null,"openapi":"/horse-api-reference/openapi.json post /policies/{policyId}/claims","href":"/horse-api-reference/claims/issue-claim"}]}]},{"group":"Payment","pages":[{"group":"Payments","pages":[{"title":"List payments","deprecated":null,"version":null,"openapi":"/payments-api-reference/openapi.json get /payments","href":"/payments-api-reference/payments/list-payments"}]}]}]},{"tab":"SDKs","icon":"brackets-curly","pages":[{"title":"SDKs","href":"/sdks/ios"}]},{"tab":"Changelog","icon":"clock-rotate-left","pages":[{"title":"Changelog","href":"/changelog"}]}]},"basePath":"","title":"Add employees - Yasmina embedded insurance","buildId":"dpl_DTau1J5HqS9UTgVSDwGksstFWtPa","deploymentId":"dpl_DTau1J5HqS9UTgVSDwGksstFWtPa","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-5FCzAcfS.js","utils-SLtAG4EZ.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-2DZi8ZMu.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-D7J3nkzE.js","snippetPresets-D0Alv0AH.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BI4qNJ2c.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BD3uyr8j.js","shallow-D8iEBr5z.js","getApiPlaygroundDisplay-CgNP4lzR.js","CodeSnippet-CX-QHuMs.js","CodeSnippets-VlXE-ZUf.js","Page-D9ithiIZ.js","getPastedJson-DYNQkZ1M.js","icon-CzacdwOi.js","MethodPill-2JVqoYKi.js","DuplicateIcon-_xVXs-U8.js","createIcon-BRHrweLo.js","DynamicMarkdown-mQG_iQiE.js","SectionHeading-DMpJzv8f.js","axios-vUo_bRtp.js","Markdown-5FGIym-8.js","clsx-D-TRO5q5.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CdrJecqK.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-CHlcWBLM.js"]}