마지막 업데이트 날짜: 2026년 4월 14일
HubSpot으로 데이터를 가져오기 전에, 파일이 필수 형식 및 기술적 제한 사항을 충족하는지 확인하십시오. 일부 제한 사항은 구독 유형에 따라 다를 수 있습니다. 지원되는 파일 유형, 속성 값의 구성 및 서식 지정 방법, 그리고 특정 기간 내에 가져올 수 있는 행 수와 파일 수를 숙지하십시오.
가져오기 전에 ‘가져오기 시작하기’ 문서를 확인하십시오.
기술적 요구 사항 및 제한 사항
HubSpot으로 가져오는 모든 파일은 다음 조건을 충족해야 합니다:- .csv, .xlsx 또는 .xls 파일이어야 합니다.
- 시트가 하나만 포함되어야 합니다.
- 각 열 머리글이 HubSpot의 속성과 일치하는 헤더 행이 포함되어야 합니다. 열 머리글은 가져오기에 영향을 주지 않는 한 어떤 순서로든 구성할 수 있습니다. 가져오기 전에 헤더와 일치하는 기본 속성이 이미 있는지 확인하거나 사용자 지정 속성을 생성할 수 있습니다. 속성 요구 사항에 대해 자세히 알아보세요.
- 열 수가 1,000개 미만이어야 합니다.
- 파일에 외국어 문자가 포함된 경우 UTF-8로 인코딩되어야 합니다.
- Excel 파일을 가져오는 경우:
- 데이터가 Excel의 워크시트 및 통합 문서 최대 제한을 초과하지 않아야 합니다.
- 날짜 및 시간 선택기 속성을 가져올 때는 셀 형식을 '숫자'로 설정해야 합니다.
HubSpot 구독 유형에 따라 가져오기 도구에 추가적인 기술적 제한이 적용됩니다. 이러한 제한에는 가져오기 파일의 크기 및 행 수 제한은 물론, 하루에 가져올 수 있는 파일 수와 행 수가 포함됩니다.
- HubSpot의 무료 도구를 사용하는 경우 다음이 가능합니다:
- 최대 20MB 크기의 파일을 가져올 수 있습니다.
- 하루에 최대 50회까지 가져오기를 완료할 수 있습니다.
- 하루에 최대 500,000행까지 가져올 수 있습니다. 500,000행이 넘는 파일의 경우 완료하는 데 며칠이 소요될 수 있습니다.
- 최대 3개의 가져오기를 동시에 시작할 수 있습니다. 이 중 최대 2개는 10,000행 이상일 수 있습니다. 4개 이상의 가져오기를 동시에 시작하면 대기열에 추가됩니다.
- 계정에 Smart CRM 또는 Starter, Professional, Enterprise 구독이 있는 경우 다음을 수행할 수 있습니다:
- 최대 512MB 크기의 파일을 가져올 수 있습니다.
- 하루에 최대 500건의 가져오기를 완료할 수 있습니다.
- 하루에 최대 10,000,000행까지 가져올 수 있으며, 파일당 최대 1,048,576행으로 제한됩니다. 가져오기 API를 통해 가져오는 경우, 하루에 최대 80,000,000행까지 가져올 수 있습니다.
- 최대 3개의 가져오기를 동시에 시작할 수 있습니다. 이 중 최대 2개는 10,000행 이상일 수 있습니다. 4개 이상의 가져오기를 동시에 시작하면 대기열에 추가됩니다.
이러한 제한 사항은 24시간 이동 기간에 적용되며, 특정 시간에 재설정되지 않습니다. HubSpot 구독 및 관련 제한 사항에대해 자세히 알아보세요.
속성 값 서식 지정
가져오기 파일의 각 행에 대해 속성 열의 값을 추가할 수 있습니다. 값의 서식은 속성 필드 유형과 가져오기의 목적에 따라 달라집니다.
속성 필드 유형에 따른 값 서식 지정
속성 필드 유형에 따라 다음과 같은 특정 서식 지정 요구 사항이 있습니다:
| 필드 유형 | 요구 사항 |
| 날짜 선택기 날짜 및 시간 선택기 |
월은 숫자, 세 글자 또는 전체 이름(10, OCT, Oct, OCTOBER, October)으로 표기할 수 있으며, 연도는 두 자리 또는 네 자리(2023, 23)로 표기할 수 있고, 구분 기호는 슬래시, 하이픈 또는 마침표(10/28/2023, 10-28-2023, 10.28.2023) 일 수 있습니다 . 유효한 날짜 형식은 일-월-년(예: 28/10/2023), 월-일-년(예: 10-28-23) 또는 년-월-일(예: 2023.OCT.28)입니다. 유효성 검사 규칙을 설정한 경우, 가져오는 값은 해당 규칙을 따라야 하며, 그렇지 않으면 가져오기가 실패합니다. |
| 날짜 및 시간 선택기 |
타임스탬프는 모든 파일 형식에서 계정 시간대를 기준으로 한 시간대 오프셋은 |
| 기간 |
통화 시간 속성과 같이 지속 시간이 포함된 속성의 경우, 값은 밀리초 단위의 UNIX 타임스탬프 형식으로 지정해야 합니다. 타임스탬프 값의 형식 지정 방법 및 날짜를 UNIX 형식으로 변환하는 방법에 대해 자세히 알아보세요 . |
| 열거형 |
가져오기 파일의 값은 속성에 정의된 옵션의 레이블 또는 내부 값과 일치해야 합니다. HubSpot 기본 열거형 속성(예: 라이프사이클 단계, 산업)의 경우, 값은 내부 값 또는 영어로 된 레이블과 일치해야 합니다. |
| 파일 |
파일 속성에 기존 파일을 추가하려면 값으로 파일 ID를 포함하십시오. 파일의 ID는 파일 세부 정보의 '일반' 섹션에서 확인할 수 있습니다. |
| 여러 개의 선택 상자 |
여러 값을 가져오려면 각 값 사이에 공백 없이 세미콜론을 추가하십시오(값 1;값 2). 이러한 속성 옵션은 가져오기 전에 미리 생성되어 있어야 합니다. 값을 추가하거나 뒤쪽에 붙이려면첫 번째 값 앞에 세미콜론을 추가하십시오(;값 3;값 4). 이렇게 하면 기존 속성 값을 덮어쓰지 않고 값을 뒤쪽에 추가합니다. 여러 체크박스 값 가져오기에 대해 자세히 알아보세요. |
| 숫자 |
생성된 숫자 속성의 유형에 따라 값의 형식을 지정하세요:
|
| 단일 선택 상자 |
단일 선택 상자 필드에 대한 열을 생성하고, 각 행의 값을 True또는Yes로설정하면 HubSpot에서 '예' 또는 선택된 상태로 표시되며,False또는No로설정하면 HubSpot에서 '아니요' 또는 선택되지 않은 상태로 표시됩니다. |
| 기간 속성 |
단일 체크박스 필드에 대한 열을 생성하고 각 행의 값을 True 또는 Yes로 설정하면 HubSpot에서 Yes 또는 선택된 상태로 표시되며, False 또는 No로 설정하면 HubSpot에서 No 또는 선택되지 않은 상태로 표시됩니다. |
| 텍스트 |
설정한 경우 유효성 검사 규칙을 설정한 경우, 가져오는 값은 해당 규칙을 따라야 하며, 그렇지 않으면 가져오기가 실패합니다. |
| 사용자(소유자) |
가져오기 중에 레코드나 활동에 소유자를 지정하려면:
|
추가 연락처 이메일 또는 회사 도메인
이메일 주소가 두 개 이상인 연락처를 가져오는 경우, 보조 이메일 주소를 포함하는 '추가 이메일 주소' 열을 포함하십시오. 도메인 이름이 두 개 이상인 회사를 가져오는 경우, 보조 도메인을 포함하는 '추가 도메인' 열을 포함하십시오. 한 셀에 여러 이메일이나 도메인을 포함하려면 값을 세미콜론으로 구분하십시오(예: email@email.com; emailtwo@email.com).
연락처나 회사를 생성하기 위해 데이터를 가져오는 경우, 다른 레코드의 기존 추가 이메일/도메인과 동일한 이메일이나 도메인을 새 연락처의 이메일 또는 새 회사의 회사 도메인 이름으로 설정할 수 없습니다.
빈 셀
: 가져오기 도구는 스프레드시트의 빈 셀을 무시하므로, 새로운 속성 데이터를 가져올 때는 해당 속성에 값이 없는 레코드의 셀을 비워 두십시오. HubSpot 내의 기존 레코드에 이미 해당 속성의 값이 있는 경우, 빈 셀을 입력해도 기존 속성 값은 지워지지 않습니다. 기존 속성 값을 일괄적으로 지우려면, 값을 수동으로 편집하거나 '레코드 편집' 워크플로 작업을 사용할 수 있습니다 .딜 협업자
가져오기를 통해 딜에 협업자를 추가하는 경우, '딜 협업자' 헤더를 포함해야 합니다. 각 셀에는 세미콜론으로 구분된 두 명 이상의 사용자를 포함해야 합니다(예: user1@example.com;user2@example.com).상품 기간 및 청구 주기
기간 속성 값을 가져오는 경우, '기간' 열의 값을 월 단위의 숫자(예: 10개월인 경우 10 ), X 가 월 수인 PXM 형식 (예: 6개월인 경우 P6M), 또는 X가 년 수인 PXY 형식(예: 1년인 경우 P1Y)으로 지정할 수 있습니다.
청구 주기 속성 값을
가져오는
경우, 제품에 반복 결제 유형이 적용된 경우 monthly, annually 또는 quarterly를 사용하십시오. 제품에 일회성 가격이 적용된 경우 셀을 비워 두십시오.
필수 속성 포함
가져오는 개체나 활동에 따라 레코드를 생성하려면 다음 속성이 필수이며, 파일의 열 머리글로 반드시 포함되어야 합니다. 레코드를 업데이트하는 경우 고유 식별자 (예: 레코드 ID, 이메일, 회사 도메인 이름)를 포함해야 합니다.
필수사항은 아니지만,사용자 지정 속성 및 기본 속성을 포함하여 각 개체에 대한 추가 속성을 가져올 수 있습니다. 연락처, 회사, 거래, 티켓, 통화, 이메일, 회의, 메모 및 작업에 대한 기본 속성을 참조하십시오. 또한 속성 설정에서 모든 속성과 해당 값을 확인할 수 있습니다.
- 연락처: 이름, 성 또는 이메일 중 최소 하나 .
- 회사: 이름 또는 회사 도메인 이름 중 하나이상 .
참고: 회사 도메인 이름 속성은 최상위 도메인(예: .com, .edu)까지만 값을 허용합니다. 그 뒤에 문자열이 포함된 값(예: .edu/home)는 가져올 때 자동으로 제거됩니다.
- 거래: 새 거래를 생성하는 경우,거래 이름, 파이프라인 및 거래 단계.파이프라인과거래 단계는 계정의 기존 옵션과 일치해야 하며, 거래 단계는 해당 파이프라인에서 유효한 단계여야 합니다.
- 티켓: 새 티켓을 생성하는경우 , 티켓 이름, 파이프라인 및 티켓 상태.
- 약속: 약속 시작 시간. 약속 시작 시간은날짜-시간 형식으로 지정되어야 합니다.
- 코스: 코스 이름.
- 리스팅: 이름.
- 서비스: 이름, 파이프라인 및 파이프라인 단계.
- 상품: 상품을 업데이트하는 경우 , 레코드 ID 또는 SKU.
- 주문: 이름, 파이프라인, 파이프라인 단계.
- 장바구니: 이름.
- 세부 항목: 이름, 수량, 가격 및관련 거래의 레코드 ID 또는 거래 이름. 세부 항목을 제품과도 연결하는 경우 제품의 제품 ID를 포함하십시오. 이 ID는 가져오기 과정에서 세부 항목 속성으로 매핑됩니다.
참고: 거래와 함께 세부 항목을 가져올 경우, 가져오기 과정에서 거래 금액은 업데이트 되지 않습니다. 관련 거래 금액을 업데이트하려면 세부 항목을 수동으로 편집하거나 HubSpot에서 세부 항목을 거래와 연결해야 합니다.
- 통화: 통화 메모. 새로운 통화를 가져올 때는 다음 항목도 포함하는 것이 좋습니다. 활동 날짜을 포함하는 것이 좋습니다.
- 이메일: 이메일 본문및 이메일 발신자.
- 회의:회의 설명, 회의 시작 시간 및 회의 종료 시간. 새로운 회의를 가져올 때는 다음 정보도 포함하는 것이 좋습니다. 활동 날짜을 포함하는 것이 좋습니다. 시작 시간, 종료 시간 및 활동 날짜 값은 날짜-시간 속성으로 형식화되어야 합니다.
- 메모: 메모 본문.
- 작업:작업 제목및마감일. 마감일은 날짜-시간 속성으로 형식이 지정되어야 합니다.
참고: 필수는 아니지만, 새로운 활동을 가져올 때 활동이 발생한 날짜와 시간을 지정하기 위해 활동 날짜를 포함하는 것이 좋습니다. 이 속성을 포함하지 않으면 활동 날짜 값은 가져오기 시점의 날짜와 시간으로 자동 설정됩니다.
기존 레코드
업데이트 또는
중복
방지
요건
기존 레코드를 업데이트하고 중복 레코드를 방지하려면, 파일에는 각 개체에 대한 고유 식별자 속성이 포함되어야 합니다. 모든 개체의 경우, 기존 레코드를 내보내기록 ID를 고유 식별자로 사용하거나 고유 값이 필요한 사용자 정의 속성을 사용할 수 있습니다 . 연락처의 경우 이메일도 사용할 수 있습니다 . 회사의 경우 회사 도메인 이름도 사용할 수 있습니다.
여러 개체를 가져오고 레코드 ID를 포함하는 경우, ID를 올바른 개체와 매칭할 수 있도록 파일 열 머리글을 구분하는 것이 좋습니다(예: '레코드 ID - 연락처'라는 열과 '레코드 ID - 회사'라는 열).
참고:파일에 이메일 또는 회사 도메인 이름이 포함된 경우 다음동작이적용됩니다.
- 연락처 중복 제거를 위해 사용자 정의 고유 값 속성을 사용하는 경우, 이메일 속성에는 여전히 고유한 값이 필요합니다.
- 사용자 정의 고유 값 속성을 사용하여 기업 중복 제거를 수행하는 경우, '기업 도메인 이름' 속성은 고유 값을 요구하지 않습니다. 즉, 중복된 기업 도메인을 가져올 수 있습니다. 동일한 도메인을 가진 여러 기업을 원하지 않는다면, 가져오기 전에 파일에서 중복 도메인을 제거하거나 대신 '기업 도메인 이름'을 고유 식별자로 사용해야 합니다.
- HubSpot에 보조 이메일 주소가 등록된 기존 연락처의 경우, 보조 이메일을 고유 식별자로 사용할 수 있습니다 . 보조 이메일을 사용하고 파일에 '레코드ID' 열을 포함하지 않으면 보조 이메일이 기본 이메일을 대체하지 않습니다. 그러나 파일에 보조 이메일과 레코드 ID를 모두 열로 포함하면 보조 이메일이 기본 이메일을 대체합니다.
레코드 연결 요건
하나의 파일로 연결 정보 가져오기
하나의 파일에서 행당 두 개 이상의 레코드를 연결할 수 있습니다. 연결된 레코드 및/또는 활동에 대한 정보를 동일한 행에 포함하고 각 개체에 대한 고유 식별자를 포함하십시오. 하나의 레코드를 다른 개체의 여러 활동이나 레코드와 연결하려면, 연결하려는 각 레코드에 대해 해당 레코드의 고유 식별자를 여러 행에 포함하십시오.
예를 들어, Luke Danes는 Luke's Diner의 매니저이지만 The Dragonfly Inn의 계약직 직원입니다. 그를 두 회사와 모두 연결하려면 Luke Danes에 대한 두 행을 포함하고, 각 회사에 대해 이메일 (또는 레코드 ID) 및 회사 도메인 이름 (또는 레코드 ID) 열을 포함해야 합니다.
참고: 고유 식별자(예: 이메일, 회사 도메인 이름, 레코드 ID)를 포함하지않으면 , 가져오기 과정에서 각 레코드를 동일한 레코드에 연결하는 대신 중복 레코드가 생성됩니다.
동일
개체 간의
연관 관계를 가져오는 경우, 추가 요구 사항이 있습니다.
두
파일로
연관 관계 가져오기
두 파일의 두 개체 레코드를 연관시키려면, 각 파일의 레코드를 연결하는 공통 열을 사용하십시오. 레코드 가져오기 및 연관 설정에 대한 자세한 내용은 예제 파일을 참조하십시오.
동일 개체 연결
하나의 파일을 가져와 동일한 개체의 레코드를 일괄적으로 연결할 수 있습니다. 가져오기 과정에서 '동일 개체 연결 포함' 확인란을 선택해야 합니다.
파일을 설정할 때, 연결된 레코드에 대한 정보를 동일한 행에 포함하고 각 레코드에 고유 식별자를포함해야 합니다. 다음 추가 요구 사항은 동일 개체 가져오기에 특화된 사항입니다:
- 가져오기 전에 레코드 쌍 중 적어도 하나의 레코드가 HubSpot에 이미 존재해야 합니다. 예를 들어, 새로운 연락처를 가져와 기존 연락처와 연결할 수는 있지만, 두 개의 새로운 연락처를 생성하여 연결하는 방식으로 가져올수는 없습니다.
- 기존 연락처/기업을 연결할 때는 기본이메일/기업 도메인만 고유 식별자로 사용할 수 있습니다. 보조 이메일이나 도메인은 지원되지 않습니다.
- 하나의 레코드에 여러 레코드를 연결하는 경우, 동일한 셀 내에서 레코드의 고유 식별자 값을 세미콜론(;)으로 구분해야 합니다(예:luke@lukesdiner.com;rory@yale.edu;sookie@dragonfly.com).
아래 예시 파일에서 Rory와 Jackson은이메일값을 고유 식별자로 사용하여 기존 연락처에 고유한 레이블로 연결되는 새로운 연락처입니다. Sookie는 동일한 레이블을 가진 두 개의 기존 연락처에 연결되는 기존 연락처입니다. 첫 번째 행에서 연결 레이블은 레이블 쌍의 일부입니다. 즉, 가져오기가 완료되면 연결된 레코드에는'Parent'레이블이, Rory에게는쌍을 이루는'Child' 레이블이 할당됩니다.
상위/하위 연결
가져오기를 통해 자회사-모회사 연결을 생성하려면 자회사 가져오기에 대해 자세히 알아보세요 .
사용자 지정 연결 레이블
구독 필요 사용자 지정 연결 레이블을 사용하려면 Professional 또는 Enterprise 구독이 필요합니다.
연관 레이블을 가져오려면 '연관 레이블' 열을포함하십시오. 이 열은 연관 관계를 설명하는 레이블을 추가하려는 경우에만 추가해야 합니다. 연관 관계에 레이블을 지정할 필요가 없다면 이 열은 필수 사항이 아닙니다.
- 가져오기 전에 HubSpot에서 관계 레이블을 생성해야 합니다.
- 회사 연관 관계를 기본값으로 설정하려면 해당 행의 '연관 관계 레이블' 열에'기본( Primary )' 값을 입력하십시오.
- 두 레코드 간의 관계를 설명하기 위해 여러 레이블을 설정하려면, 하나의 셀에 세미콜론(;)으로 구분하여 여러 연관 레이블 값을 포함할 수 있습니다(예: 관리자; 청구 담당자).
- 여러 파일을 통해 연관 레이블을 가져오는 경우, 동일한 파일에 '연관 레이블' 열과 연관할 개체의 고유 식별자를 포함해야 합니다 .
- 쌍을 이루는 레이블을 가져오는 경우:
- 개체 간 연관 관계의 경우, '연관 레이블' 열에는 레이블 중 하나만 포함하십시오. 레이블은 가져오기 과정에서 올바른 개체에 할당됩니다.
- 동일 개체 간의 연관 관계인 경우,'연관된 [고유 식별자]' 열의 레코드는 가져오기 과정에서 추가되거나파일의 레이블 열에 포함된 레이블을 받게 됩니다. 해당 행의 다른 레코드는 쌍을 이루는 다른 레이블을 받게 됩니다.
예제 파일
가져오기 프로세스 시작 시, 선택한 개체 및 활동에 필요한 속성이 포함된 예제 파일을 생성할 수 있습니다. 추가 속성이 포함된 더 많은 예제를 확인하려면 샘플 파일이 포함된 이 문서를 참조하십시오.
다음 단계
가져오기 파일 작성이 완료되었으므로, 적절한 가져오기 지침을 따르십시오:
