Create an organization
curl --request POST \
--url https://api.nocotax.app/organizations \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data '
{
"billing_address": {
"country": "<string>",
"recipient": "<string>",
"line1": "<string>",
"line2": "<string>",
"city": "<string>",
"postal_code": "<string>",
"state": "<string>"
},
"name": "<string>",
"roles": [],
"business_registration_number": "<string>",
"contact_information": {
"email": "jsmith@example.com"
},
"is_professional": true,
"tax_identification_number": "<string>",
"timezone": "<string>"
}
'import requests
url = "https://api.nocotax.app/organizations"
payload = {
"billing_address": {
"country": "<string>",
"recipient": "<string>",
"line1": "<string>",
"line2": "<string>",
"city": "<string>",
"postal_code": "<string>",
"state": "<string>"
},
"name": "<string>",
"roles": [],
"business_registration_number": "<string>",
"contact_information": { "email": "jsmith@example.com" },
"is_professional": True,
"tax_identification_number": "<string>",
"timezone": "<string>"
}
headers = {
"Authorization": "Basic <encoded-value>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
body: JSON.stringify({
billing_address: {
country: '<string>',
recipient: '<string>',
line1: '<string>',
line2: '<string>',
city: '<string>',
postal_code: '<string>',
state: '<string>'
},
name: '<string>',
roles: [],
business_registration_number: '<string>',
contact_information: {email: 'jsmith@example.com'},
is_professional: true,
tax_identification_number: '<string>',
timezone: '<string>'
})
};
fetch('https://api.nocotax.app/organizations', 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://api.nocotax.app/organizations",
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([
'billing_address' => [
'country' => '<string>',
'recipient' => '<string>',
'line1' => '<string>',
'line2' => '<string>',
'city' => '<string>',
'postal_code' => '<string>',
'state' => '<string>'
],
'name' => '<string>',
'roles' => [
],
'business_registration_number' => '<string>',
'contact_information' => [
'email' => 'jsmith@example.com'
],
'is_professional' => true,
'tax_identification_number' => '<string>',
'timezone' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Basic <encoded-value>",
"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://api.nocotax.app/organizations"
payload := strings.NewReader("{\n \"billing_address\": {\n \"country\": \"<string>\",\n \"recipient\": \"<string>\",\n \"line1\": \"<string>\",\n \"line2\": \"<string>\",\n \"city\": \"<string>\",\n \"postal_code\": \"<string>\",\n \"state\": \"<string>\"\n },\n \"name\": \"<string>\",\n \"roles\": [],\n \"business_registration_number\": \"<string>\",\n \"contact_information\": {\n \"email\": \"jsmith@example.com\"\n },\n \"is_professional\": true,\n \"tax_identification_number\": \"<string>\",\n \"timezone\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Basic <encoded-value>")
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://api.nocotax.app/organizations")
.header("Authorization", "Basic <encoded-value>")
.header("Content-Type", "application/json")
.body("{\n \"billing_address\": {\n \"country\": \"<string>\",\n \"recipient\": \"<string>\",\n \"line1\": \"<string>\",\n \"line2\": \"<string>\",\n \"city\": \"<string>\",\n \"postal_code\": \"<string>\",\n \"state\": \"<string>\"\n },\n \"name\": \"<string>\",\n \"roles\": [],\n \"business_registration_number\": \"<string>\",\n \"contact_information\": {\n \"email\": \"jsmith@example.com\"\n },\n \"is_professional\": true,\n \"tax_identification_number\": \"<string>\",\n \"timezone\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.nocotax.app/organizations")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Basic <encoded-value>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"billing_address\": {\n \"country\": \"<string>\",\n \"recipient\": \"<string>\",\n \"line1\": \"<string>\",\n \"line2\": \"<string>\",\n \"city\": \"<string>\",\n \"postal_code\": \"<string>\",\n \"state\": \"<string>\"\n },\n \"name\": \"<string>\",\n \"roles\": [],\n \"business_registration_number\": \"<string>\",\n \"contact_information\": {\n \"email\": \"jsmith@example.com\"\n },\n \"is_professional\": true,\n \"tax_identification_number\": \"<string>\",\n \"timezone\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"id": "org_17920607733q8i4fb27ab7",
"livemode": false,
"object": "organization",
"billing_address": {
"line1": "3521 Sawayn Street",
"line2": "Suite 173",
"city": "Port Tarafort",
"postal_code": "78554",
"country": "PF"
},
"business_registration_number": "03801589700309",
"contact_information": {},
"is_professional": true,
"name": "Ryan and Sons",
"ownership": "external",
"roles": [
"BUYER"
],
"timezone": "Etc/UTC",
"tax_identification_number": "177266129",
"created_at": "2026-10-15T10:39:33.176Z",
"updated_at": "2026-10-15T10:39:33.176Z"
}{
"message": "<string>",
"status": 123,
"type": "INVALID_REQUEST_ERROR",
"params": [
{
"field": "<string>",
"errors": [
"<string>"
]
}
]
}Organizations
Create an organization
Creates an external organization.
POST
/
organizations
Create an organization
curl --request POST \
--url https://api.nocotax.app/organizations \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data '
{
"billing_address": {
"country": "<string>",
"recipient": "<string>",
"line1": "<string>",
"line2": "<string>",
"city": "<string>",
"postal_code": "<string>",
"state": "<string>"
},
"name": "<string>",
"roles": [],
"business_registration_number": "<string>",
"contact_information": {
"email": "jsmith@example.com"
},
"is_professional": true,
"tax_identification_number": "<string>",
"timezone": "<string>"
}
'import requests
url = "https://api.nocotax.app/organizations"
payload = {
"billing_address": {
"country": "<string>",
"recipient": "<string>",
"line1": "<string>",
"line2": "<string>",
"city": "<string>",
"postal_code": "<string>",
"state": "<string>"
},
"name": "<string>",
"roles": [],
"business_registration_number": "<string>",
"contact_information": { "email": "jsmith@example.com" },
"is_professional": True,
"tax_identification_number": "<string>",
"timezone": "<string>"
}
headers = {
"Authorization": "Basic <encoded-value>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
body: JSON.stringify({
billing_address: {
country: '<string>',
recipient: '<string>',
line1: '<string>',
line2: '<string>',
city: '<string>',
postal_code: '<string>',
state: '<string>'
},
name: '<string>',
roles: [],
business_registration_number: '<string>',
contact_information: {email: 'jsmith@example.com'},
is_professional: true,
tax_identification_number: '<string>',
timezone: '<string>'
})
};
fetch('https://api.nocotax.app/organizations', 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://api.nocotax.app/organizations",
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([
'billing_address' => [
'country' => '<string>',
'recipient' => '<string>',
'line1' => '<string>',
'line2' => '<string>',
'city' => '<string>',
'postal_code' => '<string>',
'state' => '<string>'
],
'name' => '<string>',
'roles' => [
],
'business_registration_number' => '<string>',
'contact_information' => [
'email' => 'jsmith@example.com'
],
'is_professional' => true,
'tax_identification_number' => '<string>',
'timezone' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Basic <encoded-value>",
"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://api.nocotax.app/organizations"
payload := strings.NewReader("{\n \"billing_address\": {\n \"country\": \"<string>\",\n \"recipient\": \"<string>\",\n \"line1\": \"<string>\",\n \"line2\": \"<string>\",\n \"city\": \"<string>\",\n \"postal_code\": \"<string>\",\n \"state\": \"<string>\"\n },\n \"name\": \"<string>\",\n \"roles\": [],\n \"business_registration_number\": \"<string>\",\n \"contact_information\": {\n \"email\": \"jsmith@example.com\"\n },\n \"is_professional\": true,\n \"tax_identification_number\": \"<string>\",\n \"timezone\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Basic <encoded-value>")
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://api.nocotax.app/organizations")
.header("Authorization", "Basic <encoded-value>")
.header("Content-Type", "application/json")
.body("{\n \"billing_address\": {\n \"country\": \"<string>\",\n \"recipient\": \"<string>\",\n \"line1\": \"<string>\",\n \"line2\": \"<string>\",\n \"city\": \"<string>\",\n \"postal_code\": \"<string>\",\n \"state\": \"<string>\"\n },\n \"name\": \"<string>\",\n \"roles\": [],\n \"business_registration_number\": \"<string>\",\n \"contact_information\": {\n \"email\": \"jsmith@example.com\"\n },\n \"is_professional\": true,\n \"tax_identification_number\": \"<string>\",\n \"timezone\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.nocotax.app/organizations")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Basic <encoded-value>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"billing_address\": {\n \"country\": \"<string>\",\n \"recipient\": \"<string>\",\n \"line1\": \"<string>\",\n \"line2\": \"<string>\",\n \"city\": \"<string>\",\n \"postal_code\": \"<string>\",\n \"state\": \"<string>\"\n },\n \"name\": \"<string>\",\n \"roles\": [],\n \"business_registration_number\": \"<string>\",\n \"contact_information\": {\n \"email\": \"jsmith@example.com\"\n },\n \"is_professional\": true,\n \"tax_identification_number\": \"<string>\",\n \"timezone\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"id": "org_17920607733q8i4fb27ab7",
"livemode": false,
"object": "organization",
"billing_address": {
"line1": "3521 Sawayn Street",
"line2": "Suite 173",
"city": "Port Tarafort",
"postal_code": "78554",
"country": "PF"
},
"business_registration_number": "03801589700309",
"contact_information": {},
"is_professional": true,
"name": "Ryan and Sons",
"ownership": "external",
"roles": [
"BUYER"
],
"timezone": "Etc/UTC",
"tax_identification_number": "177266129",
"created_at": "2026-10-15T10:39:33.176Z",
"updated_at": "2026-10-15T10:39:33.176Z"
}{
"message": "<string>",
"status": 123,
"type": "INVALID_REQUEST_ERROR",
"params": [
{
"field": "<string>",
"errors": [
"<string>"
]
}
]
}Authorizations
Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.
Body
application/json
Show child attributes
Show child attributes
A set of capabilities defining how the organization interacts with the Account. Set to BUYER this entity purchases products or services from your platform. Set to MERCHANT if it represents a supplier, or a platform 3rd party agent, selling to customers.
Available options:
BUYER, MERCHANT Show child attributes
Show child attributes
Show child attributes
Show child attributes
Response
successful
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Whether the organization is a business entity belonging to the account owner, or a 3rd party, doing business with the account entities (supplier, 3rd party merchant or customer)
self: This organization corresponds to a business entity belonging to the current account's owner. For instance, its company or a subsidiary.
external: This organization corresponds to a business entity having business with the current account's owner. It could be given roles such as MERCHANT or BUYER. See roles for more details.
Available options:
self, external Only valid when ownership=external. A set of capabilities defining how the organization interacts with the Account. Set to BUYER if you sell products or services to this entity. Set to MERCHANT if it represents a supplier, or a platform 3rd party agent, selling to customers.
Available options:
BUYER, MERCHANT