Initiate Import Profiles

POST https://api.ocamba.com/v1/hood/profiles/imports

Initiate the session to import profiles. Performs an automatic mapping of fields from the provided file to the corresponding fields in the Ocamba profile system.

Note

The file must be a valid csv or xlsx file. The api responds with the metadata of a long running operation. You can check out the progress of import by listing lro tasks with the ID provided in the response body. You can also see the import instance by listing import center records. You can check the mapping object by listing import center record, which is needed for the import commit. The maximum file size that can be uploaded is 50MB.

Rate limits:

Burst: 10/s
Steady: 150/m

Request schema

body

Response schemas

›

202

application/json

›

400

application/json

›

500

application/json

curl -X POST \
 "https://api.ocamba.com/v1/hood/profiles/imports" \
  -H "Authorization: Bearer {TOKEN}"

const url = 'https://api.ocamba.com/v1/hood/profiles/imports';
const options = {
  method: 'POST',
  headers: {
    Authorization: `Bearer {TOKEN}`
  }
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

$ch = curl_init("https://api.ocamba.com/v1/hood/profiles/imports");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  "Authorization: Bearer {TOKEN}"
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);

Responses

202 Accepted

{
  "id": "70823f7d-b3ed-4eda-9720-09eaec0a7deb",
  "company_id": "6197120",
  "member_id": "1000223",
  "name": "profile-import",
  "status": "running",
  "start_time": "2025-11-06 14:13:48"
}

400 Bad Request

{
  "code": 400,
  "title": "Bad request.",
  "message": "The request is not valid.",
  "trace_id": "99a84211-f73d-4ff8-acdf-eb3e06bb9d62"
}

500 Internal Server Error

{
  "code": 500,
  "title": "Internal server error.",
  "trace_id": "99a84211-f73d-4ff8-acdf-eb3e06bb9d62"
}

Responses

LinkedIn Facebook Instagram