Onboard Users
curl --request POST \
--url https://anaconda.com/api/v1/organizations/{org_id}/users_auto_registration \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"user_emails": [
"jsmith@example.com"
]
}
'import requests
url = "https://anaconda.com/api/v1/organizations/{org_id}/users_auto_registration"
payload = { "user_emails": ["jsmith@example.com"] }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({user_emails: ['jsmith@example.com']})
};
fetch('https://anaconda.com/api/v1/organizations/{org_id}/users_auto_registration', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://anaconda.com/api/v1/organizations/{org_id}/users_auto_registration",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'user_emails' => [
'jsmith@example.com'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://anaconda.com/api/v1/organizations/{org_id}/users_auto_registration"
payload := strings.NewReader("{\n \"user_emails\": [\n \"jsmith@example.com\"\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://anaconda.com/api/v1/organizations/{org_id}/users_auto_registration")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"user_emails\": [\n \"jsmith@example.com\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://anaconda.com/api/v1/organizations/{org_id}/users_auto_registration")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"user_emails\": [\n \"jsmith@example.com\"\n ]\n}"
response = http.request(request)
puts response.read_body{
"users_in_onboarding_process": [
"<string>"
],
"users_unavailable_for_onboarding": [
"<string>"
],
"total_organization_seats": "<string>",
"available_organization_seats": "<string>"
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}Onboard Users
Onboards users by adding them to your organization, assigning seats, and generating organization access tokens.
POST
/
api
/
v1
/
organizations
/
{org_id}
/
users_auto_registration
Onboard Users
curl --request POST \
--url https://anaconda.com/api/v1/organizations/{org_id}/users_auto_registration \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"user_emails": [
"jsmith@example.com"
]
}
'import requests
url = "https://anaconda.com/api/v1/organizations/{org_id}/users_auto_registration"
payload = { "user_emails": ["jsmith@example.com"] }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({user_emails: ['jsmith@example.com']})
};
fetch('https://anaconda.com/api/v1/organizations/{org_id}/users_auto_registration', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://anaconda.com/api/v1/organizations/{org_id}/users_auto_registration",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'user_emails' => [
'jsmith@example.com'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://anaconda.com/api/v1/organizations/{org_id}/users_auto_registration"
payload := strings.NewReader("{\n \"user_emails\": [\n \"jsmith@example.com\"\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://anaconda.com/api/v1/organizations/{org_id}/users_auto_registration")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"user_emails\": [\n \"jsmith@example.com\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://anaconda.com/api/v1/organizations/{org_id}/users_auto_registration")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"user_emails\": [\n \"jsmith@example.com\"\n ]\n}"
response = http.request(request)
puts response.read_body{
"users_in_onboarding_process": [
"<string>"
],
"users_unavailable_for_onboarding": [
"<string>"
],
"total_organization_seats": "<string>",
"available_organization_seats": "<string>"
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}Administrators receive an email confirming the users were added.
Users receive a welcome email and a separate email containing their organization access token.
If a user already has an Anaconda account associated with their email address, automated onboarding will fail for that user.If the number of available seats is less than the number of users you are attempting to add, users are added until seats are no longer available, and remaining users appear in
users_unavailable_for_onboarding.Authorizations
Bearer token obtained by authenticating with service account credentials (client_id and client_secret).
See the Getting started page for the full authentication flow.
Path Parameters
Your organization ID, found in your organization's URL: anaconda.com/app/organizations/<ORG_ID>/.
Body
application/json
A list of email addresses for the users to onboard.
Response
Onboarding results
Email addresses of users that were successfully queued for onboarding.
Email addresses of users that could not be onboarded (for example, because they already have an account or no seats are available).
The total number of seats in your organization's subscription.
The number of remaining unassigned seats.
Was this page helpful?