Import remote offices from a CSV file Imports multiple remote offices from a CSV file upload.
Request URL https://{server-hostname}:8383/dcapi/som/remote-offices/import
Scope
Header Authorization: d92d4xxxxxxxxxxxxx15f52
Request Parameters - Request Headers Content-Type string Mandatory
- Request Body multipart/form-data JSON Object
Hide Sub-Attributes remoteOfficeCSVFile string Mandatory
A CSV file containing the remote office details required for bulk import. Refer to the sample CSV file for the supported format and field values.
Curl
Java
Python
Deluge
PowerShell
Copied!
curl --request POST \
--url https://appdomain/dcapi/som/remote-offices/import \
--header 'Accept: application/importRemoteOffices.v1+json' \
--header 'Authorization: d92d4xxxxxxxxxxxxx15f52' \
--header 'Content-Type: multipart/form-data' \
-F 'remoteOfficeCSVFile=CSV File'import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.io.IOException;
import java.net.http.HttpTimeoutException;
public class Main {
public static void main(String[] args) {
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://appdomain/dcapi/som/remote-offices/import"))
.header("Content-Type", "multipart/form-data")
.header("Accept", "application/importRemoteOffices.v1+json")
.header("Authorization", " d92d4xxxxxxxxxxxxx15f52")
.method("POST", HttpRequest.BodyPublishers.noBody())
.build();
HttpResponse response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
}
}
import http.client
conn = http.client.HTTPSConnection("appdomain")
headers = {
'Content-Type': "multipart/form-data",
'Accept': "application/importRemoteOffices.v1+json",
'Authorization': " d92d4xxxxxxxxxxxxx15f52"
}
conn.request("POST", "/dcapi/som/remote-offices/import", headers=headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
headersMap = Map();
headersMap.put("Content-Type", "multipart/form-data");
headersMap.put("Accept", "application/importRemoteOffices.v1+json");
list_of_text=List();
list_of_text.add({"paramName":"remoteOfficeCSVFile","content":"value","stringPart":"true"});
response = invokeUrl
[
url: "https://appDomain/dcapi/som/remote-offices/import"
type: POST
headers: headersMap
files: list_of_text
connection: connection_name
]
info response;
$headers=@{}
$headers.Add("Content-Type", "multipart/form-data")
$headers.Add("Accept", "application/importRemoteOffices.v1+json")
$headers.Add("Authorization", " d92d4xxxxxxxxxxxxx15f52")
$response = Invoke-WebRequest -Uri 'https://appdomain/dcapi/som/remote-offices/import' -Method POST -Headers $headersSample Request Body Import bulk remote offices using a CSV file upload
Copied!
remoteOfficeCSVFile = CSV File▼ Show full
Response Parameters - HTTP code 202 Response Body - application/json JSON Object
Hide Sub-Attributes csvImportInProgress boolean
Indicates whether the CSV import process has been accepted and is currently running
- HTTP code 400 Response Body - application/json JSON Object
Hide Sub-Attributes errorCode string
API-specific error code identifying the validation failure
message string
Error message describing the validation failure
- HTTP code 412 Response Body - application/json JSON Object
Hide Sub-Attributes errorCode string
Precondition failed error code identifying the business logic violation
message string
Error message describing the precondition failed while processing request
Possible Response Codes Sample Response: HTTP 202 Remote office CSV import initiated
Copied!
{
"csvImportInProgress": true
}
▼ Show full
Sample Response: HTTP 400 Empty or invalid CSV file
Copied!
{
"errorCode": "30047",
"message": "No data to import",
"statusCode": 400
}
▼ Show full
Sample Response: HTTP 412 Another import is already running
Copied!
{
"errorCode": "30013",
"message": "An import operation is already in progress",
"statusCode": 412
}
▼ Show full
Duration: 1 minute | Threshold: 30 | Lock period: 5 minutes
Duration - Time window for the threshold. Threshold - Number of API calls allowed within the specified duration. Lock Period - Wait time before consecutive API requests.
© 2026, Zoho Corporation Pvt. Ltd. All Rights Reserved.
© 2026, Zoho Corporation Pvt. Ltd. All Rights Reserved.