Import Contacts from Excel

preprod

https://preprod.api.crego.io

POST

/api/contacts/import-excel/

Last modified:2025-09-13 13:10:10

Upload an Excel file for asynchronous contact import. The file should follow the template format with multi-sheet structure. Returns a BulkOps tracking object for monitoring progress.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Body Params multipart/form-dataRequired

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://preprod.api.crego.io/api/contacts/import-excel/' \
--header 'Authorization: Bearer <token>' \
--form 'file=@""'

Responses

🟢202Accepted

application/json

File upload successful, processing started

Body

Example

{
    "id": 123,
    "status": "pending",
    "content_type": 45,
    "uploaded_file": {
        "id": 456,
        "file_name": "contact_import_20240115_143022.xlsx",
        "file_size": 15360,
        "created_at": "2024-01-15T14:30:22.123456Z"
    },
    "system_generated_file": null,
    "started_at": null,
    "completed_at": null,
    "created_at": "2024-01-15T14:30:22.123456Z",
    "updated_at": "2024-01-15T14:30:22.123456Z",
    "created_by": 1
}

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠413413

Modified at 2025-09-13 13:10:10

Download Contact Excel Template

Get BulkOps Status