Upsert site

PUT

/sites/

Creates or updates a site and returns its ID.

When an external ID is provided: updates the matching site, or creates
one if none exists.

When a business name is provided: updates the matching site, or creates
one if none exists.

Either business_name or external_id is required.

Only the fields provided are changed; omitted fields remain unchanged.

Request

Body Params application/jsonRequired

Example

{
    "first_name": "Oliver",
    "last_name": "Bennett",
    "business_name": "Riverside Office Complex",
    "mobile_number": "+61 412 345 678",
    "email": "facilities@riverside.example.com",
    "cc_email_list": [
        "dispatch@hvac.example.com"
    ],
    "address": "100 Riverside Drive, Brisbane QLD 4000",
    "lat": 0,
    "lng": 0,
    "external_id": "SITE-1001",
    "company": "80",
    "notes": "Roof access requires induction.",
    "url": "https://riverside.example.com",
    "business_number": "12 345 678 901",
    "business_entity": "66",
    "custom_fields": [
        {
            "field": "1",
            "value": "Sign in at reception"
        }
    ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request PUT 'https://app.fieldinsight.com/public-api//sites/' \
--header 'Content-Type: application/json' \
--data-raw '{
    "first_name": "Oliver",
    "last_name": "Bennett",
    "business_name": "Riverside Office Complex",
    "mobile_number": "+61 412 345 678",
    "email": "facilities@riverside.example.com",
    "cc_email_list": [
        "dispatch@hvac.example.com"
    ],
    "address": "100 Riverside Drive, Brisbane QLD 4000",
    "lat": 0,
    "lng": 0,
    "external_id": "SITE-1001",
    "company": "80",
    "notes": "Roof access requires induction.",
    "url": "https://riverside.example.com",
    "business_number": "12 345 678 901",
    "business_entity": "66",
    "custom_fields": [
        {
            "field": "1",
            "value": "Sign in at reception"
        }
    ]
}'

Responses

🟢200OK

application/json

Successful response.

Bodyapplication/json

Example

{
    "id": "4001"
}

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

🟠409

🟠422Parameter Error

🟠429

Modified at 2026-10-30 03:40:11

Get sites

Patch site