> This page is for version 2025-09-18 (default). > For other versions, use one of these documentation indexes: > - 2025-09-18 (default): https://apidocs.polytomic.com/2025-09-18/llms.txt > - 2024-02-08: https://apidocs.polytomic.com/2024-02-08/llms.txt > - 2023-04-25: https://apidocs.polytomic.com/2023-04-25/llms.txt > - 2022-12-12: https://apidocs.polytomic.com/2022-12-12/llms.txt > - 2021-05-23: https://apidocs.polytomic.com/2021-05-23/llms.txt > For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://apidocs.polytomic.com/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://apidocs.polytomic.com/_mcp/server. # Create Current Org User POST https://app.polytomic.com/api/organization/users Content-Type: application/json Creates a new user in the caller's current organization and assigns the requested permissions roles. The new user receives an invitation email prompting them to set up their account. Role assignments take effect as soon as the invitation is accepted. Reference: https://apidocs.polytomic.com/api-reference/users/create-current-org-user ## Authentication - `Authorization` header (bearer token, required) — Bearer user API key - `Authorization` header (basic auth, required) — Basic organization-scoped API key ## Request ### Body (application/json) This endpoint expects a CurrentOrgCreateUserRequestSchema. - `email` (string, required) — Email address used to sign the user in and receive notifications. - `role_ids` (list of string, optional) — Identifiers of the permissions roles to assign to the user. Must contain at least one entry when provided. - `role` (string, optional, deprecated) — Deprecated legacy role name. Use role_ids instead; setting both role and role_ids in the same request is rejected. ## Response ### 200 OK - `data` (User, optional) ## Errors ### 403 Forbidden Error Forbidden - `key` (string, optional) - `message` (string, optional) - `metadata` (map from string to any, optional) - `status` (integer, optional) ### 422 Unprocessable Entity Error Unprocessable Entity - `key` (string, optional) - `message` (string, optional) - `metadata` (map from string to any, optional) - `status` (integer, optional) ### 500 Internal Server Error Internal Server Error - `key` (string, optional) - `message` (string, optional) - `metadata` (map from string to any, optional) - `status` (integer, optional) ## Types ### User - `email` (string, optional) — Email address used to sign in and receive notifications. - `id` (string, optional) — Unique identifier of the user. - `organization_id` (string, optional) — Unique identifier of the organization the user belongs to. - `role_ids` (list of string, optional, nullable) — Identifiers of the permissions roles assigned to the user. - `role` (string, optional, deprecated) — Deprecated legacy role name. Use role_ids instead. ## Examples **Request** ```json { "email": "jane.doe@polytomic.com" } ``` **Response** ```json { "data": { "email": "jane.doe@polytomic.com", "id": "a3f1c9e2-7b4d-4f8a-9c2e-1d5b6f7a8c9d", "organization_id": "d9f8e7c6-b5a4-4321-8f7e-6d5c4b3a2f1e", "role_ids": [ "248df4b7-aa70-47b8-a036-33ac447e668d" ], "role": "admin" } } ``` **SDK Code** ```python import requests url = "https://app.polytomic.com/api/organization/users" payload = { "email": "jane.doe@polytomic.com" } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript const url = 'https://app.polytomic.com/api/organization/users'; const options = { method: 'POST', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"email":"jane.doe@polytomic.com"}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://app.polytomic.com/api/organization/users" payload := strings.NewReader("{\n \"email\": \"jane.doe@polytomic.com\"\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby require 'uri' require 'net/http' url = URI("https://app.polytomic.com/api/organization/users") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"email\": \"jane.doe@polytomic.com\"\n}" response = http.request(request) puts response.read_body ``` ```java import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://app.polytomic.com/api/organization/users") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"email\": \"jane.doe@polytomic.com\"\n}") .asString(); ``` ```php request('POST', 'https://app.polytomic.com/api/organization/users', [ 'body' => '{ "email": "jane.doe@polytomic.com" }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp using RestSharp; var client = new RestClient("https://app.polytomic.com/api/organization/users"); var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"email\": \"jane.doe@polytomic.com\"\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = ["email": "jane.doe@polytomic.com"] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://app.polytomic.com/api/organization/users")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```