레코드 일괄 수정
작성일 2026.04.23 | 수정일 2026.04.23
POST/crm-core/v1/records/bulk/update
여러 레코드의 속성값(data)을 동일한 값으로 일괄 업데이트합니다. 한 번에 최대 1000개. 전달된 data 맵이 각 레코드에 병합 적용됩니다. MEMBER 이상 권한이 필요합니다.
Body Params
| Name | Type | Required | Description |
|---|---|---|---|
| recordIds | Array | 업데이트할 레코드 ID 목록 (최대 1000개) | |
| data | Object | 모든 대상 레코드에 적용할 속성값 맵 (키는 속성 ID) |
Response
| Name | Type | Required | Description |
|---|---|---|---|
| updatedCount | number | * | 업데이트된 레코드 수 |
Structure
코드 예제
await fetch('https://api.solapi.com/crm-core/v1/records/bulk/update', {
method: 'POST',
headers: {
'Authorization': 'Bearer ' + TOKEN,
'Content-Type': 'application/json'
},
body: JSON.stringify({
recordIds: ['CRMRC1...', 'CRMRC2...'],
data: { 'CRMPP1260423091530123STAT1112223': 'ACTIVE' }
})
});
import requests
requests.post(
'https://api.solapi.com/crm-core/v1/records/bulk/update',
headers={'Authorization': f'Bearer {TOKEN}'},
json={
'recordIds': ['CRMRC1...', 'CRMRC2...'],
'data': {'CRMPP1260423091530123STAT1112223': 'ACTIVE'}
}
)
curl -X POST 'https://api.solapi.com/crm-core/v1/records/bulk/update' \
-H 'Authorization: Bearer YOUR_TOKEN' \
-H 'Content-Type: application/json' \
-d '{"recordIds":["CRMRC1..."],"data":{"status":"ACTIVE"}}'
lightbulb
수천 건 이상 대량 업데이트나 필터 조건 기반 대상 선정이 필요하면 스트리밍 버전 `POST /crm-core/v1/records/bulk/update-stream`을 사용하세요(최대 5000건, 실시간 진행률 SSE).