Import Contacts

curl --request POST \
  --url https://api.example.com/v1/import/contacts \
  --header 'Content-Type: application/json' \
  --data '
{
  "rows": [
    {}
  ],
  "csv": "<string>",
  "has_header": true,
  "mapping": {},
  "update_existing": true,
  "tags": [
    {}
  ]
}
'

{
  "data": {
    "job_id": "<string>",
    "status": "<string>",
    "created_count": 123,
    "updated_count": 123,
    "skipped_count": 123,
    "errors": [
      {}
    ]
  }
}

POST

import

contacts

Import Contacts

curl --request POST \
  --url https://api.example.com/v1/import/contacts \
  --header 'Content-Type: application/json' \
  --data '
{
  "rows": [
    {}
  ],
  "csv": "<string>",
  "has_header": true,
  "mapping": {},
  "update_existing": true,
  "tags": [
    {}
  ]
}
'

{
  "data": {
    "job_id": "<string>",
    "status": "<string>",
    "created_count": 123,
    "updated_count": 123,
    "skipped_count": 123,
    "errors": [
      {}
    ]
  }
}

Request

Supply either a structured rows array or a raw csv string. When CSV is provided, supply a mapping that maps CSV column names to contact fields. Imports are processed synchronously for up to 500 rows; larger imports are queued and can be tracked via the returned job_id.

Headers

Authorization: Bearer wbk_your_api_key_here
Content-Type: application/json

Idempotency-Key

string

Strongly recommended for imports. Same key returns the original result (including job_id) within 24 hours.

Body Parameters

rows

array

Array of contact objects. Each object accepts the same fields as POST /v1/contacts. Provide either rows or csv.

csv

string

Raw CSV text. First line is treated as headers unless has_header is false. Provide either rows or csv.

has_header

boolean

default:"true"

Applies only to CSV imports.

mapping

object

CSV-only. Maps CSV header names to contact field names (e.g. { "Email Address": "email", "Full Name": "full_name" }). Unknown columns are ignored.

update_existing

boolean

default:"false"

When true, rows with matching email or phone are updated; when false, they are skipped.

Response

data

object

Show properties

job_id

string

Import job identifier

status

string

completed (synchronous) or queued

created_count

integer

New contacts created (only present when completed)

updated_count

integer

Contacts updated

skipped_count

integer

Rows that were not imported

errors

array

Array of { row_number, code, message } for any failed rows

Responses include X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset, and X-Request-ID. Large imports emit an import.completed webhook event when done.

curl -X POST \
  https://data.leadlex.com/functions/v1/api-gateway/v1/import/contacts \
  -H "Authorization: Bearer wbk_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "rows": [
      { "full_name": "Jane Doe", "email": "jane@acme.com" },
      { "full_name": "Bob Smith", "email": "bob@beta.com" }
    ]
  }'

Example Response

{
  "data": {
    "job_id": "imp_01HY1",
    "status": "completed",
    "created_count": 2,
    "updated_count": 0,
    "skipped_count": 0,
    "errors": []
  }
}

Errors

Status	Code	Description
400	`validation_error`	Neither `rows` nor `csv` provided, or mapping is malformed
401	`invalid_key`	Invalid or expired API key
403	`insufficient_permissions`	Missing `write:contacts` permission
413	`payload_too_large`	Payload exceeds 20 MB
429	`rate_limited`	Rate limit exceeded

List Deal Documents Import Companies

​Request

​Headers

​Body Parameters

​Response

​Example Response

​Errors

Request

Headers

Body Parameters

Response

Example Response

Errors