Create Geo Location

POST

https://platform-api.convirza.com/v3/geo-locations

Geo Locations

Last modified:2026-07-24 13:10:44

Creates a new geo location and registers it as a geo location list in SPAPI2.

What happens internally:

Inserts the geo location into the DB (org_unit_id + name)

Creates a matching geo location list in SPAPI2 — receives an external ID

Stores the spapi2_location_list_id back on the local record

Commits atomically — rolls back the entire operation on any failure

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/jsonRequired

Examples

Responses

🟢201

application/json

Geo location created successfully

Bodyapplication/json

🟠400

🟠401

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://platform-api.convirza.com/v3/geo-locations' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "org_unit_id": 12345,
    "name": "New York Office"
}'

Response Example

201 - Example 1

{
    "success": true,
    "data": {
        "location_id": 1,
        "message": "Geo location created successfully"
    }
}

Modified at 2026-07-24 13:10:44

List Geo Locations

Get Geo Location