Upload Call Import Csv

Deprecated

Legacy one-shot upload kept for backward compatibility.

DEPRECATED: prefer the staged flow (POST / → PATCH /{id}/mapping → POST /{id}/import) so each step is idempotent and resumable. This endpoint runs all three stages inline in a single transaction so existing scripts / integrations keep working unchanged.

Authorization

AuthorizationBearer <token>

JWT access token. Use: Authorization: Bearer .

In: header

Header Parameters

Authorization?string|null

X-API-Key?string|null

X-EFFICIENTAI-API-KEY?string|null

X-Workspace-Id?string|null

Request Body

multipart/form-data

TypeScript Definitions

Use the request body type in TypeScript.

file*File

provider?|

Telephony provider key (e.g. 'exotel', 'plivo'). Must match the selected telephony_integration_id's provider. Omit together with telephony_integration_id for direct-URL import.

telephony_integration_id?|

Specific TelephonyIntegration credential row to use when downloading recordings for this batch. Omit together with provider for direct-URL import.

schema_id*Schema Id

Reusable Input Parameter schema this upload is mapped against. Must belong to the active workspace.

Formatuuid

parameter_mapping*Parameter Mapping

JSON-encoded {schema_parameter_name: source_header} map covering every required schema parameter. Optional parameters may be omitted or set to an empty string.

skipped_columns?|

JSON-encoded list of source header strings the uploader has explicitly skipped. Every header in the file must either be mapped or appear here; otherwise the upload is rejected so a forgotten column never silently drops.

dataset?|

Optional free-text dataset label for high-level segregation. Empty strings are stored as NULL.

tag_ids?array<>|

Optional list of CallImportTag ids to attach to the new batch.

sheet_name?|

Worksheet to import when the file is an Excel workbook (.xlsx / .xlsm). REQUIRED for Excel uploads. Ignored for CSV uploads (rejected with 400 if non-empty so typos surface instead of silently importing the wrong source).

Response Body

`application/json`

curl -X POST "https://example.com/api/v1/call-imports/upload" \  -F file="string" \  -F schema_id="9c37f32d-8308-4815-9b0d-83fa3c1b25f9" \  -F parameter_mapping="string"

{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "total_rows": 0,  "status": "pending",  "dataset": "string",  "tags": [    {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "name": "string",      "color": "string",      "created_at": "2019-08-24T14:15:22Z",      "updated_at": "2019-08-24T14:15:22Z"    }  ],  "message": "string"}

Community & contact

Found a bug or have a feature request? Open a GitHub issue.
Join our Discord for faster replies!

Authorization

Header Parameters

Request Body

Response Body

202application/json

422application/json

Community & contact

`application/json`

`application/json`