Skip to main content
POST
Import Companies

Request

Supply either a rows array or a raw csv string. Imports up to 500 rows are synchronous; larger payloads are queued and tracked via job_id.

Headers

string
Strongly recommended. Returns the original result (including job_id) within 24 hours when replayed.

Body Parameters

array
Array of company objects with the same fields accepted by POST /v1/companies.
string
Raw CSV string. Provide either rows or csv.
boolean
default:"true"
Applies only to CSV imports.
object
CSV-only. Maps CSV header names to company fields (e.g. { "Company": "name", "Website": "domain" }).
boolean
default:"false"
When true, rows with matching domain are updated; when false, they are skipped.
array
Optional array of tag strings applied to every imported company.

Response

object
Responses include X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset, and X-Request-ID.

Example Response

Errors