Create Accounts

Note

The account types you can create are CHECKING, ASSET, and SAVINGS. ESCROW and FEE accounts are managed by the platform and cannot be created directly.

Create the Organization’s Account

To create an account for the organization, make the following POST request:

Request

Request

HTTPcurlJavaScriptPythonGoRust

POST /sandbox/accounts 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

{
  "identityId": "<ORGANIZATION_ID>",
  "externalId": "lybkpay-2",
  "type": "CHECKING",
  "currency": "CLP",
  "name": "CLP account",
  "custody": "BANK_ACCOUNT"
}

curl -X POST 'https://api.conomyhq.com/sandbox/accounts' \
  -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 '{
    "identityId": "<ORGANIZATION_ID>",
    "externalId": "lybkpay-2",
    "type": "CHECKING",
    "currency": "CLP",
    "name": "CLP account",
    "custody": "BANK_ACCOUNT"
  }'

const response = await fetch('https://api.conomyhq.com/sandbox/accounts', {
  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({
    "identityId": "<ORGANIZATION_ID>",
    "externalId": "lybkpay-2",
    "type": "CHECKING",
    "currency": "CLP",
    "name": "CLP account",
    "custody": "BANK_ACCOUNT"
  }),
});

const data = await response.json();

import requests

payload = {
  "identityId": "<ORGANIZATION_ID>",
  "externalId": "lybkpay-2",
  "type": "CHECKING",
  "currency": "CLP",
  "name": "CLP account",
  "custody": "BANK_ACCOUNT"
}

response = requests.post(
    'https://api.conomyhq.com/sandbox/accounts',
    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(`{
  "identityId": "<ORGANIZATION_ID>",
  "externalId": "lybkpay-2",
  "type": "CHECKING",
  "currency": "CLP",
  "name": "CLP account",
  "custody": "BANK_ACCOUNT"
}`)
	body := bytes.NewReader(payload)
	req, _ := http.NewRequest("POST", "https://api.conomyhq.com/sandbox/accounts", 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!({
  "identityId": "<ORGANIZATION_ID>",
  "externalId": "lybkpay-2",
  "type": "CHECKING",
  "currency": "CLP",
  "name": "CLP account",
  "custody": "BANK_ACCOUNT"
});

    let response = client
        .post("https://api.conomyhq.com/sandbox/accounts")
        .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": "679d2e934bc4149871723cef",
  "identityId": "679d26c44a21df7584b38e11",
  "type": "CHECKING",
  "custody": "BANK_ACCOUNT",
  "balance": "0",
  "availableFunds": "0",
  "currency": "CLP",
  "accountNumber": "173835432305679d26c44a21df7584b38e11",
  "status": "ACTIVE"
}

Create Users’s Account

To create an account for the first user, make the following POST request:

Request

Request

HTTPcurlJavaScriptPythonGoRust

POST /sandbox/accounts 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

{
  "identityId": "<USER_1_ID>",
  "externalId": "lybkpay-3",
  "type": "CHECKING",
  "currency": "CLP",
  "name": "CLP account",
  "custody": "BANK_ACCOUNT",
  "parentId": "<PARENT_ACCOUNT_ID>"
}

curl -X POST 'https://api.conomyhq.com/sandbox/accounts' \
  -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 '{
    "identityId": "<USER_1_ID>",
    "externalId": "lybkpay-3",
    "type": "CHECKING",
    "currency": "CLP",
    "name": "CLP account",
    "custody": "BANK_ACCOUNT",
    "parentId": "<PARENT_ACCOUNT_ID>"
  }'

const response = await fetch('https://api.conomyhq.com/sandbox/accounts', {
  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({
    "identityId": "<USER_1_ID>",
    "externalId": "lybkpay-3",
    "type": "CHECKING",
    "currency": "CLP",
    "name": "CLP account",
    "custody": "BANK_ACCOUNT",
    "parentId": "<PARENT_ACCOUNT_ID>"
  }),
});

const data = await response.json();

import requests

payload = {
  "identityId": "<USER_1_ID>",
  "externalId": "lybkpay-3",
  "type": "CHECKING",
  "currency": "CLP",
  "name": "CLP account",
  "custody": "BANK_ACCOUNT",
  "parentId": "<PARENT_ACCOUNT_ID>"
}

response = requests.post(
    'https://api.conomyhq.com/sandbox/accounts',
    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(`{
  "identityId": "<USER_1_ID>",
  "externalId": "lybkpay-3",
  "type": "CHECKING",
  "currency": "CLP",
  "name": "CLP account",
  "custody": "BANK_ACCOUNT",
  "parentId": "<PARENT_ACCOUNT_ID>"
}`)
	body := bytes.NewReader(payload)
	req, _ := http.NewRequest("POST", "https://api.conomyhq.com/sandbox/accounts", 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!({
  "identityId": "<USER_1_ID>",
  "externalId": "lybkpay-3",
  "type": "CHECKING",
  "currency": "CLP",
  "name": "CLP account",
  "custody": "BANK_ACCOUNT",
  "parentId": "<PARENT_ACCOUNT_ID>"
});

    let response = client
        .post("https://api.conomyhq.com/sandbox/accounts")
        .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": "679d2e934bc43678898aap",
  "identityId": "681b9512a490a37d1d795409",
  "type": "CHECKING",
  "custody": "BANK_ACCOUNT",
  "balance": "0",
  "availableFunds": "0",
  "currency": "CLP",
  "accountNumber": "173835432305681b9512a490a37d1d795409",
  "parentId": "679d2e934bc4149871723cef",
  "status": "ACTIVE"
}