{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"5. Add users to your company","meta":[{"name":"robots","content":"noindex"}],"llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"5-add-users-to-your-company","__idx":0},"children":["5. Add users to your company"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The term ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["company"]}," can used to represent a TMC or a partner organization."," ","As an administrator, use the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/openapi/usersapi/users/createuser"},"children":["create user"]}," API to onboard users to your company"," ","(can be used for both the TMC and organization)."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Here's a sample request from the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/openapi/usersapi/users/createuser"},"children":["create user"]}," API endpoint:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"persona\": \"EMPLOYEE\",\n  \"personalInfo\": {\n    \"title\": \"MS\",\n    \"gender\": \"FEMALE\",\n    \"name\": {\n      \"given\": \"Rachel\",\n      \"middle\": \"Anne\",\n      \"family1\": \"Torres\"\n    },\n    \"dob\": {\n      \"iso8601\": \"1988-03-22\"\n    },\n    \"email\": \"rachel.torres@example.com\",\n    \"addresses\": [\n      {\n        \"addressLines\": [\"450 Lexington Avenue\"],\n        \"locality\": \"New York\",\n        \"administrativeArea\": \"NY\",\n        \"postalCode\": \"10017\",\n        \"regionCode\": \"US\",\n        \"isDefault\": true\n      }\n    ],\n    \"emergencyContact\": {\n      \"name\": \"Marco Torres\",\n      \"relation\": \"SPOUSE\",\n      \"phoneNumbers\": [\n        {\n          \"type\": \"MOBILE\",\n          \"countryCode\": 1,\n          \"isoCountryCode\": \"US\",\n          \"nationalNumber\": 2125550187\n        }\n      ]\n    }\n  },\n  \"businessInfo\": {\n    \"email\": \"rachel.torres@acmecorp.com\",\n    \"employeeId\": \"EMP-20391\",\n    \"workerType\": \"EMPLOYEE\",\n    \"organizationRef\": {\n      \"id\": \"a3f8c1d2-7b45-4e29-9f61-8c3d2e1a5b74\"\n    },\n    \"legalEntityRef\": {\n      \"id\": \"d7e2b309-1c84-4f73-a562-3e9f1d8c7a20\"\n    }\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/openapi/usersapi/users/createuser"},"children":["creating a user"]},":"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["persona"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["name"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["legalEntityRef.id"]},", and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["organizationRef.id"]}," are mandatory fields. You can always update the other profile parameters later."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["We recommend providing the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["businessInfo.email"]}," as it acts as a primary identifier when searching for users within the platform using ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/openapi/usersapi/users/queryuser"},"children":["find user"]}," API."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Response:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"id\": \"f47ac10b-58cc-4372-a567-0e02b2c3d479\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"upon-completion-of-this-step-you-will-have","__idx":1},"children":["Upon completion of this step, you will have:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Added test travelers to your company whose profiles can be used to make air bookings via the Spotnana platform (in the sandbox environment)."]}]}]},"headings":[{"value":"5. Add users to your company","id":"5-add-users-to-your-company","depth":1},{"value":"Upon completion of this step, you will have:","id":"upon-completion-of-this-step-you-will-have","depth":4}],"frontmatter":{"seo":{"title":"5. Add users to your company"}},"lastModified":"2026-04-22T17:33:23.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/integration/api/api-add-users-to-company","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}