Import businesses from CSV

QA Environment

https://qa-api.kiolinkapp.com

POST

/v1/business/import

Businesses

Last modified:2026-10-05 20:35:24

Maintainer:Not configured

Required Permission(s):business-business-create

Creates or updates businesses from a CSV file, matched by Salesforce ID. Typically the file comes from Export businesses.

Every row needs Id_Salesforce or Id_Salesforce_new; rows without either are skipped. When Id_Salesforce_new is present, it replaces the stored Salesforce ID.

Recognized columns: Nombre, Calle, Colonia, Municipio, Estado, Pais, CP, Telefono, division_name, Estatus, Semaforo, Preautorización (true/false), Ejecutivo Finanzas, Ejecutivo Almacen, Ubicaciones.

Ubicaciones lists datacenters and phases as MEX1: F1, F2 | MEX2: F1. Unknown datacenters and phases are dropped.

Any other non-empty column is stored in extradata with the column name as clave.

Requires a session token whose role has the business-business-create permission.

Request

Authorization

API Key

Add parameter in header

authorization

Example:

authorization: ********************

Body Params multipart/form-dataRequired

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://qa-api.kiolinkapp.com/v1/business/import' \
--header 'authorization: <api-key>' \
--form 'csv=@"archivo.csv"'

Responses

🟢200Import result

application/json

Import result. When no row had a Salesforce ID, data is an empty array and message explains it.

Bodyapplication/json

Examples

SuccessNothing to import

{
    "data": {
        "insertedCount": 0,
        "matchedCount": 12,
        "modifiedCount": 10,
        "deletedCount": 0,
        "upsertedCount": 3,
        "upsertedIds": {
            "12": "65f1c2a9e4b0a1b2c3d4e5a1"
        },
        "insertedIds": {}
    }
}

🟠400The `csv` file is missing from a multipart request

🟠401The session token expired

🟠403Not authenticated (missing/invalid token, inactive user), or

🔴500Unexpected error (e

Modified at 2026-10-05 20:35:24

Create a business

Update a business