Adds a new user to the given organization and returns it as the list returns it. The user is created the same way as by the users import: a new person gets a pending account (or the status the organization’s user setup prescribes), the organization’s default language and country, and the license and employee-group defaults of the organization.
No other user of the organization may have the same email, externalSourceId or employeeId; this endpoint never updates an existing user. When the client application shares person data across organizations, the email also can’t belong to a person employed in another organization. Unknown departments, dimensions, dimension values and languages, and invalid bank account numbers, IBAN or BIC values are rejected instead of ignored. The person’s address country is the organization’s country; ssn and bankAccountNumber are validated for it.
The user gets an invitation email when sendInvitationMail is true. When sendInvitationMail is left out, the user is invited if the calling client application sends invitations for activated organizations and the organization is activated. An organization whose user setup sends invitations to every new user invites them even when sendInvitationMail is false.
Returns 404 when the organization does not exist, can’t have users, or the authenticated user is not an administrator of it, so a caller cannot tell an organization they lack access to from a missing one.
Required. String. Identifies the organization the user is added to. Accepts either the organization's internal ID (32-character hexadecimal string) or its externalSourceId (the string an integration set on the organization). This endpoint supports externalId: when the value has the format of an internal ID and an organization with that ID exists, the internal ID takes precedence; otherwise the value is looked up as externalSourceId.
Optional. Boolean. true sends the new user an invitation email, false doesn't (unless the organization's user setup invites every new user). When left out, the user is invited only if the calling client application sends invitations for activated organizations and the organization is activated.
Body
application/json
A new user of an organization. The properties have the same names and formats as in the list response, so a listed user can be posted as is: null for an optional property means it isn't set, and the read-only properties id, lastInvitationDate and dateCreated are ignored. email, firstName, lastName, externalSourceId, employeeId, title, mobilePhone and bankAccountNumber can be at most 255 characters long after leading and trailing whitespace is removed, and a text dimension's presetStringValue at most 255 characters; a longer value is rejected with 400 FIELD_EXCEEDS_MAX_LENGTH. Unless a property states otherwise, the other string properties have no validated length or pattern.
Required. String. The user's email address, also used to log in. No other user of the organization may have it; a deleted user's email address can be reused. At most 255 characters after leading and trailing whitespace is removed, otherwise 400 FIELD_EXCEEDS_MAX_LENGTH.
Required. String. The user's first name. At most 255 characters after leading and trailing whitespace is removed, otherwise 400 FIELD_EXCEEDS_MAX_LENGTH.
Required. String. The user's last name. At most 255 characters after leading and trailing whitespace is removed, otherwise 400 FIELD_EXCEEDS_MAX_LENGTH.
Optional. String. Identifier of the user in an external system. No other user of the organization may have it. At most 255 characters after leading and trailing whitespace is removed, otherwise 400 FIELD_EXCEEDS_MAX_LENGTH.
Optional. String. The user's employee number in the organization. No other user of the organization may have it. At most 255 characters after leading and trailing whitespace is removed, otherwise 400 FIELD_EXCEEDS_MAX_LENGTH.
Optional. String. The user's job title. At most 255 characters after leading and trailing whitespace is removed, otherwise 400 FIELD_EXCEEDS_MAX_LENGTH.
Optional. String. The user's mobile phone number in international format (e.g. +46701234567). At most 255 characters after leading and trailing whitespace is removed, otherwise 400 FIELD_EXCEEDS_MAX_LENGTH.
Optional. String. The user's personal identity number (social security number), validated for the organization's country. Stored normalized, for Swedish numbers without separator and century digits (19121212-1212 is stored as 1212121212). No other person may have it.
Optional. The department (organizational unit) of the organization to place the user in, identified by either id or externalSourceId; at least one of them is required. When both are given, id is used.
Optional. Custom dimension values to preset on the user, used as defaults on the user's expenses. The other properties of a listed preset value are ignored.
Optional. String. The user's bank account number for reimbursements, validated for the organization's country unless the client application turns that validation off. Stored without separators (9562-1537876 is stored as 95621537876). At most 255 characters after leading and trailing whitespace is removed, otherwise 400 FIELD_EXCEEDS_MAX_LENGTH.
String. The user's personal identity number (social security number), as stored. A number entered by the user is stored normalized, for Swedish numbers without separator and century digits (e.g. 1212121212). Null when not set.
Custom dimension values preset on the user, used as defaults on the user's expenses. Excludes values belonging to deleted dimension definitions. Empty when none are set.
String. The user's language and region as a locale code (language_COUNTRY, e.g. en_GB, sv_SE). Null when the user has not chosen a language, in which case the organization's language applies.
ISO-8601 date-time in UTC (yyyy-MM-ddTHH:mm:ssZ). When the user was last sent an invitation email. Null when the user has not been invited, or has since activated their account.
{"docsConfig":{"theme":"luma","$schema":"https://mintlify.com/docs.json","name":"Findity Docs","colors":{"primary":"#012A2D","light":"#3FA9A5","dark":"#012A2D"},"logo":{"light":"https://mintcdn.com/findity-docs/fTsgC-3N_Y6D9oSZ/images/logo/light.avif?fit=max\u0026auto=format\u0026n=fTsgC-3N_Y6D9oSZ\u0026q=85\u0026s=b7bba7599b80f1ac5c6454a26179858b","dark":"https://mintcdn.com/findity-docs/fTsgC-3N_Y6D9oSZ/images/logo/dark.png?fit=max\u0026auto=format\u0026n=fTsgC-3N_Y6D9oSZ\u0026q=85\u0026s=c71abcb6039e30c762becf2a8475a335","href":"/"},"favicon":"https://mintcdn.com/findity-docs/fTsgC-3N_Y6D9oSZ/images/logo/favicon.jpeg?fit=max\u0026auto=format\u0026n=fTsgC-3N_Y6D9oSZ\u0026q=85\u0026s=b3050e03fc057e3744a2a9765f87aa39","api":{"params":{"expanded":"all"},"playground":{"display":"interactive","credentials":true},"examples":{"prefill":true}},"appearance":{"default":"light","strict":true},"navbar":{"links":[]},"seo":{"metatags":{"robots":"noindex"}},"fonts":{"heading":{"family":"Montserrat","format":"woff2"}},"styling":{"eyebrows":"breadcrumbs","codeblocks":"system","latex":false},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","assistant","add-mcp","vscode"],"display":"toc"},"metadata":{"timestamp":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"findity-docs","hasAudioNarration":false,"actualSubdomain":"findity-docs","customDomains":["developer.findity.com"],"gitSource":{"type":"gitlab","owner":"findity/ce","repo":"api-documentation","deployBranch":"main","contentDirectory":"api-docs","isPrivate":true,"projectId":85772420,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"REMOVE_BRANDING":{"status":"ENABLED"},"CONTEXTUAL_FEEDBACK":{"status":"ENABLED"},"CODE_SNIPPET_FEEDBACK":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6af330ce8cd3285add67bf89","clientVersion":"0.0.4094","searchFilterCounts":[{"language":"default","tag":"API Reference","count":268},{"language":"default","tag":"Findity Admin API","count":112},{"language":"default","tag":"Findity Expense API","count":91},{"language":"default","tag":"Guides","count":53},{"language":"default","tag":"Findity Admin API V0","count":52},{"language":"default","tag":"Organizations","count":51},{"language":"default","tag":"Dimensions","count":21},{"language":"default","tag":"Expense Reports","count":20},{"language":"default","tag":"User","count":16},{"language":"default","tag":"Carbon emissions","count":15}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":true,"enableContextualStarterQuestions":true,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","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}],"googleFontsInlined":true},"customCss":[{"filePath":"styles.css","content":".tabs{margin-top:20px;border:1px solid rgb(var(--default-border-color));padding:2px 6px 6px;border-radius:4px}#sidebar,#sidebar-content{width:20rem!important;max-width:20rem!important;min-width:20rem!important}#body-content{grid-template-columns:20rem 1fr!important}ul[role=\"tablist\"][data-component-part=\"tabs-list\"]{flex-wrap:wrap;overflow:visible;row-gap:0.5rem}.mdx-content .frame img{max-height:700px}.chat-assistant-input,#chat-assistant-textarea{color:#012a2d!important}.chat-assistant-input::placeholder,#chat-assistant-textarea::placeholder{color:#012a2d!important;opacity:1}"}],"page":{"pagePath":"reference/admin/users/create-user","slug":"/reference/admin/users/create-user","pageMetadata":{"title":"Create user","description":"Adds a new user to the given organization and returns it as the list returns it. The user is created the same way as by the users import: a new person gets a pending account (or the status the organization's user setup prescribes), the organization's default language and country, and the license and employee-group defaults of the organization.\n\nNo other user of the organization may have the same `email`, `externalSourceId` or `employeeId`; this endpoint never updates an existing user. When the client application shares person data across organizations, the `email` also can't belong to a person employed in another organization. Unknown departments, dimensions, dimension values and languages, and invalid bank account numbers, IBAN or BIC values are rejected instead of ignored. The person's address country is the organization's country; `ssn` and `bankAccountNumber` are validated for it.\n\nThe user gets an invitation email when `sendInvitationMail` is `true`. When `sendInvitationMail` is left out, the user is invited if the calling client application sends invitations for activated organizations and the organization is activated. An organization whose user setup sends invitations to every new user invites them even when `sendInvitationMail` is `false`.\n\nReturns 404 when the organization does not exist, can't have users, or the authenticated user is not an administrator of it, so a caller cannot tell an organization they lack access to from a missing one.\n","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json post /organizations/{organizationId}/users","href":"/reference/admin/users/create-user","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"Adds a new user to the given organization and returns it as the list returns it. The user is created the same way as by the users import: a new person gets a pending account (or the status the organization’s user setup prescribes), the organization’s default language and country, and the license and employee-group defaults of the organization.\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"No other user of the organization may have the same \", _jsx(_components.code, {\n children: \"email\"\n }), \", \", _jsx(_components.code, {\n children: \"externalSourceId\"\n }), \" or \", _jsx(_components.code, {\n children: \"employeeId\"\n }), \"; this endpoint never updates an existing user. When the client application shares person data across organizations, the \", _jsx(_components.code, {\n children: \"email\"\n }), \" also can’t belong to a person employed in another organization. Unknown departments, dimensions, dimension values and languages, and invalid bank account numbers, IBAN or BIC values are rejected instead of ignored. The person’s address country is the organization’s country; \", _jsx(_components.code, {\n children: \"ssn\"\n }), \" and \", _jsx(_components.code, {\n children: \"bankAccountNumber\"\n }), \" are validated for it.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"The user gets an invitation email when \", _jsx(_components.code, {\n children: \"sendInvitationMail\"\n }), \" is \", _jsx(_components.code, {\n children: \"true\"\n }), \". When \", _jsx(_components.code, {\n children: \"sendInvitationMail\"\n }), \" is left out, the user is invited if the calling client application sends invitations for activated organizations and the organization is activated. An organization whose user setup sends invitations to every new user invites them even when \", _jsx(_components.code, {\n children: \"sendInvitationMail\"\n }), \" is \", _jsx(_components.code, {\n children: \"false\"\n }), \".\"]\n }), \"\\n\", _jsx(_components.p, {\n children: \"Returns 404 when the organization does not exist, can’t have users, or the authenticated user is not an administrator of it, so a caller cannot tell an organization they lack access to from a missing one.\"\n })]\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":{"codeStyling":"system","config":{},"pageMetadata":{"title":"Create user","description":"Adds a new user to the given organization and returns it as the list returns it. The user is created the same way as by the users import: a new person gets a pending account (or the status the organization's user setup prescribes), the organization's default language and country, and the license and employee-group defaults of the organization.\n\nNo other user of the organization may have the same `email`, `externalSourceId` or `employeeId`; this endpoint never updates an existing user. When the client application shares person data across organizations, the `email` also can't belong to a person employed in another organization. Unknown departments, dimensions, dimension values and languages, and invalid bank account numbers, IBAN or BIC values are rejected instead of ignored. The person's address country is the organization's country; `ssn` and `bankAccountNumber` are validated for it.\n\nThe user gets an invitation email when `sendInvitationMail` is `true`. When `sendInvitationMail` is left out, the user is invited if the calling client application sends invitations for activated organizations and the organization is activated. An organization whose user setup sends invitations to every new user invites them even when `sendInvitationMail` is `false`.\n\nReturns 404 when the organization does not exist, can't have users, or the authenticated user is not an administrator of it, so a caller cannot tell an organization they lack access to from a missing one.\n","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json post /organizations/{organizationId}/users","href":"/reference/admin/users/create-user","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Create user","description":"Adds a new user to the given organization and returns it as the list returns it. The user is created the same way as by the users import: a new person gets a pending account (or the status the organization's user setup prescribes), the organization's default language and country, and the license and employee-group defaults of the organization.\n\nNo other user of the organization may have the same `email`, `externalSourceId` or `employeeId`; this endpoint never updates an existing user. When the client application shares person data across organizations, the `email` also can't belong to a person employed in another organization. Unknown departments, dimensions, dimension values and languages, and invalid bank account numbers, IBAN or BIC values are rejected instead of ignored. The person's address country is the organization's country; `ssn` and `bankAccountNumber` are validated for it.\n\nThe user gets an invitation email when `sendInvitationMail` is `true`. When `sendInvitationMail` is left out, the user is invited if the calling client application sends invitations for activated organizations and the organization is activated. An organization whose user setup sends invitations to every new user invites them even when `sendInvitationMail` is `false`.\n\nReturns 404 when the organization does not exist, can't have users, or the authenticated user is not an administrator of it, so a caller cannot tell an organization they lack access to from a missing one.\n","operationId":"adminCreateOrganizationUser","tags":["Users"],"parameters":["6bbc9a11-859d-4478-a6e8-6d8485d4d3b8","2806a2d7-6f78-47da-8cb7-2c96b3bb680e"],"requestBody":"d0ed753d-b216-45a7-80ae-11ab912d4968","responses":{"201":"8cee5fc4-759e-4831-a8e8-4253dda8c72c","400":"9ab10311-73e8-4e79-b49f-097af1932a81","404":"fc05313c-52ae-4e7c-aea5-8e25426b4a3b"},"method":"post","type":"path","servers":["20e34eef-9d99-4fd5-8bde-c32926c8074a","c1d55a91-917d-47ca-82f3-a7c42140cdea"],"security":["36ed4beb-c007-434b-9804-ba9ed346c7c5"],"path":"/organizations/{organizationId}/users","baseUrlOptions":["https://stage-api.findity.com/api/v1/admin","https://api.findity.com/api/v1/admin"],"title":"Create user","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated","prefillPlaygroundWithExample":true,"prefillPlaygroundExamples":[{"body.email":"erik.exempel@example.com","body.firstName":"Erik","body.lastName":"Exempel","body.externalSourceId.oneOf.0":"Erik_Exempel","body.employeeId.oneOf.0":"E-1001","body.title.oneOf.0":"Engineering Lead","body.mobilePhone.oneOf.0":"+46701740605","body.endDate.oneOf.0":"2027-01-31T00:00:00Z","body.ssn.oneOf.0":"19121212-1212","body.department.oneOf.0.id.oneOf.0":"9360d03ad7294220868d67f42a2a144d","body.customDimensionPresetValues.oneOf.0.items.0.dimensionDefinitionId":"c2a0b3f4d5e64f7a8b9c0d1e2f3a4b5c","body.customDimensionPresetValues.oneOf.0.items.0.presetStringValue.oneOf.0":"Project X","body.language.oneOf.0":"en_GB","body.bankAccountNumber.oneOf.0":"9562-1537876","body.IBAN.oneOf.0":"SE45 5000 0000 0583 9825 7466","body.BIC.oneOf.0":"ESSESESS","body.isAdministrator.oneOf.0":false}],"withCredentials":true},"dependencies":{"parameters":{"6bbc9a11-859d-4478-a6e8-6d8485d4d3b8":{"name":"organizationId","in":"path","required":true,"description":"Required. String. Identifies the organization the user is added to. Accepts either the organization's internal ID (32-character hexadecimal string) or its `externalSourceId` (the string an integration set on the organization). This endpoint supports externalId: when the value has the format of an internal ID and an organization with that ID exists, the internal ID takes precedence; otherwise the value is looked up as `externalSourceId`.\n","schema":{"type":"string","isRequired":true,"description":"Required. String. Identifies the organization the user is added to. Accepts either the organization's internal ID (32-character hexadecimal string) or its `externalSourceId` (the string an integration set on the organization). This endpoint supports externalId: when the value has the format of an internal ID and an organization with that ID exists, the internal ID takes precedence; otherwise the value is looked up as `externalSourceId`.\n","uniqueKey":"","typeLabel":"string"},"example":"11adfe2a080040e3892ffb89c21ec44e"},"2806a2d7-6f78-47da-8cb7-2c96b3bb680e":{"name":"sendInvitationMail","in":"query","required":false,"description":"Optional. Boolean. `true` sends the new user an invitation email, `false` doesn't (unless the organization's user setup invites every new user). When left out, the user is invited only if the calling client application sends invitations for activated organizations and the organization is activated.\n","schema":{"type":"boolean","isRequired":false,"description":"Optional. Boolean. `true` sends the new user an invitation email, `false` doesn't (unless the organization's user setup invites every new user). When left out, the user is invited only if the calling client application sends invitations for activated organizations and the organization is activated.\n","uniqueKey":"","typeLabel":"boolean"},"example":true}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"A new user of an organization. The properties have the same names and formats as in the list response, so a listed user can be posted as is: `null` for an optional property means it isn't set, and the read-only properties `id`, `lastInvitationDate` and `dateCreated` are ignored. `email`, `firstName`, `lastName`, `externalSourceId`, `employeeId`, `title`, `mobilePhone` and `bankAccountNumber` can be at most 255 characters long after leading and trailing whitespace is removed, and a text dimension's `presetStringValue` at most 255 characters; a longer value is rejected with 400 `FIELD_EXCEEDS_MAX_LENGTH`. Unless a property states otherwise, the other string properties have no validated length or pattern.\n","required":["email","firstName","lastName"],"properties":{"email":{"type":"string","maxLength":255,"format":"email","description":"Required. String. The user's email address, also used to log in. No other user of the organization may have it; a deleted user's email address can be reused. At most 255 characters after leading and trailing whitespace is removed, otherwise 400 `FIELD_EXCEEDS_MAX_LENGTH`.\n","isRequired":true,"uniqueKey":"email","typeLabel":"string\u003cemail>"},"firstName":{"type":"string","maxLength":255,"description":"Required. String. The user's first name. At most 255 characters after leading and trailing whitespace is removed, otherwise 400 `FIELD_EXCEEDS_MAX_LENGTH`.\n","isRequired":true,"uniqueKey":"firstName","typeLabel":"string"},"lastName":{"type":"string","maxLength":255,"description":"Required. String. The user's last name. At most 255 characters after leading and trailing whitespace is removed, otherwise 400 `FIELD_EXCEEDS_MAX_LENGTH`.\n","isRequired":true,"uniqueKey":"lastName","typeLabel":"string"},"externalSourceId":{"oneOf":[{"type":"string","maxLength":255,"description":"Optional. String. Identifier of the user in an external system. No other user of the organization may have it. At most 255 characters after leading and trailing whitespace is removed, otherwise 400 `FIELD_EXCEEDS_MAX_LENGTH`.\n","uniqueKey":"externalSourceId.oneOf.0","typeLabel":"string"},{"type":"null","maxLength":255,"description":"Optional. String. Identifier of the user in an external system. No other user of the organization may have it. At most 255 characters after leading and trailing whitespace is removed, otherwise 400 `FIELD_EXCEEDS_MAX_LENGTH`.\n","uniqueKey":"externalSourceId.oneOf.1","typeLabel":"null"}],"uniqueKey":"externalSourceId","typeLabel":"string | null"},"employeeId":{"oneOf":[{"type":"string","maxLength":255,"description":"Optional. String. The user's employee number in the organization. No other user of the organization may have it. At most 255 characters after leading and trailing whitespace is removed, otherwise 400 `FIELD_EXCEEDS_MAX_LENGTH`.\n","uniqueKey":"employeeId.oneOf.0","typeLabel":"string"},{"type":"null","maxLength":255,"description":"Optional. String. The user's employee number in the organization. No other user of the organization may have it. At most 255 characters after leading and trailing whitespace is removed, otherwise 400 `FIELD_EXCEEDS_MAX_LENGTH`.\n","uniqueKey":"employeeId.oneOf.1","typeLabel":"null"}],"uniqueKey":"employeeId","typeLabel":"string | null"},"title":{"oneOf":[{"type":"string","maxLength":255,"description":"Optional. String. The user's job title. At most 255 characters after leading and trailing whitespace is removed, otherwise 400 `FIELD_EXCEEDS_MAX_LENGTH`.\n","uniqueKey":"title.oneOf.0","typeLabel":"string"},{"type":"null","maxLength":255,"description":"Optional. String. The user's job title. At most 255 characters after leading and trailing whitespace is removed, otherwise 400 `FIELD_EXCEEDS_MAX_LENGTH`.\n","uniqueKey":"title.oneOf.1","typeLabel":"null"}],"uniqueKey":"title","typeLabel":"string | null"},"mobilePhone":{"oneOf":[{"type":"string","maxLength":255,"description":"Optional. String. The user's mobile phone number in international format (e.g. `+46701234567`). At most 255 characters after leading and trailing whitespace is removed, otherwise 400 `FIELD_EXCEEDS_MAX_LENGTH`.\n","uniqueKey":"mobilePhone.oneOf.0","typeLabel":"string"},{"type":"null","maxLength":255,"description":"Optional. String. The user's mobile phone number in international format (e.g. `+46701234567`). At most 255 characters after leading and trailing whitespace is removed, otherwise 400 `FIELD_EXCEEDS_MAX_LENGTH`.\n","uniqueKey":"mobilePhone.oneOf.1","typeLabel":"null"}],"uniqueKey":"mobilePhone","typeLabel":"string | null"},"endDate":{"oneOf":[{"type":"string","format":"date-time","description":"Optional. ISO-8601 date-time in UTC (`yyyy-MM-ddTHH:mm:ssZ`). The date the user's employment ends. Can't be in the past.\n","uniqueKey":"endDate.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"Optional. ISO-8601 date-time in UTC (`yyyy-MM-ddTHH:mm:ssZ`). The date the user's employment ends. Can't be in the past.\n","uniqueKey":"endDate.oneOf.1","typeLabel":"null"}],"uniqueKey":"endDate","typeLabel":"string\u003cdate-time> | null"},"ssn":{"oneOf":[{"type":"string","description":"Optional. String. The user's personal identity number (social security number), validated for the organization's country. Stored normalized, for Swedish numbers without separator and century digits (`19121212-1212` is stored as `1212121212`). No other person may have it.\n","uniqueKey":"ssn.oneOf.0","typeLabel":"string"},{"type":"null","description":"Optional. String. The user's personal identity number (social security number), validated for the organization's country. Stored normalized, for Swedish numbers without separator and century digits (`19121212-1212` is stored as `1212121212`). No other person may have it.\n","uniqueKey":"ssn.oneOf.1","typeLabel":"null"}],"uniqueKey":"ssn","typeLabel":"string | null"},"department":{"oneOf":[{"type":"object","description":"Optional. The department (organizational unit) of the organization to place the user in, identified by either `id` or `externalSourceId`; at least one of them is required. When both are given, `id` is used.\n","required":["id"],"properties":{"id":{"oneOf":[{"type":"string","description":"String. The department's ID, as returned in `id` by the department endpoints.","isRequired":true,"uniqueKey":"department.oneOf.0.id.oneOf.0","typeLabel":"string"},{"type":"null","description":"String. The department's ID, as returned in `id` by the department endpoints.","isRequired":true,"uniqueKey":"department.oneOf.0.id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"department.oneOf.0.id","typeLabel":"string | null"},"externalSourceId":{"oneOf":[{"type":"string","description":"String. The department's `externalSourceId`, the non-empty string an integration set on it.","uniqueKey":"department.oneOf.0.externalSourceId.oneOf.0","typeLabel":"string"},{"type":"null","description":"String. The department's `externalSourceId`, the non-empty string an integration set on it.","uniqueKey":"department.oneOf.0.externalSourceId.oneOf.1","typeLabel":"null"}],"uniqueKey":"department.oneOf.0.externalSourceId","typeLabel":"string | null"}},"uniqueKey":"department.oneOf.0","typeLabel":"object"},{"type":"object","description":"Optional. The department (organizational unit) of the organization to place the user in, identified by either `id` or `externalSourceId`; at least one of them is required. When both are given, `id` is used.\n","required":["externalSourceId"],"properties":{"externalSourceId":{"oneOf":[{"type":"string","description":"String. The department's `externalSourceId`, the non-empty string an integration set on it.","isRequired":true,"uniqueKey":"department.oneOf.1.externalSourceId.oneOf.0","typeLabel":"string"},{"type":"null","description":"String. The department's `externalSourceId`, the non-empty string an integration set on it.","isRequired":true,"uniqueKey":"department.oneOf.1.externalSourceId.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"department.oneOf.1.externalSourceId","typeLabel":"string | null"},"id":{"oneOf":[{"type":"string","description":"String. The department's ID, as returned in `id` by the department endpoints.","uniqueKey":"department.oneOf.1.id.oneOf.0","typeLabel":"string"},{"type":"null","description":"String. The department's ID, as returned in `id` by the department endpoints.","uniqueKey":"department.oneOf.1.id.oneOf.1","typeLabel":"null"}],"uniqueKey":"department.oneOf.1.id","typeLabel":"string | null"}},"uniqueKey":"department.oneOf.1","typeLabel":"object"},{"type":"null","uniqueKey":"department.oneOf.2","typeLabel":"null"}],"uniqueKey":"department","typeLabel":"object · object · null"},"customDimensionPresetValues":{"oneOf":[{"type":"array","description":"Optional. Custom dimension values to preset on the user, used as defaults on the user's expenses. The other properties of a listed preset value are ignored.\n","items":{"type":"object","required":["dimensionDefinitionId"],"properties":{"dimensionDefinitionId":{"type":"string","description":"Required. String. The ID of a custom dimension definition of the organization.","isRequired":true,"uniqueKey":"customDimensionPresetValues.oneOf.0.items.[INDEX].dimensionDefinitionId","typeLabel":"string"},"presetListValueId":{"oneOf":[{"type":"string","description":"String. Required for a dimension with a list of values, the ID of one of the list's values.\n","uniqueKey":"customDimensionPresetValues.oneOf.0.items.[INDEX].presetListValueId.oneOf.0","typeLabel":"string"},{"type":"null","description":"String. Required for a dimension with a list of values, the ID of one of the list's values.\n","uniqueKey":"customDimensionPresetValues.oneOf.0.items.[INDEX].presetListValueId.oneOf.1","typeLabel":"null"}],"uniqueKey":"customDimensionPresetValues.oneOf.0.items.[INDEX].presetListValueId","typeLabel":"string | null"},"presetStringValue":{"oneOf":[{"type":"string","maxLength":255,"description":"String. For a text dimension, the preset text. At most 255 characters, counted as sent; a longer value is rejected with 400 `FIELD_EXCEEDS_MAX_LENGTH`.\n","uniqueKey":"customDimensionPresetValues.oneOf.0.items.[INDEX].presetStringValue.oneOf.0","typeLabel":"string"},{"type":"null","maxLength":255,"description":"String. For a text dimension, the preset text. At most 255 characters, counted as sent; a longer value is rejected with 400 `FIELD_EXCEEDS_MAX_LENGTH`.\n","uniqueKey":"customDimensionPresetValues.oneOf.0.items.[INDEX].presetStringValue.oneOf.1","typeLabel":"null"}],"uniqueKey":"customDimensionPresetValues.oneOf.0.items.[INDEX].presetStringValue","typeLabel":"string | null"}},"uniqueKey":"customDimensionPresetValues.oneOf.0.items.[INDEX]","typeLabel":"object"},"uniqueKey":"customDimensionPresetValues.oneOf.0","typeLabel":"object[]"},{"type":"null","description":"Optional. Custom dimension values to preset on the user, used as defaults on the user's expenses. The other properties of a listed preset value are ignored.\n","items":{"type":"object","required":["dimensionDefinitionId"],"properties":{"dimensionDefinitionId":{"type":"string","description":"Required. String. The ID of a custom dimension definition of the organization."},"presetListValueId":{"oneOf":[{"type":"string","description":"String. Required for a dimension with a list of values, the ID of one of the list's values.\n"},{"type":"null","description":"String. Required for a dimension with a list of values, the ID of one of the list's values.\n"}]},"presetStringValue":{"oneOf":[{"type":"string","maxLength":255,"description":"String. For a text dimension, the preset text. At most 255 characters, counted as sent; a longer value is rejected with 400 `FIELD_EXCEEDS_MAX_LENGTH`.\n"},{"type":"null","maxLength":255,"description":"String. For a text dimension, the preset text. At most 255 characters, counted as sent; a longer value is rejected with 400 `FIELD_EXCEEDS_MAX_LENGTH`.\n"}]}}},"uniqueKey":"customDimensionPresetValues.oneOf.1","typeLabel":"null"}],"uniqueKey":"customDimensionPresetValues","typeLabel":"object[] | null"},"language":{"oneOf":[{"type":"string","description":"Optional. String. The user's language and region as a locale code (`language_COUNTRY`, e.g. `en_GB`, `sv_SE`). Defaults to the organization's language.\n","uniqueKey":"language.oneOf.0","typeLabel":"string"},{"type":"null","description":"Optional. String. The user's language and region as a locale code (`language_COUNTRY`, e.g. `en_GB`, `sv_SE`). Defaults to the organization's language.\n","uniqueKey":"language.oneOf.1","typeLabel":"null"}],"uniqueKey":"language","typeLabel":"string | null"},"bankAccountNumber":{"oneOf":[{"type":"string","maxLength":255,"description":"Optional. String. The user's bank account number for reimbursements, validated for the organization's country unless the client application turns that validation off. Stored without separators (`9562-1537876` is stored as `95621537876`). At most 255 characters after leading and trailing whitespace is removed, otherwise 400 `FIELD_EXCEEDS_MAX_LENGTH`.\n","uniqueKey":"bankAccountNumber.oneOf.0","typeLabel":"string"},{"type":"null","maxLength":255,"description":"Optional. String. The user's bank account number for reimbursements, validated for the organization's country unless the client application turns that validation off. Stored without separators (`9562-1537876` is stored as `95621537876`). At most 255 characters after leading and trailing whitespace is removed, otherwise 400 `FIELD_EXCEEDS_MAX_LENGTH`.\n","uniqueKey":"bankAccountNumber.oneOf.1","typeLabel":"null"}],"uniqueKey":"bankAccountNumber","typeLabel":"string | null"},"IBAN":{"oneOf":[{"type":"string","description":"Optional. String. The user's International Bank Account Number for reimbursements. Spaces are allowed and removed; stored in upper case.\n","uniqueKey":"IBAN.oneOf.0","typeLabel":"string"},{"type":"null","description":"Optional. String. The user's International Bank Account Number for reimbursements. Spaces are allowed and removed; stored in upper case.\n","uniqueKey":"IBAN.oneOf.1","typeLabel":"null"}],"uniqueKey":"IBAN","typeLabel":"string | null"},"BIC":{"oneOf":[{"type":"string","description":"Optional. String. The Bank Identifier Code (SWIFT code) of the user's bank. Spaces are allowed and removed; stored in upper case.\n","uniqueKey":"BIC.oneOf.0","typeLabel":"string"},{"type":"null","description":"Optional. String. The Bank Identifier Code (SWIFT code) of the user's bank. Spaces are allowed and removed; stored in upper case.\n","uniqueKey":"BIC.oneOf.1","typeLabel":"null"}],"uniqueKey":"BIC","typeLabel":"string | null"},"isAdministrator":{"oneOf":[{"type":"boolean","description":"Optional. Boolean. True makes the user an administrator of the organization. Defaults to false.","uniqueKey":"isAdministrator.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"Optional. Boolean. True makes the user an administrator of the organization. Defaults to false.","uniqueKey":"isAdministrator.oneOf.1","typeLabel":"null"}],"uniqueKey":"isAdministrator","typeLabel":"boolean | null"}},"uniqueKey":"","typeLabel":"object"},"example":{"email":"erik.exempel@example.com","firstName":"Erik","lastName":"Exempel","externalSourceId":"Erik_Exempel","employeeId":"E-1001","title":"Engineering Lead","mobilePhone":"+46701740605","endDate":"2027-01-31T00:00:00Z","ssn":"19121212-1212","department":{"id":"9360d03ad7294220868d67f42a2a144d"},"customDimensionPresetValues":[{"dimensionDefinitionId":"c2a0b3f4d5e64f7a8b9c0d1e2f3a4b5c","presetStringValue":"Project X"}],"language":"en_GB","bankAccountNumber":"9562-1537876","IBAN":"SE45 5000 0000 0583 9825 7466","BIC":"ESSESESS","isAdministrator":false},"examples":{"Example":{"title":"Example","value":{"email":"erik.exempel@example.com","firstName":"Erik","lastName":"Exempel","externalSourceId":"Erik_Exempel","employeeId":"E-1001","title":"Engineering Lead","mobilePhone":"+46701740605","endDate":"2027-01-31T00:00:00Z","ssn":"19121212-1212","department":{"id":"9360d03ad7294220868d67f42a2a144d"},"customDimensionPresetValues":[{"dimensionDefinitionId":"c2a0b3f4d5e64f7a8b9c0d1e2f3a4b5c","presetStringValue":"Project X"}],"language":"en_GB","bankAccountNumber":"9562-1537876","IBAN":"SE45 5000 0000 0583 9825 7466","BIC":"ESSESESS","isAdministrator":false}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"8cee5fc4-759e-4831-a8e8-4253dda8c72c":{"description":"Created — the new user","content":{"application/json":{"schema":{"type":"object","description":"A user of an organization: a person employed by the organization. Every property is always present; properties without a value are null.\n","required":["id","externalSourceId","employeeId","title","firstName","lastName","email","mobilePhone","endDate","ssn","department","customDimensionPresetValues","language","bankAccountNumber","IBAN","BIC","lastInvitationDate","dateCreated","isAdministrator"],"properties":{"id":{"type":"string","pattern":"^[0-9a-fA-F]{32}$","description":"UUID without dashes (32-character hex string)","isRequired":true,"uniqueKey":"id","typeLabel":"string"},"externalSourceId":{"oneOf":[{"type":"string","description":"String. Identifier of the user in an external system, set by an integration. Unique within the client application. Null when not set.\n","isRequired":true,"uniqueKey":"externalSourceId.oneOf.0","typeLabel":"string"},{"type":"null","description":"String. Identifier of the user in an external system, set by an integration. Unique within the client application. Null when not set.\n","isRequired":true,"uniqueKey":"externalSourceId.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"externalSourceId","typeLabel":"string | null"},"employeeId":{"oneOf":[{"type":"string","description":"String. The user's employee number in the organization. Null when not set.","isRequired":true,"uniqueKey":"employeeId.oneOf.0","typeLabel":"string"},{"type":"null","description":"String. The user's employee number in the organization. Null when not set.","isRequired":true,"uniqueKey":"employeeId.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"employeeId","typeLabel":"string | null"},"title":{"oneOf":[{"type":"string","description":"String. The user's job title. Null when not set.","isRequired":true,"uniqueKey":"title.oneOf.0","typeLabel":"string"},{"type":"null","description":"String. The user's job title. Null when not set.","isRequired":true,"uniqueKey":"title.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"title","typeLabel":"string | null"},"firstName":{"type":"string","description":"String. The user's first name.","isRequired":true,"uniqueKey":"firstName","typeLabel":"string"},"lastName":{"type":"string","description":"String. The user's last name.","isRequired":true,"uniqueKey":"lastName","typeLabel":"string"},"email":{"type":"string","format":"email","description":"String. The user's email address, also used to log in.","isRequired":true,"uniqueKey":"email","typeLabel":"string\u003cemail>"},"mobilePhone":{"oneOf":[{"type":"string","description":"String. The user's mobile phone number as entered, usually in international format (e.g. `+46701234567`). Null when not set.\n","isRequired":true,"uniqueKey":"mobilePhone.oneOf.0","typeLabel":"string"},{"type":"null","description":"String. The user's mobile phone number as entered, usually in international format (e.g. `+46701234567`). Null when not set.\n","isRequired":true,"uniqueKey":"mobilePhone.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"mobilePhone","typeLabel":"string | null"},"endDate":{"oneOf":[{"type":"string","format":"date-time","description":"ISO-8601 date-time in UTC (`yyyy-MM-ddTHH:mm:ssZ`). The date the user's employment ends. Null when the employment has no end date.\n","isRequired":true,"uniqueKey":"endDate.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"ISO-8601 date-time in UTC (`yyyy-MM-ddTHH:mm:ssZ`). The date the user's employment ends. Null when the employment has no end date.\n","isRequired":true,"uniqueKey":"endDate.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"endDate","typeLabel":"string\u003cdate-time> | null"},"ssn":{"oneOf":[{"type":"string","description":"String. The user's personal identity number (social security number), as stored. A number entered by the user is stored normalized, for Swedish numbers without separator and century digits (e.g. `1212121212`). Null when not set.\n","isRequired":true,"uniqueKey":"ssn.oneOf.0","typeLabel":"string"},{"type":"null","description":"String. The user's personal identity number (social security number), as stored. A number entered by the user is stored normalized, for Swedish numbers without separator and century digits (e.g. `1212121212`). Null when not set.\n","isRequired":true,"uniqueKey":"ssn.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"ssn","typeLabel":"string | null"},"department":{"oneOf":[{"type":"object","description":"The department (organizational unit) the user belongs to. Null when the user is not placed in a department.","required":["id","externalSourceId"],"properties":{"id":{"type":"string","description":"String. The department's ID, as returned in `id` by the department endpoints.","isRequired":true,"uniqueKey":"department.oneOf.0.id","typeLabel":"string"},"externalSourceId":{"oneOf":[{"type":"string","description":"String. Identifier of the department in an external system, set by an integration. Null when not set.","isRequired":true,"uniqueKey":"department.oneOf.0.externalSourceId.oneOf.0","typeLabel":"string"},{"type":"null","description":"String. Identifier of the department in an external system, set by an integration. Null when not set.","isRequired":true,"uniqueKey":"department.oneOf.0.externalSourceId.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"department.oneOf.0.externalSourceId","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"department.oneOf.0","typeLabel":"object"},{"type":"null","description":"The department (organizational unit) the user belongs to. Null when the user is not placed in a department.","required":["id","externalSourceId"],"properties":{"id":{"type":"string","description":"String. The department's ID, as returned in `id` by the department endpoints."},"externalSourceId":{"oneOf":[{"type":"string","description":"String. Identifier of the department in an external system, set by an integration. Null when not set."},{"type":"null","description":"String. Identifier of the department in an external system, set by an integration. Null when not set."}]}},"isRequired":true,"uniqueKey":"department.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"department","typeLabel":"object | null"},"customDimensionPresetValues":{"type":"array","description":"Custom dimension values preset on the user, used as defaults on the user's expenses. Excludes values belonging to deleted dimension definitions. Empty when none are set.\n","items":{"type":"object","required":["id","dimensionDefinitionId"],"properties":{"id":{"type":"string","description":"Unique identifier of the preset value.","isRequired":true,"uniqueKey":"customDimensionPresetValues.items.[INDEX].id","typeLabel":"string"},"dimensionDefinitionId":{"type":"string","description":"The ID of the custom dimension definition this preset value belongs to.","isRequired":true,"uniqueKey":"customDimensionPresetValues.items.[INDEX].dimensionDefinitionId","typeLabel":"string"},"presetListValueId":{"oneOf":[{"type":"string","description":"The ID of the selected list value, when the dimension uses a list of values. Null when a free-text preset is used instead.","uniqueKey":"customDimensionPresetValues.items.[INDEX].presetListValueId.oneOf.0","typeLabel":"string"},{"type":"null","description":"The ID of the selected list value, when the dimension uses a list of values. Null when a free-text preset is used instead.","uniqueKey":"customDimensionPresetValues.items.[INDEX].presetListValueId.oneOf.1","typeLabel":"null"}],"uniqueKey":"customDimensionPresetValues.items.[INDEX].presetListValueId","typeLabel":"string | null"},"presetListValueText":{"oneOf":[{"type":"string","description":"Display text of the selected list value. Null when a free-text preset is used instead.","uniqueKey":"customDimensionPresetValues.items.[INDEX].presetListValueText.oneOf.0","typeLabel":"string"},{"type":"null","description":"Display text of the selected list value. Null when a free-text preset is used instead.","uniqueKey":"customDimensionPresetValues.items.[INDEX].presetListValueText.oneOf.1","typeLabel":"null"}],"uniqueKey":"customDimensionPresetValues.items.[INDEX].presetListValueText","typeLabel":"string | null"},"presetStringValue":{"oneOf":[{"type":"string","description":"Free-text preset value, when the dimension does not use a list of values. Null when a list value is used instead.","uniqueKey":"customDimensionPresetValues.items.[INDEX].presetStringValue.oneOf.0","typeLabel":"string"},{"type":"null","description":"Free-text preset value, when the dimension does not use a list of values. Null when a list value is used instead.","uniqueKey":"customDimensionPresetValues.items.[INDEX].presetStringValue.oneOf.1","typeLabel":"null"}],"uniqueKey":"customDimensionPresetValues.items.[INDEX].presetStringValue","typeLabel":"string | null"}},"uniqueKey":"customDimensionPresetValues.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"customDimensionPresetValues","typeLabel":"object[]"},"language":{"oneOf":[{"type":"string","description":"String. The user's language and region as a locale code (`language_COUNTRY`, e.g. `en_GB`, `sv_SE`). Null when the user has not chosen a language, in which case the organization's language applies.\n","isRequired":true,"uniqueKey":"language.oneOf.0","typeLabel":"string"},{"type":"null","description":"String. The user's language and region as a locale code (`language_COUNTRY`, e.g. `en_GB`, `sv_SE`). Null when the user has not chosen a language, in which case the organization's language applies.\n","isRequired":true,"uniqueKey":"language.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"language","typeLabel":"string | null"},"bankAccountNumber":{"oneOf":[{"type":"string","description":"String. The user's bank account number for reimbursements. Null when not set.","isRequired":true,"uniqueKey":"bankAccountNumber.oneOf.0","typeLabel":"string"},{"type":"null","description":"String. The user's bank account number for reimbursements. Null when not set.","isRequired":true,"uniqueKey":"bankAccountNumber.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"bankAccountNumber","typeLabel":"string | null"},"IBAN":{"oneOf":[{"type":"string","description":"String. The user's International Bank Account Number for reimbursements. Null when not set.","isRequired":true,"uniqueKey":"IBAN.oneOf.0","typeLabel":"string"},{"type":"null","description":"String. The user's International Bank Account Number for reimbursements. Null when not set.","isRequired":true,"uniqueKey":"IBAN.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"IBAN","typeLabel":"string | null"},"BIC":{"oneOf":[{"type":"string","description":"String. The Bank Identifier Code (SWIFT code) of the user's bank. Null when not set.","isRequired":true,"uniqueKey":"BIC.oneOf.0","typeLabel":"string"},{"type":"null","description":"String. The Bank Identifier Code (SWIFT code) of the user's bank. Null when not set.","isRequired":true,"uniqueKey":"BIC.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"BIC","typeLabel":"string | null"},"lastInvitationDate":{"oneOf":[{"type":"string","format":"date-time","description":"ISO-8601 date-time in UTC (`yyyy-MM-ddTHH:mm:ssZ`). When the user was last sent an invitation email. Null when the user has not been invited, or has since activated their account.\n","isRequired":true,"uniqueKey":"lastInvitationDate.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"ISO-8601 date-time in UTC (`yyyy-MM-ddTHH:mm:ssZ`). When the user was last sent an invitation email. Null when the user has not been invited, or has since activated their account.\n","isRequired":true,"uniqueKey":"lastInvitationDate.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"lastInvitationDate","typeLabel":"string\u003cdate-time> | null"},"dateCreated":{"type":"string","format":"date-time","description":"ISO-8601 date-time in UTC (`yyyy-MM-ddTHH:mm:ssZ`). When the user was added to the organization.","isRequired":true,"uniqueKey":"dateCreated","typeLabel":"string\u003cdate-time>"},"isAdministrator":{"type":"boolean","description":"Boolean. True when the user is an administrator of the organization.","isRequired":true,"uniqueKey":"isAdministrator","typeLabel":"boolean"}},"uniqueKey":"","typeLabel":"object"},"example":{"id":"8a66aa549e6a3672019e73b79f8e1a7f","externalSourceId":"Erik_Exempel","employeeId":"E-1001","title":"Engineering Lead","firstName":"Erik","lastName":"Exempel","email":"erik.exempel@example.com","mobilePhone":"+46701740605","endDate":"2027-01-31T00:00:00Z","ssn":"1212121212","department":{"id":"9360d03ad7294220868d67f42a2a144d","externalSourceId":null},"customDimensionPresetValues":[{"id":"5d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5a","dimensionDefinitionId":"c2a0b3f4d5e64f7a8b9c0d1e2f3a4b5c","presetListValueId":null,"presetListValueText":null,"presetStringValue":"Project X"}],"language":"en_GB","bankAccountNumber":"95621537876","IBAN":"SE4550000000058398257466","BIC":"ESSESESS","lastInvitationDate":null,"dateCreated":"2026-10-13T12:31:14Z","isAdministrator":false},"examples":{"Example":{"title":"Example","value":{"id":"8a66aa549e6a3672019e73b79f8e1a7f","externalSourceId":"Erik_Exempel","employeeId":"E-1001","title":"Engineering Lead","firstName":"Erik","lastName":"Exempel","email":"erik.exempel@example.com","mobilePhone":"+46701740605","endDate":"2027-01-31T00:00:00Z","ssn":"1212121212","department":{"id":"9360d03ad7294220868d67f42a2a144d","externalSourceId":null},"customDimensionPresetValues":[{"id":"5d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5a","dimensionDefinitionId":"c2a0b3f4d5e64f7a8b9c0d1e2f3a4b5c","presetListValueId":null,"presetListValueText":null,"presetStringValue":"Project X"}],"language":"en_GB","bankAccountNumber":"95621537876","IBAN":"SE4550000000058398257466","BIC":"ESSESESS","lastInvitationDate":null,"dateCreated":"2026-10-13T12:31:14Z","isAdministrator":false}}},"exampleType":"examples"}},"exampleType":"examples"},"9ab10311-73e8-4e79-b49f-097af1932a81":{"description":"Bad request — the body is invalid, a string property is longer than 255 characters, or the user already exists in the organization. When the users import rejects the email, ssn or mobile phone, the response is `FAILED_TO_ADD_PERSON_WITH_EMAIL` with the fixed description `validationErrors` and the posted email in `data.email`; it doesn't say which field failed.\n","content":{"application/json":{"schema":{"type":"object","properties":{"result":{"type":"string","uniqueKey":"result","typeLabel":"string"},"code":{"type":"string","uniqueKey":"code","typeLabel":"string"},"description":{"type":"string","uniqueKey":"description","typeLabel":"string"},"data":{"type":"object","description":"Only present for `FAILED_TO_ADD_PERSON_WITH_EMAIL`, where it holds the email address of the user that could not be added.\n","properties":{"email":{"type":"string","format":"email","uniqueKey":"data.email","typeLabel":"string\u003cemail>"}},"uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Missing required property":{"title":"Missing required property","value":{"result":"error","code":"INVALID_JSON_PROPERTY_VALUE","description":"firstName is required"}},"Value too long":{"title":"Value too long","value":{"result":"error","code":"FIELD_EXCEEDS_MAX_LENGTH","description":"title exceeds maximum length of 255 characters."}},"User already exists":{"title":"User already exists","value":{"result":"error","code":"EMPLOYEE_ALREADY_EXISTS","description":"The employee ID already exists."}},"Employee ID already used":{"title":"Employee ID already used","value":{"result":"error","code":"EMPLOYEE_ID_ALREADY_TAKEN","description":"Cannot set employeeId E-1001, it's already used in this organization"}},"Invalid end date":{"title":"Invalid end date","value":{"result":"error","code":"INVALID_DATE","description":"Invalid date. Please verify it."}},"Unknown language":{"title":"Unknown language","value":{"result":"error","code":"INVALID_LANGUAGE","description":"Unknown language: xx_XX"}},"Unknown department":{"title":"Unknown department","value":{"result":"error","code":"INVALID_JSON_PROPERTY_VALUE","description":"Department not found"}},"Unknown dimension":{"title":"Unknown dimension","value":{"result":"error","code":"INVALID_JSON_PROPERTY_VALUE","description":"Dimension not found: c2a0b3f4d5e64f7a8b9c0d1e2f3a4b5c"}},"Invalid IBAN":{"title":"Invalid IBAN","value":{"result":"error","code":"INVALID_JSON_PROPERTY_VALUE","description":"Invalid IBAN"}},"Invalid bank account number":{"title":"Invalid bank account number","value":{"result":"error","code":"INVALID_JSON_PROPERTY_VALUE","description":"Invalid bankAccountNumber for country SE"}},"Invalid email, ssn or mobile phone":{"title":"Invalid email, ssn or mobile phone","value":{"result":"error","code":"FAILED_TO_ADD_PERSON_WITH_EMAIL","description":"validationErrors","data":{"email":"erik.exempel@example.com"}}},"Malformed body":{"title":"Malformed body","value":{"result":"error","code":"INVALID_JSON_BODY","description":"Could not parse JSON content."}},"No known properties":{"title":"No known properties","value":{"result":"error","code":"NO_KNOWN_JSON_PROPERTIES","description":"No known, or only read-only properties received"}}},"exampleType":"examples"}},"exampleType":"examples"},"fc05313c-52ae-4e7c-aea5-8e25426b4a3b":{"description":"Not found — the organization does not exist, can't have users, or the authenticated user is not an administrator of it\n","content":{"application/json":{"schema":{"type":"object","properties":{"result":{"type":"string","uniqueKey":"result","typeLabel":"string"},"code":{"type":"string","uniqueKey":"code","typeLabel":"string"},"description":{"type":"string","uniqueKey":"description","typeLabel":"string"}},"example":{"result":"error","code":"ORGANIZATION_NOT_FOUND","description":"Failed to get organization for id: {orgId}"},"uniqueKey":"","typeLabel":"object"},"examples":{"Organization not found":{"title":"Organization not found","value":{"result":"error","code":"ORGANIZATION_NOT_FOUND","description":"Organization not found for id='no-such-organization'"}},"No access to the organization":{"title":"No access to the organization","value":{"result":"error","code":"ORGANIZATION_NOT_FOUND","description":"Organization not found"}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"36ed4beb-c007-434b-9804-ba9ed346c7c5":{"bearerAuth":{"type":"http","scheme":"bearer","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"20e34eef-9d99-4fd5-8bde-c32926c8074a":{"url":"https://stage-api.findity.com/api/v1/admin"},"c1d55a91-917d-47ca-82f3-a7c42140cdea":{"url":"https://api.findity.com/api/v1/admin"}},"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":"openapi/findity-admin-api.json"},"subdomain":"findity-docs","siteName":"Findity Docs","title":"Create user - Findity Docs","contextualStarterQuestions":[],"navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"originalFileLocation":"reference/admin/users/create-user.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=\"light\";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=\"light\"}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 a new user to the given organization and returns it as the list returns it. The user is created the same way as by the users import: a new person gets a pending account (or the status the organization\u0026#x27;s user setup prescribes), the organization\u0026#x27;s default language and country, and the license and employee-group defaults of the organization. No other user of the organization may have the same email, externalSourceId or employeeId; this endpoint never updates an existing user. When the client application shares person data across organizations, the email also can\u0026#x27;t belong to a person employed in another organization. Unknown departments, dimensions, dimension values and languages, and invalid bank account numbers, IBAN or BIC values are rejected instead of ignored. The person\u0026#x27;s address country is the organization\u0026#x27;s country; ssn and bankAccountNumber are validated for it. The user gets an invitation email when sendInvitationMail is true. When sendInvitationMail is left out, the user is invited if the calling client application sends invitations for activated organizations and the organization is activated. An organization whose user setup sends invitations to every new user invites them even when sendInvitationMail is false. Returns 404 when the organization does not exist, can\u0026#x27;t have users, or the authenticated user is not an administrator of it, so a caller cannot tell an organization they lack access to from a missing one.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Findity Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003cmeta data-mint-head name=\"robots\" content=\"noindex\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/findity-docs/qh6qZo-BejSNhjrJ/_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/findity-docs/qh6qZo-BejSNhjrJ/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/findity-docs/qh6qZo-BejSNhjrJ/_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/findity-docs/qh6qZo-BejSNhjrJ/_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/findity-docs/qh6qZo-BejSNhjrJ/_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/findity-docs/qh6qZo-BejSNhjrJ/_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/findity-docs/qh6qZo-BejSNhjrJ/_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/findity-docs/qh6qZo-BejSNhjrJ/_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/findity-docs/qh6qZo-BejSNhjrJ/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create user - Findity Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Adds a new user to the given organization and returns it as the list returns it. The user is created the same way as by the users import: a new person gets a pending account (or the status the organization\u0026#x27;s user setup prescribes), the organization\u0026#x27;s default language and country, and the license and employee-group defaults of the organization. No other user of the organization may have the same email, externalSourceId or employeeId; this endpoint never updates an existing user. When the client application shares person data across organizations, the email also can\u0026#x27;t belong to a person employed in another organization. Unknown departments, dimensions, dimension values and languages, and invalid bank account numbers, IBAN or BIC values are rejected instead of ignored. The person\u0026#x27;s address country is the organization\u0026#x27;s country; ssn and bankAccountNumber are validated for it. The user gets an invitation email when sendInvitationMail is true. When sendInvitationMail is left out, the user is invited if the calling client application sends invitations for activated organizations and the organization is activated. An organization whose user setup sends invitations to every new user invites them even when sendInvitationMail is false. Returns 404 when the organization does not exist, can\u0026#x27;t have users, or the authenticated user is not an administrator of it, so a caller cannot tell an organization they lack access to from a missing one.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Findity Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://developer.findity.com/reference/admin/users/create-user\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://findity-docs.mintlify.site/_mintlify/api/og/v2?division=Users\u0026amp;title=Create+user\u0026amp;description=Adds+a+new+user+to+the+given+organization+and+returns+it+as+the+list+returns+it.+The+user+is+created+the+same+way+as+by+the+users+import%3A+a+new+person+gets+a+pe\u0026amp;theme=6ceb2538bf2cc0b72c46e477\u0026amp;signature=324c3c6ebe08f9353cc6f05e97582689378e13ed2fe3592d57ea2e76ea573762\">\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=\"Create user - Findity Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Adds a new user to the given organization and returns it as the list returns it. The user is created the same way as by the users import: a new person gets a pending account (or the status the organization\u0026#x27;s user setup prescribes), the organization\u0026#x27;s default language and country, and the license and employee-group defaults of the organization. No other user of the organization may have the same email, externalSourceId or employeeId; this endpoint never updates an existing user. When the client application shares person data across organizations, the email also can\u0026#x27;t belong to a person employed in another organization. Unknown departments, dimensions, dimension values and languages, and invalid bank account numbers, IBAN or BIC values are rejected instead of ignored. The person\u0026#x27;s address country is the organization\u0026#x27;s country; ssn and bankAccountNumber are validated for it. The user gets an invitation email when sendInvitationMail is true. When sendInvitationMail is left out, the user is invited if the calling client application sends invitations for activated organizations and the organization is activated. An organization whose user setup sends invitations to every new user invites them even when sendInvitationMail is false. Returns 404 when the organization does not exist, can\u0026#x27;t have users, or the authenticated user is not an administrator of it, so a caller cannot tell an organization they lack access to from a missing one.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://findity-docs.mintlify.site/_mintlify/api/og/v2?division=Users\u0026amp;title=Create+user\u0026amp;description=Adds+a+new+user+to+the+given+organization+and+returns+it+as+the+list+returns+it.+The+user+is+created+the+same+way+as+by+the+users+import%3A+a+new+person+gets+a+pe\u0026amp;theme=6ceb2538bf2cc0b72c46e477\u0026amp;signature=324c3c6ebe08f9353cc6f05e97582689378e13ed2fe3592d57ea2e76ea573762\">\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/findity-docs/qh6qZo-BejSNhjrJ/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Findity Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#012A2D\">\u003clink data-mint-head rel=\"canonical\" href=\"https://developer.findity.com/reference/admin/users/create-user\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/reference/admin/users/create-user.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://developer.findity.com/#organization\",\"name\":\"Findity Docs\",\"url\":\"https://developer.findity.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/findity-docs/fTsgC-3N_Y6D9oSZ/images/logo/light.avif?fit=max\u0026auto=format\u0026n=fTsgC-3N_Y6D9oSZ\u0026q=85\u0026s=b7bba7599b80f1ac5c6454a26179858b\"}},{\"@type\":\"WebSite\",\"@id\":\"https://developer.findity.com#website\",\"name\":\"Findity Docs\",\"url\":\"https://developer.findity.com\",\"publisher\":{\"@id\":\"https://developer.findity.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://developer.findity.com/reference/admin/users/create-user#webpage\",\"url\":\"https://developer.findity.com/reference/admin/users/create-user\",\"name\":\"Create user\",\"description\":\"Adds a new user to the given organization and returns it as the list returns it. The user is created the same way as by the users import: a new person gets a pending account (or the status the organization's user setup prescribes), the organization's default language and country, and the license and employee-group defaults of the organization. No other user of the organization may have the same email, externalSourceId or employeeId; this endpoint never updates an existing user. When the client application shares person data across organizations, the email also can't belong to a person employed in another organization. Unknown departments, dimensions, dimension values and languages, and invalid bank account numbers, IBAN or BIC values are rejected instead of ignored. The person's address country is the organization's country; ssn and bankAccountNumber are validated for it. The user gets an invitation email when sendInvitationMail is true. When sendInvitationMail is left out, the user is invited if the calling client application sends invitations for activated organizations and the organization is activated. An organization whose user setup sends invitations to every new user invites them even when sendInvitationMail is false. Returns 404 when the organization does not exist, can't have users, or the authenticated user is not an administrator of it, so a caller cannot tell an organization they lack access to from a missing one.\",\"isPartOf\":{\"@id\":\"https://developer.findity.com#website\"},\"breadcrumb\":{\"@id\":\"https://developer.findity.com/reference/admin/users/create-user#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://developer.findity.com/reference/admin/users/create-user#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Findity Admin API\",\"item\":\"https://developer.findity.com/reference/admin/organizations/list-organizations\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Users\",\"item\":\"https://developer.findity.com/reference/admin/users/list-users\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Create user\",\"item\":\"https://developer.findity.com/reference/admin/users/create-user\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://developer.findity.com/reference/admin/users/create-user#apireference\",\"headline\":\"Create user\",\"name\":\"Create user\",\"description\":\"Adds a new user to the given organization and returns it as the list returns it. The user is created the same way as by the users import: a new person gets a pending account (or the status the organization's user setup prescribes), the organization's default language and country, and the license and employee-group defaults of the organization. No other user of the organization may have the same email, externalSourceId or employeeId; this endpoint never updates an existing user. When the client application shares person data across organizations, the email also can't belong to a person employed in another organization. Unknown departments, dimensions, dimension values and languages, and invalid bank account numbers, IBAN or BIC values are rejected instead of ignored. The person's address country is the organization's country; ssn and bankAccountNumber are validated for it. The user gets an invitation email when sendInvitationMail is true. When sendInvitationMail is left out, the user is invited if the calling client application sends invitations for activated organizations and the organization is activated. An organization whose user setup sends invitations to every new user invites them even when sendInvitationMail is false. Returns 404 when the organization does not exist, can't have users, or the authenticated user is not an administrator of it, so a caller cannot tell an organization they lack access to from a missing one.\",\"url\":\"https://developer.findity.com/reference/admin/users/create-user\",\"mainEntityOfPage\":{\"@id\":\"https://developer.findity.com/reference/admin/users/create-user#webpage\"},\"publisher\":{\"@id\":\"https://developer.findity.com/#organization\"},\"isPartOf\":{\"@id\":\"https://developer.findity.com#website\"}}]}\u003c/script>","siteName":"Findity Docs","nav":{"global":null,"tabs":[{"tab":"Guides","icon":"book-open","pages":[{"title":"Guides","href":"/docs/welcome"}]},{"tab":"API Reference","icon":"code","pages":[{"group":"Authentication","pages":[{"group":"Token","pages":[{"title":"Request access token","deprecated":null,"version":null,"openapi":"/openapi/authentication.json post /oauth/token","href":"/reference/authentication/token/request-access-token"},{"title":"Revoke token","deprecated":null,"version":null,"openapi":"/openapi/authentication.json post /oauth/revoke","href":"/reference/authentication/token/revoke-token"},{"title":"Create authorization for a user","deprecated":null,"version":null,"openapi":"/openapi/authentication.json post /oauth/authorization-grant","href":"/reference/authentication/token/create-authorization-for-a-user"}]},{"title":"Whitelist of IP addresses","href":"/reference/whitelist-of-ip-addresses"}]},{"group":"Findity Expense API","pages":[{"group":"User","root":{"title":"User","href":"/reference/user"},"pages":[{"title":"Get logged in user","deprecated":null,"version":null,"openapi":"/openapi/findity-expense-api.json get /me","href":"/reference/expense/user/get-logged-in-user"},{"title":"Update logged in user","deprecated":null,"version":null,"openapi":"/openapi/findity-expense-api.json put /me","href":"/reference/expense/user/update-logged-in-user"},{"title":"Update logged in user using fields structure","deprecated":null,"version":null,"openapi":"/openapi/findity-expense-api.json put /me?format=fields","href":"/reference/expense/user/update-logged-in-user-using-fields-structure"},{"title":"Get user profile image","deprecated":null,"version":null,"openapi":"/openapi/findity-expense-api.json get /me/profileimage","href":"/reference/expense/user/get-user-profile-image"},{"title":"Upload user profile image","deprecated":null,"version":null,"openapi":"/openapi/findity-expense-api.json put /me/profileimage","href":"/reference/expense/user/upload-user-profile-image"},{"title":"Delete user profile image","deprecated":null,"version":null,"openapi":"/openapi/findity-expense-api.json delete /me/profileimage","href":"/reference/expense/user/delete-user-profile-image"},{"title":"Change email or verify code","deprecated":null,"version":null,"openapi":"/openapi/findity-expense-api.json post /me/email","href":"/reference/expense/user/change-email-or-verify-code"},{"title":"Change phone or verify code","deprecated":null,"version":null,"openapi":"/openapi/findity-expense-api.json post /me/phone","href":"/reference/expense/user/change-phone-or-verify-code"},{"title":"Deletes the users phone number","deprecated":null,"version":null,"openapi":"/openapi/findity-expense-api.json delete /me/phone","href":"/reference/expense/user/deletes-the-users-phone-number"},{"title":"Update password of logged in user","deprecated":null,"version":null,"openapi":"/openapi/findity-expense-api.json post /me/password","href":"/reference/expense/user/update-password-of-logged-in-user"},{"title":"Get user extra recipients","deprecated":null,"version":null,"openapi":"/openapi/findity-expense-api.json get /me/extrarecipients","href":"/reference/expense/user/get-user-extra-recipients"},{"title":"Add extra recipient email or verify code","deprecated":null,"version":null,"openapi":"/openapi/findity-expense-api.json post /me/extrarecipients","href":"/reference/expense/user/add-extra-recipient-email-or-verify-code"},{"title":"Get counters for all organizations that user belongs to","deprecated":null,"version":null,"openapi":"/openapi/findity-expense-api.json get /me/counters","href":"/reference/expense/user/get-counters-for-all-organizations-that-user-belongs-to"},{"title":"Deletes an extra recipient","deprecated":null,"version":null,"openapi":"/openapi/findity-expense-api.json delete /me/extrarecipients/{extraRecipientId}","href":"/reference/expense/user/deletes-an-extra-recipient"},{"title":"Fetch user settings in fields format","deprecated":null,"version":null,"openapi":"/openapi/findity-expense-api.json get /me/settings/fields","href":"/reference/expense/user/fetch-user-settings-in-fields-format"},{"title":"Transient update of user settings in fields format","deprecated":null,"version":null,"openapi":"/openapi/findity-expense-api.json put /me/settings/fields","href":"/reference/expense/user/transient-update-of-user-settings-in-fields-format"}]},{"group":"Organizations","pages":[{"title":"Get user organizations","deprecated":null,"version":null,"openapi":"/openapi/findity-expense-api.json get /me/organizations","href":"/reference/expense/organizations/get-user-organizations"},{"title":"Get a user organization","deprecated":null,"version":null,"openapi":"/openapi/findity-expense-api.json get /me/organizations/{id}","href":"/reference/expense/organizations/get-a-user-organization"},{"title":"Search chart of accounts","deprecated":null,"version":null,"openapi":"/openapi/findity-expense-api.json get /me/organizations/{id}/accounts","href":"/reference/expense/organizations/search-chart-of-accounts"},{"title":"List organizations with approver role","deprecated":null,"version":null,"openapi":"/openapi/findity-expense-api.json get /me/organizations/approvals","href":"/reference/expense/organizations/list-organizations-with-approver-role"},{"title":"Search temporary approver candidates","deprecated":null,"version":null,"openapi":"/openapi/findity-expense-api.json get /me/organizations/{id}/approvals/users","href":"/reference/expense/organizations/search-temporary-approver-candidates"},{"title":"Search card liabilities","deprecated":null,"version":null,"openapi":"/openapi/findity-expense-api.json get /me/organizations/{id}/cardliabilitylist","href":"/reference/expense/organizations/search-card-liabilities"},{"title":"Search card owner types","deprecated":null,"version":null,"openapi":"/openapi/findity-expense-api.json get /me/organizations/{id}/cardownertypes","href":"/reference/expense/organizations/search-card-owner-types"},{"title":"Organization representation types","deprecated":null,"version":null,"openapi":"/openapi/findity-expense-api.json get /me/organizations/{id}/categories/{categoryId}/representationtypes","href":"/reference/expense/organizations/organization-representation-types"},{"title":"Organization car types","deprecated":null,"version":null,"openapi":"/openapi/findity-expense-api.json get /me/organizations/{id}/categories/{categoryId}/cartypes","href":"/reference/expense/organizations/organization-car-types"},{"title":"Search countries list","deprecated":null,"version":null,"openapi":"/openapi/findity-expense-api.json get /me/organizations/{id}/countries","href":"/reference/expense/organizations/search-countries-list"},{"title":"Search currencies list","deprecated":null,"version":null,"openapi":"/openapi/findity-expense-api.json get /me/organizations/{id}/currencies","href":"/reference/expense/organizations/search-currencies-list"},{"title":"Organization expense types","deprecated":null,"version":null,"openapi":"/openapi/findity-expense-api.json get /me/organizations/{id}/expensetypes","href":"/reference/expense/organizations/organization-expense-types"},{"title":"Organization expense type","deprecated":null,"version":null,"openapi":"/openapi/findity-expense-api.json get /me/organizations/{id}/expensetypes/{expenseType}","href":"/reference/expense/organizations/organization-expense-type"},{"title":"Organization categories","deprecated":null,"version":null,"openapi":"/openapi/findity-expense-api.json get /me/organizations/{id}/expensetypes/{expenseType}/categories","href":"/reference/expense/organizations/organization-categories"},{"title":"Search fuel types list","deprecated":null,"version":null,"openapi":"/openapi/findity-expense-api.json get /me/organizations/{id}/fueltypes","href":"/reference/expense/organizations/search-fuel-types-list"},{"title":"Search guests","deprecated":null,"version":null,"openapi":"/openapi/findity-expense-api.json get /me/organizations/{id}/guests","href":"/reference/expense/organizations/search-guests"},{"title":"Search custom field list","deprecated":null,"version":null,"openapi":"/openapi/findity-expense-api.json get /me/organizations/{id}/lists/{listkey}","href":"/reference/expense/organizations/search-custom-field-list"},{"title":"Search locales list","deprecated":null,"version":null,"openapi":"/openapi/findity-expense-api.json get /me/organizations/{id}/locales","href":"/reference/expense/organizations/search-locales-list"},{"title":"Search payment types list","deprecated":null,"version":null,"openapi":"/openapi/findity-expense-api.json get /me/organizations/{id}/paymenttypes","href":"/reference/expense/organizations/search-payment-types-list"},{"title":"Get policy document for an organization","deprecated":null,"version":null,"openapi":"/openapi/findity-expense-api.json get /me/organizations/{id}/policies/documents/{documentId}","href":"/reference/expense/organizations/get-policy-document-for-an-organization"},{"title":"Search salary types","deprecated":null,"version":null,"openapi":"/openapi/findity-expense-api.json get /me/organizations/{id}/salarytypes","href":"/reference/expense/organizations/search-salary-types"},{"title":"Search time zones list","deprecated":null,"version":null,"openapi":"/openapi/findity-expense-api.json get /me/organizations/{id}/timezones/{countryCode}","href":"/reference/expense/organizations/search-time-zones-list"},{"title":"Search commuting years list","deprecated":null,"version":null,"openapi":"/openapi/findity-expense-api.json get /me/organizations/{id}/commuting/years","href":"/reference/expense/organizations/search-commuting-years-list"},{"title":"Search commuting months list","deprecated":null,"version":null,"openapi":"/openapi/findity-expense-api.json get /me/organizations/{id}/commuting/months","href":"/reference/expense/organizations/search-commuting-months-list"},{"title":"Search commuting days list","deprecated":null,"version":null,"openapi":"/openapi/findity-expense-api.json get /me/organizations/{id}/commuting/days","href":"/reference/expense/organizations/search-commuting-days-list"}]},{"group":"Fields","pages":[{"title":"Rendering expense views","href":"/reference/rendering-expense-views"},{"title":"Field properties","href":"/reference/field-properties"},{"title":"Field types","href":"/reference/field-types"},{"title":"Expense type fields - initialize","deprecated":null,"version":null,"openapi":"/openapi/findity-expense-api.json get /me/organizations/{id}/expensetypes/{expenseType}/fields","href":"/reference/expense/fields/expense-type-fields--initialize"},{"title":"Expense type fields - update","deprecated":null,"version":null,"openapi":"/openapi/findity-expense-api.json put /me/organizations/{id}/expensetypes/{expenseType}/fields","href":"/reference/expense/fields/expense-type-fields--update"},{"title":"Approval expense fields - initialize","deprecated":null,"version":null,"openapi":"/openapi/findity-expense-api.json get /me/organizations/{id}/approvals/expense/{expenseId}/fields","href":"/reference/expense/fields/approval-expense-fields--initialize"},{"title":"Expense report fields - initialize","deprecated":null,"version":null,"openapi":"/openapi/findity-expense-api.json get /me/organizations/{id}/expensereports/fields","href":"/reference/expense/fields/expense-report-fields--initialize"},{"title":"Expense report fields - update","deprecated":null,"version":null,"openapi":"/openapi/findity-expense-api.json put /me/organizations/{id}/expensereports/fields","href":"/reference/expense/fields/expense-report-fields--update"},{"title":"Approval expense report fields - initialize","deprecated":null,"version":null,"openapi":"/openapi/findity-expense-api.json get /me/organizations/{id}/approvals/expensereports/{expenseReportId}/fields","href":"/reference/expense/fields/approval-expense-report-fields--initialize"},{"title":"Create expense report (fields format of expense report)","deprecated":null,"version":null,"openapi":"/openapi/findity-expense-api.json post /expensereports?format=fields","href":"/reference/expense/fields/create-expense-report-fields-format-of-expense-report"},{"title":"Update expense report (fields format of expense report)","deprecated":null,"version":null,"openapi":"/openapi/findity-expense-api.json put /expensereports/{expenseReportId}?format=fields","href":"/reference/expense/fields/update-expense-report-fields-format-of-expense-report"}]},{"title":"Overview","href":"/reference/overview-1"},{"title":"Global query parameters","href":"/reference/global-query-parameters"},{"group":"Expenses","pages":[{"title":"List expenses","deprecated":null,"version":null,"openapi":"/openapi/findity-expense-api.json get /expenses","href":"/reference/expense/expenses/list-expenses"},{"title":"Create a new expense","deprecated":null,"version":null,"openapi":"/openapi/findity-expense-api.json post /expenses","href":"/reference/expense/expenses/create-a-new-expense"},{"title":"Create a new expense (fields format of expense record)","deprecated":null,"version":null,"openapi":"/openapi/findity-expense-api.json post /expenses?format=fields","href":"/reference/expense/expenses/create-a-new-expense-fields-format-of-expense-record"},{"title":"Get expense","deprecated":null,"version":null,"openapi":"/openapi/findity-expense-api.json get /expenses/{expenseId}","href":"/reference/expense/expenses/get-expense"},{"title":"Update expense","deprecated":null,"version":null,"openapi":"/openapi/findity-expense-api.json put /expenses/{expenseId}","href":"/reference/expense/expenses/update-expense"},{"title":"Delete expense","deprecated":null,"version":null,"openapi":"/openapi/findity-expense-api.json delete /expenses/{expenseId}","href":"/reference/expense/expenses/delete-expense"},{"title":"Update expense (fields format of expense record)","deprecated":null,"version":null,"openapi":"/openapi/findity-expense-api.json put /expenses/{expenseId}?format=fields","href":"/reference/expense/expenses/update-expense-fields-format-of-expense-record"},{"title":"Get expense image","deprecated":null,"version":null,"openapi":"/openapi/findity-expense-api.json get /expenses/{expenseId}/image","href":"/reference/expense/expenses/get-expense-image"}]},{"group":"Expense Reports","pages":[{"title":"List expense reports","deprecated":null,"version":null,"openapi":"/openapi/findity-expense-api.json get /expensereports","href":"/reference/expense/expense-reports/list-expense-reports"},{"title":"Create expense report","deprecated":null,"version":null,"openapi":"/openapi/findity-expense-api.json post /expensereports","href":"/reference/expense/expense-reports/create-expense-report"},{"title":"Get expense report","deprecated":null,"version":null,"openapi":"/openapi/findity-expense-api.json get /expensereports/{expenseReportId}","href":"/reference/expense/expense-reports/get-expense-report"},{"title":"Update expense report","deprecated":null,"version":null,"openapi":"/openapi/findity-expense-api.json put /expensereports/{expenseReportId}","href":"/reference/expense/expense-reports/update-expense-report"},{"title":"Delete expense report","deprecated":null,"version":null,"openapi":"/openapi/findity-expense-api.json delete /expensereports/{expenseReportId}","href":"/reference/expense/expense-reports/delete-expense-report"}]},{"group":"Content","pages":[{"title":"Create content","deprecated":null,"version":null,"openapi":"/openapi/findity-expense-api.json post /content","href":"/reference/expense/content/create-content"},{"title":"Get content","deprecated":null,"version":null,"openapi":"/openapi/findity-expense-api.json get /content/{id}","href":"/reference/expense/content/get-content"},{"title":"Trigger action","deprecated":null,"version":null,"openapi":"/openapi/findity-expense-api.json put /content/{id}","href":"/reference/expense/content/trigger-action"},{"title":"Delete content","deprecated":null,"version":null,"openapi":"/openapi/findity-expense-api.json delete /content/{id}","href":"/reference/expense/content/delete-content"},{"title":"Get as image","deprecated":null,"version":null,"openapi":"/openapi/findity-expense-api.json get /content/{id}/image","href":"/reference/expense/content/get-as-image"},{"title":"Get as binary","deprecated":null,"version":null,"openapi":"/openapi/findity-expense-api.json get /content/{id}/content","href":"/reference/expense/content/get-as-binary"}]},{"group":"Inbox","pages":[{"title":"List inbox items","deprecated":null,"version":null,"openapi":"/openapi/findity-expense-api.json get /me/inboxitems","href":"/reference/expense/inbox/list-inbox-items"},{"title":"Get inbox item","deprecated":null,"version":null,"openapi":"/openapi/findity-expense-api.json get /me/inboxitems/{inboxItemId}","href":"/reference/expense/inbox/get-inbox-item"},{"title":"Get inbox item attachment","deprecated":null,"version":null,"openapi":"/openapi/findity-expense-api.json get /me/inboxitems/{inboxItemId}/attachments/{attachmentId}","href":"/reference/expense/inbox/get-inbox-item-attachment"}]},{"group":"Route","pages":[{"title":"Get place suggestions","deprecated":null,"version":null,"openapi":"/openapi/findity-expense-api.json get /route/suggestions","href":"/reference/expense/route/get-place-suggestions"},{"title":"Get route directions","deprecated":null,"version":null,"openapi":"/openapi/findity-expense-api.json post /route/directions","href":"/reference/expense/route/get-route-directions"}]},{"group":"FleetManagementTrips","pages":[{"title":"List fleet management trips","deprecated":null,"version":null,"openapi":"/openapi/findity-expense-api.json get /me/organizations/{id}/categories/{categoryId}/fleetmanagementtrips","href":"/reference/expense/fleetmanagementtrips/list-fleet-management-trips"}]},{"group":"Approvals","pages":[{"title":"List approvals","deprecated":null,"version":null,"openapi":"/openapi/findity-expense-api.json get /me/organizations/{id}/approvals","href":"/reference/expense/approvals/list-approvals"},{"title":"List approvals by person","deprecated":null,"version":null,"openapi":"/openapi/findity-expense-api.json get /me/organizations/{id}/approvals/groups/person","href":"/reference/expense/approvals/list-approvals-by-person"},{"title":"Get approval for report by approvalChainId","deprecated":null,"version":null,"openapi":"/openapi/findity-expense-api.json get /me/organizations/{id}/approvals/{expenseReportId}","href":"/reference/expense/approvals/get-approval-for-report-by-approvalchainid"},{"title":"Approve or reject records in report","deprecated":null,"version":null,"openapi":"/openapi/findity-expense-api.json put /me/organizations/{id}/approvals/{expenseReportId}","href":"/reference/expense/approvals/approve-or-reject-records-in-report"},{"title":"List expense records attached to expense report for approval","deprecated":null,"version":null,"openapi":"/openapi/findity-expense-api.json get /me/organizations/{id}/approvals/{expenseReportId}/expenses","href":"/reference/expense/approvals/list-expense-records-attached-to-expense-report-for-approval"},{"title":"List next-step approvers","deprecated":null,"version":null,"openapi":"/openapi/findity-expense-api.json get /me/organizations/{id}/approvals/{expenseReportId}/approvalchains/{approvalChainId}/nextstep/approvers","href":"/reference/expense/approvals/list-next-step-approvers"}]},{"group":"Notifications","pages":[{"title":"List notifications","deprecated":null,"version":null,"openapi":"/openapi/findity-expense-api.json get /me/notifications","href":"/reference/expense/notifications/list-notifications"},{"title":"Bulk update notifications","deprecated":null,"version":null,"openapi":"/openapi/findity-expense-api.json put /me/notifications","href":"/reference/expense/notifications/bulk-update-notifications"},{"title":"Get notification","deprecated":null,"version":null,"openapi":"/openapi/findity-expense-api.json get /me/notifications/{id}","href":"/reference/expense/notifications/get-notification"},{"title":"Delete notification","deprecated":null,"version":null,"openapi":"/openapi/findity-expense-api.json delete /me/notifications/{id}","href":"/reference/expense/notifications/delete-notification"}]},{"group":"Impersonation","pages":[{"title":"Search users","deprecated":null,"version":null,"openapi":"/openapi/findity-expense-api.json get /impersonation/users/search","href":"/reference/expense/impersonation/search-users"}]},{"group":"Bulk","pages":[{"title":"Execute a batch of expense API requests","deprecated":null,"version":null,"openapi":"/openapi/findity-expense-api.json post /bulk","href":"/reference/expense/bulk/execute-a-batch-of-expense-api-requests"}]}]},{"group":"Findity Admin API","pages":[{"group":"Organizations","pages":[{"title":"List organizations","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json get /organizations","href":"/reference/admin/organizations/list-organizations"},{"title":"Create organization","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json post /organizations","href":"/reference/admin/organizations/create-organization"},{"title":"Get organization","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json get /organizations/{organizationId}","href":"/reference/admin/organizations/get-organization"},{"title":"Update organization","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json put /organizations/{organizationId}","href":"/reference/admin/organizations/update-organization"},{"title":"Delete organization","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json delete /organizations/{organizationId}","href":"/reference/admin/organizations/delete-organization"},{"title":"Get accounts","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json get /organizations/{id}/accounts","href":"/reference/admin/organizations/get-accounts"},{"title":"Create account","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json post /organizations/{id}/accounts","href":"/reference/admin/organizations/create-account"},{"title":"Get account","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json get /organizations/{id}/accounts/{accountId}","href":"/reference/admin/organizations/get-account"},{"title":"Update account","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json put /organizations/{id}/accounts/{accountId}","href":"/reference/admin/organizations/update-account"},{"title":"Delete account","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json delete /organizations/{id}/accounts/{accountId}","href":"/reference/admin/organizations/delete-account"},{"title":"Get salary types","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json get /organizations/{id}/salarytypes","href":"/reference/admin/organizations/get-salary-types"},{"title":"Create salary type","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json post /organizations/{id}/salarytypes","href":"/reference/admin/organizations/create-salary-type"},{"title":"Get salary type","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json get /organizations/{id}/salarytypes/{salaryTypeId}","href":"/reference/admin/organizations/get-salary-type"},{"title":"Update salary type","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json put /organizations/{id}/salarytypes/{salaryTypeId}","href":"/reference/admin/organizations/update-salary-type"},{"title":"Delete salary type","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json delete /organizations/{id}/salarytypes/{salaryTypeId}","href":"/reference/admin/organizations/delete-salary-type"},{"title":"Unlock locked account","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json put /organizations/{id}/users/{userId}/unlock","href":"/reference/admin/organizations/unlock-locked-account"}]},{"group":"Categories","pages":[{"title":"Get export categories","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json get /organizations/{id}/categories","href":"/reference/admin/categories/get-export-categories"},{"title":"Update expense IRIS category","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json put /expenses/iriscategories","href":"/reference/admin/categories/update-expense-iris-category"}]},{"group":"Policies","pages":[{"title":"List policy documents for an organization","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json get /organizations/{organizationId}/policies/documents","href":"/reference/admin/policies/list-policy-documents-for-an-organization"},{"title":"Get policy document","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json get /organizations/{organizationId}/policies/documents/{documentId}","href":"/reference/admin/policies/get-policy-document"},{"title":"Update policy document","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json put /organizations/{organizationId}/policies/documents/{documentId}","href":"/reference/admin/policies/update-policy-document"},{"title":"Delete policy document","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json delete /organizations/{organizationId}/policies/documents/{documentId}","href":"/reference/admin/policies/delete-policy-document"}]},{"group":"Expense Reports","pages":[{"title":"List expense reports for organization","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json get /organizations/{organizationId}/reports","href":"/reference/admin/expense-reports/list-expense-reports-for-organization"},{"title":"Perform an action on several expense reports","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json put /organizations/{organizationId}/reports","href":"/reference/admin/expense-reports/perform-an-action-on-several-expense-reports"},{"title":"Report counters for organization (tab badges)","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json get /organizations/{organizationId}/reports/counters","href":"/reference/admin/expense-reports/report-counters-for-organization-tab-badges"},{"title":"Generate output for expense reports","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json get /organizations/{organizationId}/reports/output","href":"/reference/admin/expense-reports/generate-output-for-expense-reports"},{"title":"Get expense report for organization","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json get /organizations/{organizationId}/reports/{reportId}","href":"/reference/admin/expense-reports/get-expense-report-for-organization"},{"title":"Update expense report for organization","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json put /organizations/{organizationId}/reports/{reportId}","href":"/reference/admin/expense-reports/update-expense-report-for-organization"},{"title":"Delete expense report for organization","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json delete /organizations/{organizationId}/reports/{reportId}","href":"/reference/admin/expense-reports/delete-expense-report-for-organization"},{"title":"Send an expense report","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json put /organizations/{organizationId}/reports/{reportId}/send","href":"/reference/admin/expense-reports/send-an-expense-report"},{"title":"Delete the external voucher info of an expense report","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json delete /organizations/{organizationId}/reports/{reportId}/externalvoucher","href":"/reference/admin/expense-reports/delete-the-external-voucher-info-of-an-expense-report"},{"title":"List expense report exports for an organization","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json get /organizations/{id}/expensereportsexports","href":"/reference/admin/expense-reports/list-expense-report-exports-for-an-organization"},{"title":"Download an expense report export","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json get /organizations/{id}/expensereportsexports/{expenseReportExportId}","href":"/reference/admin/expense-reports/download-an-expense-report-export"},{"title":"Perform an action on an expense report export","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json put /organizations/{id}/expensereportsexports/{expenseReportExportId}","href":"/reference/admin/expense-reports/perform-an-action-on-an-expense-report-export"},{"title":"Delete an expense report export","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json delete /organizations/{id}/expensereportsexports/{expenseReportExportId}","href":"/reference/admin/expense-reports/delete-an-expense-report-export"},{"title":"List expense reports","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json get /partners/{partnerId}/reports","href":"/reference/admin/expense-reports/list-expense-reports"},{"title":"Get expense report","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json get /partners/{partnerId}/reports/{reportId}","href":"/reference/admin/expense-reports/get-expense-report"}]},{"group":"ExpenseService","pages":[{"title":"List expense service categories","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json get /organizations/{organizationId}/expenseservice/categories","href":"/reference/admin/expenseservice/list-expense-service-categories"},{"title":"Create expense service category","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json post /organizations/{organizationId}/expenseservice/categories","href":"/reference/admin/expenseservice/create-expense-service-category"},{"title":"Get expense service category","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json get /organizations/{organizationId}/expenseservice/categories/{id}","href":"/reference/admin/expenseservice/get-expense-service-category"},{"title":"Update expense service category","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json put /organizations/{organizationId}/expenseservice/categories/{id}","href":"/reference/admin/expenseservice/update-expense-service-category"},{"title":"Delete expense service category","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json delete /organizations/{organizationId}/expenseservice/categories/{id}","href":"/reference/admin/expenseservice/delete-expense-service-category"}]},{"group":"Approval","pages":[{"title":"Get approval setup","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json get /organizations/{organizationId}/approval","href":"/reference/admin/approval/get-approval-setup"},{"title":"Create (activate) main approval setup","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json post /organizations/{organizationId}/approval","href":"/reference/admin/approval/create-activate-main-approval-setup"},{"title":"Update main approval setup","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json put /organizations/{organizationId}/approval/{approvalId}","href":"/reference/admin/approval/update-main-approval-setup"},{"title":"Deactivate (DELETE) main approval setup","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json delete /organizations/{organizationId}/approval/{approvalId}","href":"/reference/admin/approval/deactivate-delete-main-approval-setup"},{"title":"List approval sections","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json get /organizations/{organizationId}/approval/sections","href":"/reference/admin/approval/list-approval-sections"},{"title":"Create an approval section","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json post /organizations/{organizationId}/approval/sections","href":"/reference/admin/approval/create-an-approval-section"},{"title":"Update an approval section","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json put /organizations/{organizationId}/approval/sections/{sectionId}","href":"/reference/admin/approval/update-an-approval-section"},{"title":"Delete an approval section","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json delete /organizations/{organizationId}/approval/sections/{sectionId}","href":"/reference/admin/approval/delete-an-approval-section"},{"title":"List approvers of an approval section","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json get /organizations/{organizationId}/approval/sections/{sectionId}/approvers","href":"/reference/admin/approval/list-approvers-of-an-approval-section"},{"title":"Add an approver to an approval section item","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json post /organizations/{organizationId}/approval/sections/{sectionId}/approvers","href":"/reference/admin/approval/add-an-approver-to-an-approval-section-item"},{"title":"Update an approver on an approval section item","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json put /organizations/{organizationId}/approval/sections/{sectionId}/approvers/{approverId}","href":"/reference/admin/approval/update-an-approver-on-an-approval-section-item"},{"title":"Delete an approver from an approval section item","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json delete /organizations/{organizationId}/approval/sections/{sectionId}/approvers/{approverId}","href":"/reference/admin/approval/delete-an-approver-from-an-approval-section-item"}]},{"group":"Dimensions","pages":[{"title":"List custom dimension definitions","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json get /organizations/{organizationId}/customdimensions","href":"/reference/admin/dimensions/list-custom-dimension-definitions"},{"title":"Create custom dimension definition","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json post /organizations/{organizationId}/customdimensions","href":"/reference/admin/dimensions/create-custom-dimension-definition"},{"title":"Get custom dimension definition","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json get /organizations/{organizationId}/customdimensions/{definitionId}","href":"/reference/admin/dimensions/get-custom-dimension-definition"},{"title":"Update custom dimension definition","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json put /organizations/{organizationId}/customdimensions/{definitionId}","href":"/reference/admin/dimensions/update-custom-dimension-definition"},{"title":"Delete custom dimension definition","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json delete /organizations/{organizationId}/customdimensions/{definitionId}","href":"/reference/admin/dimensions/delete-custom-dimension-definition"},{"title":"List custom dimension values","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json get /organizations/{organizationId}/customdimensions/{definitionId}/values","href":"/reference/admin/dimensions/list-custom-dimension-values"},{"title":"Create custom dimension value","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json post /organizations/{organizationId}/customdimensions/{definitionId}/values","href":"/reference/admin/dimensions/create-custom-dimension-value"},{"title":"Get custom dimension value","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json get /organizations/{organizationId}/customdimensions/{definitionId}/values/{valueId}","href":"/reference/admin/dimensions/get-custom-dimension-value"},{"title":"Update custom dimension value","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json put /organizations/{organizationId}/customdimensions/{definitionId}/values/{valueId}","href":"/reference/admin/dimensions/update-custom-dimension-value"},{"title":"Delete custom dimension value","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json delete /organizations/{organizationId}/customdimensions/{definitionId}/values/{valueId}","href":"/reference/admin/dimensions/delete-custom-dimension-value"}]},{"group":"Departments","pages":[{"title":"Create department","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json post /organizations/{organizationId}/departments","href":"/reference/admin/departments/create-department"},{"title":"Get root department","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json get /organizations/{organizationId}/departments/root","href":"/reference/admin/departments/get-root-department"},{"title":"List departments tree","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json get /organizations/{organizationId}/departments/tree","href":"/reference/admin/departments/list-departments-tree"},{"title":"Get department","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json get /organizations/{organizationId}/departments/{departmentId}","href":"/reference/admin/departments/get-department"},{"title":"Update department","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json put /organizations/{organizationId}/departments/{departmentId}","href":"/reference/admin/departments/update-department"},{"title":"Delete department","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json delete /organizations/{organizationId}/departments/{departmentId}","href":"/reference/admin/departments/delete-department"}]},{"group":"Tax codes","pages":[{"title":"List tax codes","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json get /organizations/{organizationId}/taxcodes","href":"/reference/admin/tax-codes/list-tax-codes"},{"title":"Create tax code","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json post /organizations/{organizationId}/taxcodes","href":"/reference/admin/tax-codes/create-tax-code"},{"title":"Get tax code","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json get /organizations/{organizationId}/taxcodes/{taxCodeId}","href":"/reference/admin/tax-codes/get-tax-code"},{"title":"Update tax code","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json put /organizations/{organizationId}/taxcodes/{taxCodeId}","href":"/reference/admin/tax-codes/update-tax-code"},{"title":"Delete tax code","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json delete /organizations/{organizationId}/taxcodes/{taxCodeId}","href":"/reference/admin/tax-codes/delete-tax-code"},{"title":"List tax code values","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json get /organizations/{organizationId}/taxcodes/{taxCodeId}/values","href":"/reference/admin/tax-codes/list-tax-code-values"},{"title":"Create tax code value","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json post /organizations/{organizationId}/taxcodes/{taxCodeId}/values","href":"/reference/admin/tax-codes/create-tax-code-value"},{"title":"Get tax code value","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json get /organizations/{organizationId}/taxcodes/{taxCodeId}/values/{valueId}","href":"/reference/admin/tax-codes/get-tax-code-value"},{"title":"Update tax code value","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json put /organizations/{organizationId}/taxcodes/{taxCodeId}/values/{valueId}","href":"/reference/admin/tax-codes/update-tax-code-value"},{"title":"Delete tax code value","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json delete /organizations/{organizationId}/taxcodes/{taxCodeId}/values/{valueId}","href":"/reference/admin/tax-codes/delete-tax-code-value"}]},{"group":"VAT","pages":[{"title":"Get available VAT rates for an organization based on VAT mode","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json get /organizations/{organizationId}/vatsettings/{vatMode}","href":"/reference/admin/vat/get-available-vat-rates-for-an-organization-based-on-vat-mode"},{"title":"Update VAT settings for an organization","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json put /organizations/{organizationId}/vatsettings","href":"/reference/admin/vat/update-vat-settings-for-an-organization"}]},{"group":"Users","pages":[{"title":"List users","description":"Returns a paginated list of the users of the given organization. A user is a person employed by the organization; `id` and `externalSourceId` belong to that employment, so the same person is a different user in every organization they belong to. Deleted users are not listed.\n\nThe response contains personal data (`ssn`, `bankAccountNumber`, `IBAN`, `BIC`) and is only returned to administrators of the organization.\n\nReturns 404 when the organization does not exist or the authenticated user is not an administrator of it, so a caller cannot tell an organization they lack access to from a missing one.\n","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json get /organizations/{organizationId}/users","href":"/reference/admin/users/list-users"},{"title":"Create user","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json post /organizations/{organizationId}/users","href":"/reference/admin/users/create-user"},{"title":"Update user","description":"Changes a user of the given organization and returns it as the list returns it. Only the properties in the body are changed: a property that is left out keeps its value, and `null` clears an optional property. A user read from the list can be sent back, changed or not; leave out `language` when it is `null`.\n\n`email` and `ssn` can't be changed: the email address is the user's login and the identity number identifies the person. They are accepted when they equal the user's current values, otherwise the request is rejected. The read-only `id`, `lastInvitationDate` and `dateCreated` are ignored.\n\nThe values get the same checks as when a user is created: unknown departments, dimensions, dimension values and languages, invalid bank account numbers, IBAN and BIC values, and an `endDate` in the past are rejected instead of ignored. An `endDate`, `bankAccountNumber`, `IBAN` or `BIC` sent back unchanged isn't checked again; the other values, such as `department` and `customDimensionPresetValues`, are checked even when unchanged. No other user of the organization may have the same `externalSourceId` or `employeeId`.\n\n`firstName`, `lastName`, `mobilePhone`, `language`, `bankAccountNumber`, `IBAN` and `BIC` belong to the person behind the user, which every organization employing that person shares. While the person is also a (not deleted) user of another organization, these can't be changed, so one organization can't change another's data or redirect its reimbursements: they are accepted when they equal the current values, otherwise the request is rejected with 400 and code `INVALID_JSON_PROPERTY_VALUE`, and nothing is changed. Bank details count as unchanged when they only differ in formatting, such as spaces or dashes. The properties of the employment itself, such as `employeeId`, `department` and `isAdministrator`, can still be changed.\n\nMaking a user an administrator also gives them the organization administrator role. A changed department only changes the user's department; reports already sent for approval keep their approvers.\n\nReturns 403 when the organization does not exist or the authenticated user is not an administrator of it, so a caller cannot tell an organization they lack access to from a missing one. Also returns 403 when the organization has no user with the given ID, including a user that is deleted.\n","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json put /organizations/{organizationId}/users/{userId}","href":"/reference/admin/users/update-user"},{"title":"Delete user","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json delete /organizations/{organizationId}/users/{userId}","href":"/reference/admin/users/delete-user"}]},{"group":"Employee Groups","pages":[{"title":"List employee groups","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json get /organizations/{organizationId}/employeegroups","href":"/reference/admin/employee-groups/list-employee-groups"},{"title":"Create employee group","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json post /organizations/{organizationId}/employeegroups","href":"/reference/admin/employee-groups/create-employee-group"},{"title":"Get employee group","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json get /organizations/{organizationId}/employeegroups/{employeeGroupId}","href":"/reference/admin/employee-groups/get-employee-group"},{"title":"Update employee group","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json put /organizations/{organizationId}/employeegroups/{employeeGroupId}","href":"/reference/admin/employee-groups/update-employee-group"},{"title":"Delete employee group","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json delete /organizations/{organizationId}/employeegroups/{employeeGroupId}","href":"/reference/admin/employee-groups/delete-employee-group"}]},{"group":"Carbon emissions","pages":[{"title":"Get the total amount and emissions in the organization and categorize emissions to specific sources of emission","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json get /carbonemissions/totaldataandbycategory","href":"/reference/admin/carbon-emissions/get-the-total-amount-and-emissions-in-the-organization-and-categorize-emissions-to-specific-sources-of-emission"},{"title":"Get top emitters","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json get /carbonemissions/topemitters","href":"/reference/admin/carbon-emissions/get-top-emitters"},{"title":"Get the emissions data month by month","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json get /carbonemissions/emissionmonthbymonth","href":"/reference/admin/carbon-emissions/get-the-emissions-data-month-by-month"},{"title":"Get the intensity of carbon emissions","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json get /carbonemissions/carbonintensity","href":"/reference/admin/carbon-emissions/get-the-intensity-of-carbon-emissions"},{"title":"Get the emission data of distance","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json get /carbonemissions/totaldistancedata","href":"/reference/admin/carbon-emissions/get-the-emission-data-of-distance"},{"title":"Get emissions by travel (road)","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json get /carbonemissions/travelbyroad","href":"/reference/admin/carbon-emissions/get-emissions-by-travel-road"},{"title":"Request export of carbon emissions","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json get /carbonemissions/export","href":"/reference/admin/carbon-emissions/request-export-of-carbon-emissions"},{"title":"List carbon emission exports","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json get /carbonemissions/exports","href":"/reference/admin/carbon-emissions/list-carbon-emission-exports"},{"title":"Download carbon emission export","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json get /carbonemissions/exports/{resourceId}","href":"/reference/admin/carbon-emissions/download-carbon-emission-export"},{"title":"Delete carbon emission export","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json delete /carbonemissions/exports/{resourceId}","href":"/reference/admin/carbon-emissions/delete-carbon-emission-export"},{"title":"Get latest added expenses by organization","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json get /carbonemissions/getlatestaddedexpenses","href":"/reference/admin/carbon-emissions/get-latest-added-expenses-by-organization"},{"title":"Get the average carbon emission per kilometer","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json get /carbonemissions/averageemissionperkm","href":"/reference/admin/carbon-emissions/get-the-average-carbon-emission-per-kilometer"},{"title":"Get carbon emissions per dimension type","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json get /carbonemissions/dimensiontypeemissions","href":"/reference/admin/carbon-emissions/get-carbon-emissions-per-dimension-type"},{"title":"Get all dimensions used in carbon footprint","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json get /carbonemissions/alluseddimensions","href":"/reference/admin/carbon-emissions/get-all-dimensions-used-in-carbon-footprint"},{"title":"Get commuting distances by vehicle and fuel type","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json get /carbonemissions/commutingoverview","href":"/reference/admin/carbon-emissions/get-commuting-distances-by-vehicle-and-fuel-type"}]},{"group":"Partners","pages":[{"title":"Create partner","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json post /partners","href":"/reference/admin/partners/create-partner"},{"title":"List of partner consultants","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json get /partners/{partnerId}/consultants","href":"/reference/admin/partners/list-of-partner-consultants"},{"title":"List partner organizations","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json get /partners/{partnerId}/organizations","href":"/reference/admin/partners/list-partner-organizations"},{"title":"Get partner details","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json get /partners/{partnerId}","href":"/reference/admin/partners/get-partner-details"},{"title":"Update partner","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json put /partners/{partnerId}","href":"/reference/admin/partners/update-partner"}]},{"group":"Bulk","pages":[{"title":"Execute a batch of admin API requests","deprecated":null,"version":null,"openapi":"/openapi/findity-admin-api.json post /bulk","href":"/reference/admin/bulk/execute-a-batch-of-admin-api-requests"}]}]},{"group":"Findity Admin API V0","pages":[{"group":"Licenses","pages":[{"title":"V0 - Get list of licenses","openapi":"openapi/findity-admin-api-1.json GET /clientapplications/{clientApplicationId}/licensedata/","href":"/reference/4eb6c64b-1fdd-4160-ad57-b7f1342e63cd"},{"title":"V0 - List organization licenses","openapi":"openapi/findity-admin-api-1.json GET /organizations/{internalId}/licensedata/","href":"/reference/c8351303-8b26-4f04-80a4-6fbe6b8cb754"},{"title":"V0 - List partner licenses","openapi":"openapi/findity-admin-api-1.json GET /partners/{partnerId}/licensedata/","href":"/reference/0b372159-1813-4d87-84d0-6fa4938c7097"}]},{"group":"Dimensions","pages":[{"title":"V0 - Update dimensions (externalId)","openapi":"openapi/findity-admin-api-1.json PUT /organizations/externalid/{externalId}/customdimensions/","href":"/reference/d2ad51c8-d180-436c-a5b2-dc30b749b68a"},{"title":"V0 - Update dimensions (internalId)","openapi":"openapi/findity-admin-api-1.json PUT /organizations/{internalId}/customdimensions/","href":"/reference/2147aae6-6ae4-457d-81f1-1f9e488bf5a2"},{"title":"V0 - Manage values (internalId)","openapi":"openapi/findity-admin-api-1.json PUT /organizations/{internalId}/customdimensions/{definitionInternalId}/list/","href":"/reference/52742a94-8a23-482f-8c36-b6a243554a4b"},{"title":"V0 - Manage values (externalId)","openapi":"openapi/findity-admin-api-1.json PUT /organizations/externalid/{externalId}/customdimensions/{definitionExternalId}/list/","href":"/reference/457ea28e-83fb-4f24-86f7-b09a24c8c74a"},{"title":"V0 - List dimensions (externalId)","openapi":"openapi/findity-admin-api-1.json GET /organizations/externalid/{externalId}/customdimensions/","href":"/reference/72a0daeb-3248-4ed5-a3e1-a886d02b9eb8"},{"title":"V0 - List dimensions (internalId)","openapi":"openapi/findity-admin-api-1.json GET /organizations/{internalId}/customdimensions/","href":"/reference/bd498c1c-9071-4e58-9ada-e9948aa23c68"},{"title":"V0 - Get the list with values (externalId)","openapi":"openapi/findity-admin-api-1.json GET /organizations/externalid/{externalId}/customdimensions/{definitionExternalId}/list/","href":"/reference/4e4c4985-0873-4c54-90e6-4b869c3ad3ed"},{"title":"V0 - Get the list with values (internalId)","openapi":"openapi/findity-admin-api-1.json GET /organizations/{internalId}/customdimensions/{definitionInternalId}/list/","href":"/reference/4ded773e-0461-4251-875b-149ba7b6ef38"},{"title":"V0 - Get the list of approvers on values (externalId)","openapi":"openapi/findity-admin-api-1.json GET /organizations/externalid/{externalId}/customdimensions/{definitionExternalId}/list/approvers/","href":"/reference/073d7b4a-b6f5-4902-ad53-554a76ac178d"},{"title":"V0 - Manage approvers on values (internalId)","openapi":"openapi/findity-admin-api-1.json PUT /organizations/{internalId}/customdimensions/{definitionInternalId}/list/approvers/","href":"/reference/9559fc37-656e-43d8-b03c-cc8e9b71d339"},{"title":"V0 - Manage approvers on values (externalId)","openapi":"openapi/findity-admin-api-1.json PUT /organizations/externalid/{externalId}/customdimensions/{definitionExternalId}/list/approvers/","href":"/reference/e27b1441-7a53-4e4a-9d1f-60028944d800"}]},{"group":"Reports","pages":[{"title":"V0 - List Reports (internalId)","openapi":"openapi/findity-admin-api-1.json GET /organizations/{internalId}/expensereports","href":"/reference/cc39ce0d-db17-43fe-bc76-3d0ca79ae42d"},{"title":"V0 - List Reports (externalId)","openapi":"openapi/findity-admin-api-1.json GET /organizations/externalid/{externalId}/expensereports/","href":"/reference/35ad2968-c199-466c-b801-300d11f8c1ef"},{"title":"V0 - Get Report","openapi":"openapi/findity-admin-api-1.json GET /expensereports/{reportId}","href":"/reference/9ece1593-5362-4079-9a1b-df9a2d9fd8f7"},{"title":"V0 - Update report status","openapi":"openapi/findity-admin-api-1.json PUT /expensereports/{reportId}/setstatus/{status}","href":"/reference/c5709fad-37fe-49dc-b75d-16efb31ee2b3"},{"title":"V0 - Bulk send expense reports","openapi":"openapi/findity-admin-api-1.json PUT /expensereports/bulksendreports","href":"/reference/bulksendexpensereports"}]},{"group":"Organizations","pages":[{"title":"V0 - List organizations","openapi":"openapi/findity-admin-api-1.json GET /organizations/","href":"/reference/organizations-4"},{"title":"V0 - Get organization (externalId)","openapi":"openapi/findity-admin-api-1.json GET /organizations/externalid/{externalId}/","href":"/reference/9eec9c73-7c47-4f0f-848c-c87586eba4e3"},{"title":"V0 - Get organization (internalId)","openapi":"openapi/findity-admin-api-1.json GET /organizations/{internalId}/","href":"/reference/fc7db250-eb85-4218-b94e-60614651fabe"},{"title":"V0 - Create/Update organization (externalId)","openapi":"openapi/findity-admin-api-1.json POST /organizations/externalid/{externalId}/","href":"/reference/257a0f44-181f-4663-a675-93b37685871f"},{"title":"V0 - Update organization (internalId)","openapi":"openapi/findity-admin-api-1.json POST /organizations/{internalId}/","href":"/reference/72ac2457-63fc-4fe9-a76a-6f977bdc0e9d"},{"title":"V0 - Delete organization (externalId)","openapi":"openapi/findity-admin-api-1.json DELETE /organizations/externalid/{externalId}/","href":"/reference/9e662b90-aaf6-413b-8889-63c3eb9ba54d"},{"title":"V0 - Delete organization (internalId)","openapi":"openapi/findity-admin-api-1.json DELETE /organizations/{internalId}/","href":"/reference/beb8e569-69c8-47a2-a177-b182592733b8"},{"title":"V0 - Report Counters (externalId)","openapi":"openapi/findity-admin-api-1.json GET /organizations/externalid/{externalId}/reportcounters/","href":"/reference/391b0ade-2a8f-4e51-ab3f-c085510f3ab2"},{"title":"V0 - Lookup organization","openapi":"openapi/findity-admin-api-1.json GET /organizations/externalid/lookup/","href":"/reference/e4f63203-db66-4d71-bd81-6d08ee1f1bb8"},{"title":"V0 - Report Counters (internalId)","openapi":"openapi/findity-admin-api-1.json GET /organizations/{internalId}/reportcounters/","href":"/reference/30168bd1-5f4b-42db-ae02-c697abba16ea"}]},{"group":"Partners","pages":[{"title":"V0 - List Partners","openapi":"openapi/findity-admin-api-1.json GET /partners/","href":"/reference/befe11fc-8000-4e2e-b715-329e28089876"},{"title":"V0 - Create partner","openapi":"openapi/findity-admin-api-1.json POST /partners/","href":"/reference/417c19b9-f840-4259-9420-ae4cda4830eb"},{"title":"V0 - Update partner","openapi":"openapi/findity-admin-api-1.json PUT /partners/{id}/","href":"/reference/7ba94600-5bce-432e-af4a-1a1ba9d71ee0"}]},{"group":"Files","pages":[{"title":"V0 - Get export file","openapi":"openapi/findity-admin-api-1.json GET /expensereportsexport/{fileId}","href":"/reference/bc57d1f0-b38b-4045-a516-a72aa36e8372"},{"title":"V0 - Get list of files","openapi":"openapi/findity-admin-api-1.json GET /expensereportsexports/","href":"/reference/e1d32581-77e0-41ce-ad15-2ff6ad09b8cf"}]},{"group":"Person","pages":[{"title":"V0 - Get Person (externalId)","openapi":"openapi/findity-admin-api-1.json GET /person/externalid/{externalId}","href":"/reference/31d6a9f6-0854-45c6-ae5d-ad0d9d2bc84f"},{"title":"V0 - Get Person (internalId)","openapi":"openapi/findity-admin-api-1.json GET /person/{internalId}","href":"/reference/8f487890-5426-47e8-9afc-87cff3bbec21"},{"title":"V0 - Update person (internalId)","openapi":"openapi/findity-admin-api-1.json PUT /person/{internalId}","href":"/reference/2f6b863e-d41d-44c5-8cd9-265736684c1d"}]},{"group":"Users","pages":[{"title":"V0 - List users (externalId)","openapi":"openapi/findity-admin-api-1.json GET /organizations/externalid/{externalId}/users/","href":"/reference/7a90bb94-4125-428c-ac35-0d330733bfbb"},{"title":"V0 - List users (internalId)","openapi":"openapi/findity-admin-api-1.json GET /organizations/{internalId}/users/","href":"/reference/2809770e-a869-4973-a99b-96e4a08bce06"},{"title":"V0 - Add, update or remove employee (externalId)","openapi":"openapi/findity-admin-api-1.json PUT /organizations/externalid/{externalId}/users/","href":"/reference/4c0f9beb-7beb-439f-8021-889586914d9d"},{"title":"V0 - Add, update or remove employee (internalId)","openapi":"openapi/findity-admin-api-1.json PUT /organizations/{internalId}/users/","href":"/reference/870c6890-0ea4-4df3-b4eb-74f03c0acc6f"}]},{"group":"Custom fields","pages":[{"title":"V0 - List definitions","openapi":"openapi/findity-admin-api-1.json GET /organizations/{internalId}/customfields/","href":"/reference/43c19741-6838-40e8-83b3-fc736b0dd57b"},{"title":"V0 - Update definitions","openapi":"openapi/findity-admin-api-1.json PUT /organizations/{internalId}/customfields/","href":"/reference/15530c1b-c3fc-4f4b-9d5e-a300ee008c04"},{"title":"V0 - Get the list with values","openapi":"openapi/findity-admin-api-1.json GET /organizations/externalid/{externalId}/customdimensions/{definitionExternalId}/list","href":"/reference/36e50afa-6b76-49f7-94ed-3690f8413e46"},{"title":"V0 - Manage values","openapi":"openapi/findity-admin-api-1.json PUT /organizations/externalid/{externalId}/customdimensions/{definitionExternalId}/list","href":"/reference/b6145386-b590-4b62-ab51-13308f84542d"}]},{"group":"Organizational Units","pages":[{"title":"V0 - List Organizational Units (externalId)","openapi":"openapi/findity-admin-api-1.json GET /organizations/externalid/{externalId}/organizationalunits/","href":"/reference/f17b271a-6fec-432c-81bb-e7edd4b39ffe"},{"title":"V0 - List Organizational Units (internalId)","openapi":"openapi/findity-admin-api-1.json GET /organizations/organizationalunits/","href":"/reference/1918cb36-da39-4668-b681-464634f7d8b7"},{"title":"V0 - Update Organizational Units (externalId)","openapi":"openapi/findity-admin-api-1.json PUT /organizations/externalid/{externalId}/organizationalunits/","href":"/reference/5d7d25d5-0fe1-471e-9029-0225c19f450e"},{"title":"V0 - Update Organizational Units (internalId)","openapi":"openapi/findity-admin-api-1.json PUT /organizations/organizationalunits/","href":"/reference/89aa49f3-23ef-42da-ad71-abd2e9a265ab"}]},{"group":"Accounting Consultants","pages":[{"title":"V0 - List Accounting Consultants (internalId)","openapi":"openapi/findity-admin-api-1.json GET /organizations/{internalId}/accountingconsultants/","href":"/reference/73a843e9-be14-429e-9118-a9b2f300f9ab"},{"title":"V0 - List Accounting Consultants (externalId)","openapi":"openapi/findity-admin-api-1.json GET /organizations/externalid/{externalId}/accountingconsultants/","href":"/reference/1cf073cd-8ed0-4095-8e40-1678f155ced6"},{"title":"V0 - Add/remove Accounting Consultant (externalId)","openapi":"openapi/findity-admin-api-1.json PUT /organizations/externalid/{externalId}/accountingconsultants/","href":"/reference/7c039449-25b8-4c51-9ba3-c1939d684632"}]}]},{"group":"Findity Connect API","pages":[{"group":"Exports","root":{"title":"Exports","href":"/reference/exports"},"pages":[{"title":"List exports","deprecated":null,"version":null,"openapi":"/openapi/findity-connect-api.json get /organizations/{organizationId}/exports","href":"/reference/connect/exports/list-exports"},{"title":"Get export","deprecated":null,"version":null,"openapi":"/openapi/findity-connect-api.json get /organizations/{organizationId}/exports/{exportId}","href":"/reference/connect/exports/get-export"},{"title":"Get export vouchers","deprecated":null,"version":null,"openapi":"/openapi/findity-connect-api.json get /organizations/{organizationId}/exports/{exportId}/export","href":"/reference/connect/exports/get-export-vouchers"},{"title":"Process export","deprecated":null,"version":null,"openapi":"/openapi/findity-connect-api.json put /organizations/{organizationId}/exports/{exportId}/updatestatus","href":"/reference/connect/exports/process-export"},{"title":"Get export content","deprecated":null,"version":null,"openapi":"/openapi/findity-connect-api.json get /organizations/{organizationId}/exports/{exportId}/content","href":"/reference/connect/exports/get-export-content"},{"title":"Update export content","deprecated":null,"version":null,"openapi":"/openapi/findity-connect-api.json put /organizations/{organizationId}/exports/{exportId}/content","href":"/reference/connect/exports/update-export-content"}]},{"title":"Overview","href":"/reference/overview-2"},{"title":"Integration Webhook","href":"/reference/integration-webhook"},{"group":"Card transaction","pages":[{"title":"Add new card transaction","deprecated":null,"version":null,"openapi":"/openapi/findity-connect-api.json post /cardtransactions","href":"/reference/connect/card-transaction/add-new-card-transaction"}]}]}]},{"tab":"Changelog","icon":"bullhorn","pages":[{"title":"Changelog","href":"/changelog/may-2025"}]}]},"basePath":"","title":"Create user - Findity Docs","buildId":"dpl_42LwxxU1kGN114H4XzwGYXa9ZDah","deploymentId":"dpl_42LwxxU1kGN114H4XzwGYXa9ZDah","dynamics":["c2aa737661","b0f84f53ff","a9bb46feb3","2b790eda92"],"chunks":["OpenApiReferenceProvider-C-hEh3I2.js","utils-CnF4QiUD.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-C7PVNbel.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-8ytevL2A.js","snippetPresets-BT1alx3v.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","Page-C945cI-W.js","ApiExamples-BLXC0i_W.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CyLIGI9_.js","shallow-DC0lGVIW.js","getApiPlaygroundDisplay-CgDQ85tN.js","CodeSnippet-6-I-Gpv9.js","CodeSnippets-BAk1kDdu.js","getPastedJson-B276RuWN.js","icon-BqP8etTm.js","MethodPill-DM6sbxG1.js","DuplicateIcon-PyJglOaE.js","createIcon-CMeOMAc_.js","DynamicMarkdown-BoyYAA8K.js","SectionHeading-DAYv3gvZ.js","axios-vUo_bRtp.js","Markdown-BhTTmazV.js","clsx-CR-RHrVC.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CBUH0-zX.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BmARFYNC.js"]}