Create an Organization

Attention

Each organization under the same Client must have a unique documentNumber. If an entity with the same values already exists, the request will fail.

Once you have obtained an access token, you can create an organization using (Create Identity) the following POST request:

Request

Request

HTTPcurlJavaScriptPythonGoRust

POST /sandbox/identities HTTP/1.1
Host: api.conomyhq.com
x-api-key: {YOUR_API_KEY}
Authorization: Bearer {ACCESS_TOKEN}
conomyhq-api-version: 24-04-2025
User-Agent: MyApp/1.0
Content-Type: application/json
Accept: application/json

{
  "type": "ORGANIZATION",
  "name": "Operator 1",
  "nickname": "Op 1",
  "email": "operator1@example.com",
  "phone": "+5691111111",
  "documentType": "RUT",
  "documentNumber": "77123126-K",
  "idv": "iv-23123",
  "country": "CHL",
  "securityOptions": {
    "twoFactorEnabled": false
  },
  "children": []
}

curl -X POST 'https://api.conomyhq.com/sandbox/identities' \
  -H 'x-api-key: {YOUR_API_KEY}' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'conomyhq-api-version: 24-04-2025' \
  -H 'User-Agent: MyApp/1.0' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -d '{
    "type": "ORGANIZATION",
    "name": "Operator 1",
    "nickname": "Op 1",
    "email": "operator1@example.com",
    "phone": "+5691111111",
    "documentType": "RUT",
    "documentNumber": "77123126-K",
    "idv": "iv-23123",
    "country": "CHL",
    "securityOptions": {
      "twoFactorEnabled": false
    },
    "children": []
  }'

const response = await fetch('https://api.conomyhq.com/sandbox/identities', {
  method: 'POST',
  headers: {
    'x-api-key': '{YOUR_API_KEY}',
    'Authorization': 'Bearer {ACCESS_TOKEN}',
    'conomyhq-api-version': '24-04-2025',
    'User-Agent': 'MyApp/1.0',
    'Content-Type': 'application/json',
    'Accept': 'application/json',
  },
  body: JSON.stringify({
    "type": "ORGANIZATION",
    "name": "Operator 1",
    "nickname": "Op 1",
    "email": "operator1@example.com",
    "phone": "+5691111111",
    "documentType": "RUT",
    "documentNumber": "77123126-K",
    "idv": "iv-23123",
    "country": "CHL",
    "securityOptions": {
      "twoFactorEnabled": false
    },
    "children": []
  }),
});

const data = await response.json();

import requests

payload = {
  "type": "ORGANIZATION",
  "name": "Operator 1",
  "nickname": "Op 1",
  "email": "operator1@example.com",
  "phone": "+5691111111",
  "documentType": "RUT",
  "documentNumber": "77123126-K",
  "idv": "iv-23123",
  "country": "CHL",
  "securityOptions": {
    "twoFactorEnabled": false
  },
  "children": []
}

response = requests.post(
    'https://api.conomyhq.com/sandbox/identities',
    headers={
    'x-api-key': '{YOUR_API_KEY}',
    'Authorization': 'Bearer {ACCESS_TOKEN}',
    'conomyhq-api-version': '24-04-2025',
    'User-Agent': 'MyApp/1.0',
    'Content-Type': 'application/json',
    'Accept': 'application/json',
    },
    json=payload,
)

data = response.json()

package main

import (
	"bytes"
	"net/http"
)

func main() {
	payload := []byte(`{
  "type": "ORGANIZATION",
  "name": "Operator 1",
  "nickname": "Op 1",
  "email": "operator1@example.com",
  "phone": "+5691111111",
  "documentType": "RUT",
  "documentNumber": "77123126-K",
  "idv": "iv-23123",
  "country": "CHL",
  "securityOptions": {
    "twoFactorEnabled": false
  },
  "children": []
}`)
	body := bytes.NewReader(payload)
	req, _ := http.NewRequest("POST", "https://api.conomyhq.com/sandbox/identities", body)
	req.Header.Set("x-api-key", "{YOUR_API_KEY}")
	req.Header.Set("Authorization", "Bearer {ACCESS_TOKEN}")
	req.Header.Set("conomyhq-api-version", "24-04-2025")
	req.Header.Set("User-Agent", "MyApp/1.0")
	req.Header.Set("Content-Type", "application/json")
	req.Header.Set("Accept", "application/json")

	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
}

use reqwest::Client;
use serde_json::json;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = Client::new();
    let payload = json!({
  "type": "ORGANIZATION",
  "name": "Operator 1",
  "nickname": "Op 1",
  "email": "operator1@example.com",
  "phone": "+5691111111",
  "documentType": "RUT",
  "documentNumber": "77123126-K",
  "idv": "iv-23123",
  "country": "CHL",
  "securityOptions": {
    "twoFactorEnabled": false
  },
  "children": []
});

    let response = client
        .post("https://api.conomyhq.com/sandbox/identities")
        .header("x-api-key", "{YOUR_API_KEY}")
        .header("Authorization", "Bearer {ACCESS_TOKEN}")
        .header("conomyhq-api-version", "24-04-2025")
        .header("User-Agent", "MyApp/1.0")
        .header("Content-Type", "application/json")
        .header("Accept", "application/json")
        .json(&payload)
        .send()
        .await?;

    let data: serde_json::Value = response.json().await?;
    Ok(())
}

Response

200

{
  "id": "679d26c44a21df7584b38e11",
  "type": "ORGANIZATION",
  "name": "Operator 1",
  "documentNumber": "77123126-K",
  "documentType": "RUT",
  "country": "CHL",
  "status": "ACTIVE",
  "createdAt": "2025-01-31T19:38:44Z"
}