API

레코드 일괄 수정

작성일 2026.04.23 | 수정일 2026.04.23

POST/crm-core/v1/records/bulk/update
여러 레코드의 속성값(data)을 동일한 값으로 일괄 업데이트합니다. 한 번에 최대 1000개. 전달된 data 맵이 각 레코드에 병합 적용됩니다. MEMBER 이상 권한이 필요합니다.

Body Params

NameTypeRequiredDescription
recordIdsArray업데이트할 레코드 ID 목록 (최대 1000개)
dataObject모든 대상 레코드에 적용할 속성값 맵 (키는 속성 ID)

Response

NameTypeRequiredDescription
updatedCountnumber*업데이트된 레코드 수

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).