Update contact
Requires contacts:write. Requires If-Match and Idempotency-Key. Omitted fields remain unchanged. Returns persisted confirmation, not the full detail. Primary email and mobile are read-only. Omit both from PATCH bodies, including unchanged values and nulls. Supplying either returns 422 CONTACT_IDENTITY_READ_ONLY without applying any changes. Reading and filtering remain supported.
curl -X PATCH "https://app.inrepli.com/v1/contacts/example_string" \
-H "Content-Type: application/json" \
-H "If-Match: example_string" \
-H "Idempotency-Key: example_string" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-d '{
"position": "Manager",
"notes": "Requested a follow-up."
}'
import requests
import json
url = "https://app.inrepli.com/v1/contacts/example_string"
headers = {
"Content-Type": "application/json",
"If-Match": "example_string",
"Idempotency-Key": "example_string",
"Authorization": "Bearer YOUR_API_TOKEN"
}
data = {
"position": "Manager",
"notes": "Requested a follow-up."
}
response = requests.patch(url, headers=headers, json=data)
print(response.json())
const response = await fetch("https://app.inrepli.com/v1/contacts/example_string", {
method: "PATCH",
headers: {
"Content-Type": "application/json",
"If-Match": "example_string",
"Idempotency-Key": "example_string",
"Authorization": "Bearer YOUR_API_TOKEN"
},
body: JSON.stringify({
"position": "Manager",
"notes": "Requested a follow-up."
})
});
const data = await response.json();
console.log(data);
package main
import (
"fmt"
"net/http"
"bytes"
"encoding/json"
)
func main() {
data := []byte(`{
"position": "Manager",
"notes": "Requested a follow-up."
}`)
req, err := http.NewRequest("PATCH", "https://app.inrepli.com/v1/contacts/example_string", bytes.NewBuffer(data))
if err != nil {
panic(err)
}
req.Header.Set("Content-Type", "application/json")
req.Header.Set("If-Match", "example_string")
req.Header.Set("Idempotency-Key", "example_string")
req.Header.Set("Authorization", "Bearer YOUR_API_TOKEN")
client := &http.Client{}
resp, err := client.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
fmt.Println("Response Status:", resp.Status)
}
require 'net/http'
require 'json'
uri = URI('https://app.inrepli.com/v1/contacts/example_string')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(uri)
request['Content-Type'] = 'application/json'
request['If-Match'] = 'example_string'
request['Idempotency-Key'] = 'example_string'
request['Authorization'] = 'Bearer YOUR_API_TOKEN'
request.body = '{
"position": "Manager",
"notes": "Requested a follow-up."
}'
response = http.request(request)
puts response.body
{
"data": {
"id": "example-id-2",
"name": "Example contact",
"firstName": null,
"lastName": null,
"email": "contact@example.test",
"mobile": null,
"position": "Manager",
"company": null,
"companyId": null,
"ownerId": null,
"qualification": true,
"createdAt": "2026-09-09T06:34:58.379Z",
"updatedAt": "2026-09-09T06:34:58.895Z",
"notes": "Requested a follow-up.",
"etag": ""2026-09-09T06:34:58.895Z"",
"location": {
"country": null,
"region": null,
"city": null
},
"customFields": {
"segment": "enterprise"
}
}
}
{
"error": "Bad Request",
"message": "The request contains invalid parameters or malformed data",
"code": 400,
"details": [
{
"field": "email",
"message": "Invalid email format"
}
]
}
{
"error": "Unauthorized",
"message": "Authentication required. Please provide a valid API token",
"code": 401
}
{
"error": "Forbidden",
"message": "You don't have permission to access this resource",
"code": 403
}
{
"error": "Not Found",
"message": "The requested resource was not found",
"code": 404
}
{
"error": "Conflict",
"message": "The request conflicts with the current state of the resource",
"code": 409,
"details": "Resource already exists"
}
{
"error": "Error",
"message": "ETag mismatch.",
"code": 412
}
{
"error": "Unprocessable Entity",
"message": "The request was well-formed but contains semantic errors",
"code": 422,
"details": [
{
"field": "password",
"message": "Password must be at least 8 characters long"
}
]
}
{
"error": "Error",
"message": "If-Match is required.",
"code": 428
}
{
"error": "Too Many Requests",
"message": "Rate limit exceeded. Please try again later",
"code": 429,
"retryAfter": 3600
}
{
"error": "Internal Server Error",
"message": "An unexpected error occurred on the server",
"code": 500,
"requestId": "req_1234567890"
}
{
"error": "Service Unavailable",
"message": "The service is temporarily unavailable. Please try again later",
"code": 503
}
/contacts/{id}Target server for requests. Edit to use your own host.
Tenant API key beginning with inr_v1_.
The media type of the request body
Use the quoted etag from a list item, detail or previous PATCH. Missing: 428; stale: 412. Read is not implied by write.
Use a unique key for each logical update. Retry the exact body, resource and If-Match with the same key. Stored response expires after 24 hours; reuse with a different request during retention returns 409.
Active custom definition keys. Omitted keys remain unchanged; null clears a value. Select values use options[].value from definitions (valueKey), never option IDs. DECIMAL requires an exact string (20 integer and 10 fractional digits maximum). DATE uses YYYY-MM-DD; DATETIME uses an ISO timestamp. Updating values requires the resource write scope and current customFieldsEditable plan eligibility, not custom-fields:read.
Request Preview
Response
Response will appear here after sending the request
Authentication
Bearer token. Tenant API key beginning with inr_v1_.
Path Parameters
Headers
Use the quoted etag from a list item, detail or previous PATCH. Missing: 428; stale: 412. Read is not implied by write.
Use a unique key for each logical update. Retry the exact body, resource and If-Match with the same key. Stored response expires after 24 hours; reuse with a different request during retention returns 409.
Body
Active custom definition keys. Omitted keys remain unchanged; null clears a value. Select values use options[].value from definitions (valueKey), never option IDs. DECIMAL requires an exact string (20 integer and 10 fractional digits maximum). DATE uses YYYY-MM-DD; DATETIME uses an ISO timestamp. Updating values requires the resource write scope and current customFieldsEditable plan eligibility, not custom-fields:read.
Responses
Compact persisted confirmation. Core fields and all active custom values are returned; notes/language/timezone/industry appear only when submitted. This is not a full detail response.