Skip to main content
POST
/
organisations
Create an organisation
curl --request POST \
  --url https://api.cula.tech/tracking/v1/organisations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Cula-Org-Id: <cula-org-id>' \
  --data '
{
  "external_id": "GC-ORG-ACKJAM",
  "name": "Ackerman Farms",
  "address": {
    "street": "123 Farm Road",
    "city": "Dickinson",
    "postcode": "58601",
    "country": "United States",
    "country_code": "US"
  },
  "created_by_site": {
    "external_id": "GC-SITE-REFINERY"
  }
}
'
{
  "id": "org_01kqzcjrpyf27tge8c161z0b8h",
  "external_id": "GC-ORG-ACKJAM",
  "name": "Ackerman Farms",
  "address": {
    "street": "123 Farm Road",
    "city": "Dickinson",
    "postcode": "58601",
    "country": "United States",
    "country_code": "US"
  },
  "created_by_site": {
    "id": "ste_01kqzcjrpyf27tge6smsbnhkh5",
    "external_id": "GC-SITE-REFINERY"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.cula.tech/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

OAuth2 client credentials flow. Exchange your client_id and client_secret for a short-lived access token, then pass it as a Bearer token in the Authorization header.

Headers

​
Cula-Org-Id
string
required

Organisation ID that scopes this request. The authenticated consumer must be authorized for this organisation. Omitting this header returns 400; passing an unauthorised org returns 403.

Body

application/json

Create an organisation. Each site must belong to an organisation, such as a supplier company with multiple farm locations.

​
name
string
required
Example:

"Ackerman Farms"

​
created_by_site
object
required

The site creating this record. Must be a site within your API key's scope.

Example:
{ "id": "ste_01kqzcjrpyf27tge6smsbnhkh5" }
​
external_id
string

Partner-assigned identifier. Must be unique within your scope.

​
address
object

Postal address of the organisation.

Response

Organisation created.

​
id
string
required
Example:

"org_01kqzcjrpyf27tge87es6ns4w3"

​
name
string
required
Example:

"GreenCarbon Inc."

​
external_id
string | null
​
address
object

Postal address of the organisation, if known.

​
created_by_site
object

The site that created this organisation record. Null for organisations not created via the API.