Create or update up to 100 companies by domain
curl --request POST \
--url https://api.enrik.ai/v1/companies/bulk-upsert \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"items": [
{
"domain": "https://www.example.com",
"name": "Analytical Engines",
"industry": "Software"
},
{
"domain": "shared.example",
"industry": "Energy"
}
]
}
'import requests
url = "https://api.enrik.ai/v1/companies/bulk-upsert"
payload = { "items": [
{
"domain": "https://www.example.com",
"name": "Analytical Engines",
"industry": "Software"
},
{
"domain": "shared.example",
"industry": "Energy"
}
] }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
items: [
{
domain: 'https://www.example.com',
name: 'Analytical Engines',
industry: 'Software'
},
{domain: 'shared.example', industry: 'Energy'}
]
})
};
fetch('https://api.enrik.ai/v1/companies/bulk-upsert', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.enrik.ai/v1/companies/bulk-upsert",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'items' => [
[
'domain' => 'https://www.example.com',
'name' => 'Analytical Engines',
'industry' => 'Software'
],
[
'domain' => 'shared.example',
'industry' => 'Energy'
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.enrik.ai/v1/companies/bulk-upsert"
payload := strings.NewReader("{\n \"items\": [\n {\n \"domain\": \"https://www.example.com\",\n \"name\": \"Analytical Engines\",\n \"industry\": \"Software\"\n },\n {\n \"domain\": \"shared.example\",\n \"industry\": \"Energy\"\n }\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.enrik.ai/v1/companies/bulk-upsert")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"items\": [\n {\n \"domain\": \"https://www.example.com\",\n \"name\": \"Analytical Engines\",\n \"industry\": \"Software\"\n },\n {\n \"domain\": \"shared.example\",\n \"industry\": \"Energy\"\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.enrik.ai/v1/companies/bulk-upsert")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"items\": [\n {\n \"domain\": \"https://www.example.com\",\n \"name\": \"Analytical Engines\",\n \"industry\": \"Software\"\n },\n {\n \"domain\": \"shared.example\",\n \"industry\": \"Energy\"\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"results": [
{
"index": 0,
"outcome": "created",
"company": {
"id": "0199a1b2-0000-7000-8000-00000000d101",
"workspaceId": "0199a1b2-0000-7000-8000-00000000b001",
"name": "Analytical Engines",
"domain": "example.com",
"website": "https://example.com",
"industry": "Software",
"employeeCount": 120,
"annualRevenue": 12500000,
"address": {
"city": "Vienna",
"country": "AT"
},
"linkedinUrl": null,
"country": "Austria",
"summary": "Builds engines that compute.",
"city": "Vienna",
"legalForm": "GmbH",
"registerNumber": "FN 123456a",
"buildingEnergyTags": null,
"ownerUserId": "0199a1b2-0000-7000-8000-00000000c001",
"customFields": {
"segment": "enterprise"
},
"canonicalCompanyId": null,
"enrikUpdateAvailable": false,
"enrikSnapshotVersion": null,
"createdBy": "0199a1b2-0000-7000-8000-00000000c001",
"updatedBy": "0199a1b2-0000-7000-8000-00000000c001",
"createdAt": "2026-09-29T08:00:00.000Z",
"updatedAt": "2026-09-29T08:00:00.000Z",
"deletedAt": null,
"signalSummary": null
}
},
{
"index": 1,
"outcome": "failed",
"error": {
"code": "conflict",
"message": "More than one live company has this domain",
"requestId": "5b1d3c1e-8d6f-4f2a-9a57-3a9b1f2c7d10",
"details": {
"code": "ambiguous_domain",
"companyIds": [
"0199a1b2-0000-7000-8000-00000000d102",
"0199a1b2-0000-7000-8000-00000000d103"
]
}
}
}
],
"created": 1,
"updated": 0,
"failed": 1
}{
"error": {
"code": "malformed_json",
"message": "Bad Request",
"requestId": "5b1d3c1e-8d6f-4f2a-9a57-3a9b1f2c7d10"
}
}{
"error": {
"code": "unauthenticated",
"message": "Unauthorized",
"requestId": "5b1d3c1e-8d6f-4f2a-9a57-3a9b1f2c7d10"
}
}{
"error": {
"code": "insufficient_scope",
"message": "Forbidden",
"requestId": "5b1d3c1e-8d6f-4f2a-9a57-3a9b1f2c7d10"
}
}{
"error": {
"code": "conflict",
"message": "Conflict",
"requestId": "5b1d3c1e-8d6f-4f2a-9a57-3a9b1f2c7d10"
}
}{
"error": {
"code": "payload_too_large",
"message": "Payload Too Large",
"requestId": "5b1d3c1e-8d6f-4f2a-9a57-3a9b1f2c7d10"
}
}{
"error": {
"code": "unsupported_media_type",
"message": "Unsupported Media Type",
"requestId": "5b1d3c1e-8d6f-4f2a-9a57-3a9b1f2c7d10"
}
}{
"error": {
"code": "validation_error",
"message": "Unprocessable Entity",
"requestId": "5b1d3c1e-8d6f-4f2a-9a57-3a9b1f2c7d10"
}
}{
"error": {
"code": "rate_limited",
"message": "Too many requests",
"requestId": "5b1d3c1e-8d6f-4f2a-9a57-3a9b1f2c7d10"
}
}{
"error": {
"code": "internal_error",
"message": "Internal Server Error",
"requestId": "5b1d3c1e-8d6f-4f2a-9a57-3a9b1f2c7d10"
}
}{
"error": {
"code": "service_unavailable",
"message": "Service Unavailable",
"requestId": "5b1d3c1e-8d6f-4f2a-9a57-3a9b1f2c7d10"
}
}{
"error": {
"code": "not_found",
"message": "Not found",
"requestId": "5b1d3c1e-8d6f-4f2a-9a57-3a9b1f2c7d10"
}
}companies
Create or update up to 100 companies by domain
Creates or updates up to 100 companies, each found by its domain as companies.upsert finds it: a company created needs name (else the item fails with validation_error at name), and a domain more than one live company has fails the item with conflict, details.code ambiguous_domain. The body is checked as a whole first: a malformed item refuses the request with 422 validation_error at its path, such as items.3.name, and nothing is written. Then the items run one after another, each in its own transaction, so one that fails leaves the others written. The answer is 200 with one result per item, in order, and the counts: a written item has outcome created or updated and the record; a failed one has outcome failed and an error in the error envelope’s shape, with the code and details the single upsert would have answered. Every item is keyed by its natural key, so sending the same body again is harmless: no Idempotency-Key is taken, and a failed request or failed items can simply be sent again. A request counts against the api-key-bulk rate-limit policy as well as api-key.
POST
/
v1
/
companies
/
bulk-upsert
Create or update up to 100 companies by domain
curl --request POST \
--url https://api.enrik.ai/v1/companies/bulk-upsert \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"items": [
{
"domain": "https://www.example.com",
"name": "Analytical Engines",
"industry": "Software"
},
{
"domain": "shared.example",
"industry": "Energy"
}
]
}
'import requests
url = "https://api.enrik.ai/v1/companies/bulk-upsert"
payload = { "items": [
{
"domain": "https://www.example.com",
"name": "Analytical Engines",
"industry": "Software"
},
{
"domain": "shared.example",
"industry": "Energy"
}
] }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
items: [
{
domain: 'https://www.example.com',
name: 'Analytical Engines',
industry: 'Software'
},
{domain: 'shared.example', industry: 'Energy'}
]
})
};
fetch('https://api.enrik.ai/v1/companies/bulk-upsert', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.enrik.ai/v1/companies/bulk-upsert",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'items' => [
[
'domain' => 'https://www.example.com',
'name' => 'Analytical Engines',
'industry' => 'Software'
],
[
'domain' => 'shared.example',
'industry' => 'Energy'
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.enrik.ai/v1/companies/bulk-upsert"
payload := strings.NewReader("{\n \"items\": [\n {\n \"domain\": \"https://www.example.com\",\n \"name\": \"Analytical Engines\",\n \"industry\": \"Software\"\n },\n {\n \"domain\": \"shared.example\",\n \"industry\": \"Energy\"\n }\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.enrik.ai/v1/companies/bulk-upsert")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"items\": [\n {\n \"domain\": \"https://www.example.com\",\n \"name\": \"Analytical Engines\",\n \"industry\": \"Software\"\n },\n {\n \"domain\": \"shared.example\",\n \"industry\": \"Energy\"\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.enrik.ai/v1/companies/bulk-upsert")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"items\": [\n {\n \"domain\": \"https://www.example.com\",\n \"name\": \"Analytical Engines\",\n \"industry\": \"Software\"\n },\n {\n \"domain\": \"shared.example\",\n \"industry\": \"Energy\"\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"results": [
{
"index": 0,
"outcome": "created",
"company": {
"id": "0199a1b2-0000-7000-8000-00000000d101",
"workspaceId": "0199a1b2-0000-7000-8000-00000000b001",
"name": "Analytical Engines",
"domain": "example.com",
"website": "https://example.com",
"industry": "Software",
"employeeCount": 120,
"annualRevenue": 12500000,
"address": {
"city": "Vienna",
"country": "AT"
},
"linkedinUrl": null,
"country": "Austria",
"summary": "Builds engines that compute.",
"city": "Vienna",
"legalForm": "GmbH",
"registerNumber": "FN 123456a",
"buildingEnergyTags": null,
"ownerUserId": "0199a1b2-0000-7000-8000-00000000c001",
"customFields": {
"segment": "enterprise"
},
"canonicalCompanyId": null,
"enrikUpdateAvailable": false,
"enrikSnapshotVersion": null,
"createdBy": "0199a1b2-0000-7000-8000-00000000c001",
"updatedBy": "0199a1b2-0000-7000-8000-00000000c001",
"createdAt": "2026-09-29T08:00:00.000Z",
"updatedAt": "2026-09-29T08:00:00.000Z",
"deletedAt": null,
"signalSummary": null
}
},
{
"index": 1,
"outcome": "failed",
"error": {
"code": "conflict",
"message": "More than one live company has this domain",
"requestId": "5b1d3c1e-8d6f-4f2a-9a57-3a9b1f2c7d10",
"details": {
"code": "ambiguous_domain",
"companyIds": [
"0199a1b2-0000-7000-8000-00000000d102",
"0199a1b2-0000-7000-8000-00000000d103"
]
}
}
}
],
"created": 1,
"updated": 0,
"failed": 1
}{
"error": {
"code": "malformed_json",
"message": "Bad Request",
"requestId": "5b1d3c1e-8d6f-4f2a-9a57-3a9b1f2c7d10"
}
}{
"error": {
"code": "unauthenticated",
"message": "Unauthorized",
"requestId": "5b1d3c1e-8d6f-4f2a-9a57-3a9b1f2c7d10"
}
}{
"error": {
"code": "insufficient_scope",
"message": "Forbidden",
"requestId": "5b1d3c1e-8d6f-4f2a-9a57-3a9b1f2c7d10"
}
}{
"error": {
"code": "conflict",
"message": "Conflict",
"requestId": "5b1d3c1e-8d6f-4f2a-9a57-3a9b1f2c7d10"
}
}{
"error": {
"code": "payload_too_large",
"message": "Payload Too Large",
"requestId": "5b1d3c1e-8d6f-4f2a-9a57-3a9b1f2c7d10"
}
}{
"error": {
"code": "unsupported_media_type",
"message": "Unsupported Media Type",
"requestId": "5b1d3c1e-8d6f-4f2a-9a57-3a9b1f2c7d10"
}
}{
"error": {
"code": "validation_error",
"message": "Unprocessable Entity",
"requestId": "5b1d3c1e-8d6f-4f2a-9a57-3a9b1f2c7d10"
}
}{
"error": {
"code": "rate_limited",
"message": "Too many requests",
"requestId": "5b1d3c1e-8d6f-4f2a-9a57-3a9b1f2c7d10"
}
}{
"error": {
"code": "internal_error",
"message": "Internal Server Error",
"requestId": "5b1d3c1e-8d6f-4f2a-9a57-3a9b1f2c7d10"
}
}{
"error": {
"code": "service_unavailable",
"message": "Service Unavailable",
"requestId": "5b1d3c1e-8d6f-4f2a-9a57-3a9b1f2c7d10"
}
}{
"error": {
"code": "not_found",
"message": "Not found",
"requestId": "5b1d3c1e-8d6f-4f2a-9a57-3a9b1f2c7d10"
}
}Authorizations
An Enrik API key, sent as Authorization: Bearer <key>. A key reaches public operations only, and only those whose scopes it holds. A few parameters need a scope beyond their operation’s, which the parameter names. The scopes:
setup:read: Read the workspace setup and its company profile.setup:run: Change the setup: confirm the company profile, authorize sponsored drafting and background company research, choose what to set up and complete setup.workspace:read: Read the workspace’s own profile: its health summary and setup state.crm:read: Read companies with their signals, contacts and the saved views over them.crm:write: Create, update and restore companies and contacts, and create, update and delete saved views.crm:delete: Delete companies and contacts.twin:read: Read the Company Twin: structured company knowledge and its signals.discovery:read: Read ICP profiles, ICP assessments, discovery briefs, discovery jobs, candidates and the signal library.discovery:write: Create and change ICP profiles, discovery briefs and signal-definition drafts, and review discovery candidates.discovery:run: Create, start and cancel discovery jobs, and edit a draft one. Uses provider budget.enrichment:read: Read the enrichment configuration and its results, including a record’s enrichment, formula and custom-API cells.enrichment:run: Launch and cancel enrichment. Spends enrichment credits.automation:read: Read workflows and agents with their run history, including a record’s agent cells.automation:run: Run existing workflows and agents.exports:read: Read export jobs and the fields an export can carry.exports:run: Create, preview, start, cancel and archive CSV exports of companies, contacts and candidates, and download the file. Also needscrm:read. Delivering an export to a webhook destination stays in the app.integrations:read: Read connections, field mappings, CRM sync jobs and webhook destinations.webhooks:read: Read webhook subscriptions, the event types they can name and their delivery log.webhooks:write: Subscribe a receiver URL to webhook events; edit, test, pause, resume and archive a subscription and rotate its signing secret; redeliver an event. Only workspace owners and admins can grant it.reporting:read: Read analytics and dashboards.assistant:read: Read the Assistant: its threads, messages and pending approvals.assistant:run: Converse with the Assistant. Uses the workspace’s AI quota.assistant:write: Approve or reject the changes the Assistant proposes.
Body
application/json
Up to 100 companies to create or update by domain.
The companies, each as companies.upsert takes it, 1 to 100. The whole body is checked first: one malformed item refuses the request with 422 validation_error at its path, such as items.3.name, and nothing is written.
Required array length:
1 - 100 elementsShow child attributes
Show child attributes
Response
What a bulk write did, item by item.
What a bulk write did, item by item.
One result per item, in the order of items.
A company a bulk write created or updated.
- Option 1
- Option 2
Show child attributes
Show child attributes
How many items created a record.
Required range:
-9007199254740991 <= x <= 9007199254740991How many items updated a record.
Required range:
-9007199254740991 <= x <= 9007199254740991How many items failed.
Required range:
-9007199254740991 <= x <= 9007199254740991Was this page helpful?