Update up to 100 contacts
curl --request POST \
--url https://api.enrik.ai/v1/contacts/bulk-update \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"items": [
{
"id": "0199a1b2-0000-7000-8000-00000000c101",
"jobTitle": "CTO"
},
{
"id": "0199a1b2-0000-7000-8000-00000000c104",
"phone": null,
"expectedUpdatedAt": "2026-09-29T08:00:00.000Z"
}
]
}
'import requests
url = "https://api.enrik.ai/v1/contacts/bulk-update"
payload = { "items": [
{
"id": "0199a1b2-0000-7000-8000-00000000c101",
"jobTitle": "CTO"
},
{
"id": "0199a1b2-0000-7000-8000-00000000c104",
"phone": None,
"expectedUpdatedAt": "2026-09-29T08:00:00.000Z"
}
] }
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: [
{id: '0199a1b2-0000-7000-8000-00000000c101', jobTitle: 'CTO'},
{
id: '0199a1b2-0000-7000-8000-00000000c104',
phone: null,
expectedUpdatedAt: '2026-09-29T08:00:00.000Z'
}
]
})
};
fetch('https://api.enrik.ai/v1/contacts/bulk-update', 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/contacts/bulk-update",
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' => [
[
'id' => '0199a1b2-0000-7000-8000-00000000c101',
'jobTitle' => 'CTO'
],
[
'id' => '0199a1b2-0000-7000-8000-00000000c104',
'phone' => null,
'expectedUpdatedAt' => '2026-09-29T08:00:00.000Z'
]
]
]),
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/contacts/bulk-update"
payload := strings.NewReader("{\n \"items\": [\n {\n \"id\": \"0199a1b2-0000-7000-8000-00000000c101\",\n \"jobTitle\": \"CTO\"\n },\n {\n \"id\": \"0199a1b2-0000-7000-8000-00000000c104\",\n \"phone\": null,\n \"expectedUpdatedAt\": \"2026-09-29T08:00:00.000Z\"\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/contacts/bulk-update")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"items\": [\n {\n \"id\": \"0199a1b2-0000-7000-8000-00000000c101\",\n \"jobTitle\": \"CTO\"\n },\n {\n \"id\": \"0199a1b2-0000-7000-8000-00000000c104\",\n \"phone\": null,\n \"expectedUpdatedAt\": \"2026-09-29T08:00:00.000Z\"\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.enrik.ai/v1/contacts/bulk-update")
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 \"id\": \"0199a1b2-0000-7000-8000-00000000c101\",\n \"jobTitle\": \"CTO\"\n },\n {\n \"id\": \"0199a1b2-0000-7000-8000-00000000c104\",\n \"phone\": null,\n \"expectedUpdatedAt\": \"2026-09-29T08:00:00.000Z\"\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"results": [
{
"index": 0,
"outcome": "updated",
"contact": {
"id": "0199a1b2-0000-7000-8000-00000000c101",
"workspaceId": "0199a1b2-0000-7000-8000-00000000b001",
"firstName": "Ada",
"lastName": "Lovelace",
"email": "ada@example.com",
"phone": "+43 1 234 5678",
"jobTitle": "CTO",
"ownerUserId": "0199a1b2-0000-7000-8000-00000000c001",
"companyId": "0199a1b2-0000-7000-8000-00000000d101",
"customFields": {
"tier": "gold"
},
"createdBy": "0199a1b2-0000-7000-8000-00000000c001",
"updatedBy": "0199a1b2-0000-7000-8000-00000000c001",
"createdAt": "2026-09-29T08:00:00.000Z",
"updatedAt": "2026-09-30T09:30:00.000Z",
"deletedAt": null
}
},
{
"index": 1,
"outcome": "failed",
"error": {
"code": "stale_version",
"message": "This record changed since it was read; re-read it and retry",
"requestId": "5b1d3c1e-8d6f-4f2a-9a57-3a9b1f2c7d10",
"details": {
"resourceType": "contact",
"resourceId": "0199a1b2-0000-7000-8000-00000000c104",
"currentUpdatedAt": "2026-09-30T09:30:00.000Z"
}
}
}
],
"created": 0,
"updated": 1,
"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"
}
}contacts
Update up to 100 contacts
Changes up to 100 contacts, each item the body contacts.update takes plus the id of the record to change. 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: an id that is not a live record of the workspace fails with not_found, and an expectedUpdatedAt the record has changed since fails with stale_version, nothing written for it. The answer is 200 with one result per item, in order, and the counts: a written item has outcome updated and the record; a failed one has outcome failed and an error in the error envelope’s shape, with the code and details contacts.update would have answered. Like contacts.update, it takes no Idempotency-Key: sending the same body again is harmless, though an item sent with expectedUpdatedAt then fails with stale_version when the first request changed the record. A request counts against the api-key-bulk rate-limit policy as well as api-key.
POST
/
v1
/
contacts
/
bulk-update
Update up to 100 contacts
curl --request POST \
--url https://api.enrik.ai/v1/contacts/bulk-update \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"items": [
{
"id": "0199a1b2-0000-7000-8000-00000000c101",
"jobTitle": "CTO"
},
{
"id": "0199a1b2-0000-7000-8000-00000000c104",
"phone": null,
"expectedUpdatedAt": "2026-09-29T08:00:00.000Z"
}
]
}
'import requests
url = "https://api.enrik.ai/v1/contacts/bulk-update"
payload = { "items": [
{
"id": "0199a1b2-0000-7000-8000-00000000c101",
"jobTitle": "CTO"
},
{
"id": "0199a1b2-0000-7000-8000-00000000c104",
"phone": None,
"expectedUpdatedAt": "2026-09-29T08:00:00.000Z"
}
] }
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: [
{id: '0199a1b2-0000-7000-8000-00000000c101', jobTitle: 'CTO'},
{
id: '0199a1b2-0000-7000-8000-00000000c104',
phone: null,
expectedUpdatedAt: '2026-09-29T08:00:00.000Z'
}
]
})
};
fetch('https://api.enrik.ai/v1/contacts/bulk-update', 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/contacts/bulk-update",
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' => [
[
'id' => '0199a1b2-0000-7000-8000-00000000c101',
'jobTitle' => 'CTO'
],
[
'id' => '0199a1b2-0000-7000-8000-00000000c104',
'phone' => null,
'expectedUpdatedAt' => '2026-09-29T08:00:00.000Z'
]
]
]),
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/contacts/bulk-update"
payload := strings.NewReader("{\n \"items\": [\n {\n \"id\": \"0199a1b2-0000-7000-8000-00000000c101\",\n \"jobTitle\": \"CTO\"\n },\n {\n \"id\": \"0199a1b2-0000-7000-8000-00000000c104\",\n \"phone\": null,\n \"expectedUpdatedAt\": \"2026-09-29T08:00:00.000Z\"\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/contacts/bulk-update")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"items\": [\n {\n \"id\": \"0199a1b2-0000-7000-8000-00000000c101\",\n \"jobTitle\": \"CTO\"\n },\n {\n \"id\": \"0199a1b2-0000-7000-8000-00000000c104\",\n \"phone\": null,\n \"expectedUpdatedAt\": \"2026-09-29T08:00:00.000Z\"\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.enrik.ai/v1/contacts/bulk-update")
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 \"id\": \"0199a1b2-0000-7000-8000-00000000c101\",\n \"jobTitle\": \"CTO\"\n },\n {\n \"id\": \"0199a1b2-0000-7000-8000-00000000c104\",\n \"phone\": null,\n \"expectedUpdatedAt\": \"2026-09-29T08:00:00.000Z\"\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"results": [
{
"index": 0,
"outcome": "updated",
"contact": {
"id": "0199a1b2-0000-7000-8000-00000000c101",
"workspaceId": "0199a1b2-0000-7000-8000-00000000b001",
"firstName": "Ada",
"lastName": "Lovelace",
"email": "ada@example.com",
"phone": "+43 1 234 5678",
"jobTitle": "CTO",
"ownerUserId": "0199a1b2-0000-7000-8000-00000000c001",
"companyId": "0199a1b2-0000-7000-8000-00000000d101",
"customFields": {
"tier": "gold"
},
"createdBy": "0199a1b2-0000-7000-8000-00000000c001",
"updatedBy": "0199a1b2-0000-7000-8000-00000000c001",
"createdAt": "2026-09-29T08:00:00.000Z",
"updatedAt": "2026-09-30T09:30:00.000Z",
"deletedAt": null
}
},
{
"index": 1,
"outcome": "failed",
"error": {
"code": "stale_version",
"message": "This record changed since it was read; re-read it and retry",
"requestId": "5b1d3c1e-8d6f-4f2a-9a57-3a9b1f2c7d10",
"details": {
"resourceType": "contact",
"resourceId": "0199a1b2-0000-7000-8000-00000000c104",
"currentUpdatedAt": "2026-09-30T09:30:00.000Z"
}
}
}
],
"created": 0,
"updated": 1,
"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 contacts to change.
The contacts to change, each by its id, 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 contact 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?