HubSpot 속성을 Salesforce 필드에 매핑
마지막 업데이트 날짜: 2026년 3월 27일
HubSpot-Salesforce 연동을 설치한 후, HubSpot 속성을 Salesforce 필드에 매핑하여 두 시스템 간 데이터의 일관성을 유지하세요. 필드가 매핑되면, 동기화 설정에 따라 한 시스템에서 이루어진 업데이트가 다른 시스템으로 동기화됩니다.
예를 들어, HubSpot의 '직책'과 같은 연락처 속성을 Salesforce의 리드 또는 연락처 필드에 매핑하여 두 플랫폼의 기록을 일치시킬 수 있습니다.
필드 매핑 생성 또는 편집
새 필드 매핑 추가
- HubSpot 계정에서 상단 탐색 모음에 있는 settings 설정 아이콘을 클릭합니다. 왼쪽 사이드바 메뉴에서 통합 > 연결된 앱으로 이동합니다.
- 연결된 앱 목록에서 Salesforce를 클릭합니다.
- 매핑할 개체( 연락처,기업,거래)의 탭을 클릭합니다.
- [개체] 속성 매핑 탭을 클릭합니다.
참고: HubSpot과 Salesforce 간의 기업 또는 거래 필드 매핑을 설정하려면 기업 또는 거래 에 대한 개체 동기화가 활성화되어 있어야 합니다.
- 새로운 필드 매핑을 추가하려면 [ 새 필드 매핑 추가]를 클릭합니다.
- 오른쪽 패널에서 드롭다운 메뉴를 사용하여 매핑할 HubSpot 속성과 Salesforce 필드를 선택합니다. 매핑을 생성하려면 호환되는 속성과 필드 매핑을 선택해야 합니다. 다음 표에는 Salesforce와 동기화할 수 있는 HubSpot 속성 필드 유형, 해당 API 이름 및 일치하는 Salesforce 필드 유형이 나와 있습니다.
| HubSpot 속성 필드 유형 | Salesforce 필드 유형 |
| 드롭다운 선택/라디오 버튼 선택 | 선택 목록, 참조 |
| 다중 선택 상자 | 다중 선택 목록 |
| 단일 선택 상자 | 부울 |
| 숫자 | double/int |
| 단일 줄 텍스트 | 문자열, 텍스트 영역 |
| 여러 줄 텍스트 | textarea |
| 날짜 선택기 | 날짜, 날짜/시간 |
참고:
- 유형 불일치가 있거나, 선택한 속성 또는 필드 중 하나가 이미 매핑된 경우 드롭다운 메뉴 위에 메시지가 표시됩니다. 자세한 내용을 보려면 메시지를 클릭하세요.
- HubSpot 사용자 필드 유형을 가진 사용자 정의 속성은 Salesforce 필드에 매핑할 수 없습니다.

- '다음'을 클릭합니다.
동기화 규칙 선택
- 매핑에 대한 동기화 규칙은 HubSpot과 Salesforce 간에 데이터가 어떻게 동기화될지 결정합니다. 다음 옵션 중에서 동기화 규칙을 선택하십시오:
-
- 빈 값이 아닌 경우 Salesforce를 우선 사용
- HubSpot은 Salesforce에 현재 값이 없는 경우에만 값을 Salesforce로 전달합니다.
- 빈 값이 아닌 경우 Salesforce를 우선 사용
-
-
- Salesforce에 값이 존재하는 경우, 이 값은 항상 HubSpot의 기존 값을 덮어씁니다.
- Salesforce에서 값을 삭제하면 HubSpot에서도 해당 값이 삭제됩니다.
- 항상 Salesforce 사용
- Salesforce에 값이 없더라도 HubSpot은 Salesforce로 데이터를 전달하지 않습니다.
- Salesforce에 값이 있는 경우, 해당 값은 항상 HubSpot의 기존 값을 덮어씁니다.
- Salesforce에서 값을 삭제하면 HubSpot에서도 해당 값이 삭제됩니다.
- 양방향
- 가장 최근의 값이 항상 기존 값을 덮어씁니다.
- HubSpot에서 값이 삭제되면 Salesforce에서도 삭제되며, 그 반대의 경우도 마찬가지입니다.
- 동기화하지 않음
- HubSpot과 Salesforce 간에는 데이터가 절대 전달되지 않습니다.
- HubSpot에서 값이 삭제되더라도 Salesforce에서는 삭제 되지 않으며, 그 반대의 경우도 마찬가지입니다.
-

- HubSpot 계정에서 소유자 매핑에 대해 '비어 있지 않은 경우 Salesforce 우선'으로 표시될 수 있지만, 소유자 매핑은 HubSpot과 Salesforce 간 양방향으로만 매핑할 수 있습니다. 소유자 필드 값은 HubSpot과 Salesforce 간에 정확히 일치해야 합니다.
- 새로 생성된 매핑에 기존 값이 있는 경우, 해당 값은 소급 적용되어 동기화되지 않습니다. 기존 값을 동기화하려면 Salesforce 동기화 카드에서 HubSpot 레코드를 수동으로 다시 동기화하거나, HubSpot 세그먼트를 다시 동기화하여 값을 Salesforce로 일괄 동기화하거나, Salesforce 가져오기를 실행하여 값을 HubSpot으로 일괄 동기화할 수 있습니다.
- 저장을 클릭하여 매핑을 저장합니다.
이제 선택한 개체의 매핑 목록에 새로운 매핑이 표시됩니다. 기존 매핑을 편집하려면 해당 매핑 위에 마우스를 올려놓고 '매핑 편집'을 클릭하세요.
매핑을 추가한 후, [객체] 동기화 스위치를 클릭하여 켜면 선택한 객체를 Salesforce와 동기화할 수 있습니다. 연락처의 경우 이 기능은 기본적으로 켜져 있으며 끌 수 없습니다.

참고: 개체당 필드 매핑은 500개로 제한됩니다.
소유자 동기화
HubSpot은 다음의 경우 Salesforce Standard, PowerPartner, Guest 및 Queue 사용자를 Salesforce 소유자로 식별합니다.
- 이들은 Salesforce에서 Salesforce에서 HubSpot으로 가져옵니다.
- Salesforce 사용자는 HubSpot과 동기화되는 리드, 연락처, 계정 또는 기회 레코드를 소유하고 있습니다.
기본적으로 Salesforce 리드, 연락처, 계정 또는 기회 레코드의 '소유자 ID' 필드는 HubSpot의 연락처/회사/거래 소유자 속성과 동기화됩니다.
소유자 동기화 작동 방식
모든 Salesforce 소유자는 HubSpot과 동기화될 수 있지만, 활성 Salesforce 사용자의 이름 및 이메일 주소와 일치하는 HubSpot 내 소유자만 Salesforce와 동기화됩니다. HubSpot이 Salesforce에 존재하지 않는 소유자를 동기화하려고 시도하면, 소유자 ID 필드는 Salesforce의 마지막 값으로 재설정됩니다.
Salesforce 소유자 할당 규칙은 연락처, 회사 및 거래마다 다릅니다. 규칙에 따라 HubSpot은 Salesforce에 새 개체를 생성하거나 기존 Salesforce 개체와 동기화할 수 있습니다. 타임라인 동기화를 사용하는 경우, 활동에 대한 소유자 동기화 방식에 대해 자세히 알아보세요.
연락처 소유자 할당 동작
HubSpot 연락처가 새로운 Salesforce 리드를 생성하고, Salesforce와 처음 동기화되기 전에 활성 Salesforce 사용자의 이름 및 이메일 주소와 일치하는 HubSpot 소유자가 할당된 경우, 해당 소유자가 Salesforce에 할당됩니다. 그렇지 않은 경우, Salesforce 리드 할당 규칙 이 적용됩니다.
HubSpot 또는 Salesforce에서 초기 소유자 할당이 완료된 후, HubSpot의 '연락처 소유자' 속성이나 Salesforce의 '소유자 ID' 필드가 변경되면 해당 변경 사항은 상대 시스템으로 동기화됩니다.
HubSpot 연락처가 활성 Salesforce 소유자가 있는 기존 Salesforce 리드와 동기화되는 경우, Salesforce 리드 할당 규칙은 적용되지 않으며 첫 번째 동기화 시 기존 Salesforce 소유자가 유지됩니다. 이후 동기화에서는 가장 최근의 소유자 값이 상대 시스템의 값을 업데이트합니다.
참고: Salesforce에서는 레코드에 소유자 값이 있어야 합니다. 할당되지 않은 HubSpot 레코드가 Salesforce와 동기화되어 새 레코드가 생성되면, 해당 레코드의 소유자는 레코드를 생성한 Salesforce 사용자, 즉 HubSpot 계정의 통합 사용자로 설정됩니다.
Salesforce 참조 필드를 HubSpot에 매핑
Salesforce 참조 필드 값은 레이블이 아닌 18자리 레코드 ID로 HubSpot에 동기화됩니다. HubSpot은 이러한 레이블을 자동으로 가져올 수 없지만, Salesforce 참조 필드를 HubSpot 드롭다운 속성에 매핑하여 HubSpot에서 세분화 및 보고에 해당 값을 활용할 수 있습니다.
- HubSpot 계정에서 드롭다운 선택필드 유형의 HubSpot 사용자 정의 속성을 만드십시오.
- Salesforce 참조 필드를 새로 생성된 HubSpot 사용자 정의 속성에 매핑합니다.
- HubSpot 계정의 상단 탐색 모음에서 settings 설정 아이콘을 클릭합니다.
- 왼쪽 사이드바 메뉴에서'속성'으로 이동합니다.
- 필드 매핑에 사용된 사용자 정의 속성의이름을 클릭합니다.
- 왼쪽 사이드바 메뉴에서 '필드 유형'을 클릭합니다.
- '드롭다운 옵션' 섹션의 '내부 이름' 열에는 Salesforce의 각 참조 필드 값에 해당하는 18자리 레코드 ID가 표시됩니다.'라벨' 필드에 Salesforce의 해당 필드 값 라벨을 입력합니다.
- 오른쪽 상단의 ‘저장’을 클릭하세요.
이제 필드 값의 레코드 ID 대신 필드 값 레이블을 기준으로 참조 필드를 세분화할 수 있습니다.
필드 매핑 오류 해결
필드 매핑에 오류가 있거나 업데이트가 필요한 경우, HubSpot과 Salesforce 간에 데이터가 전송되지 않을 수 있습니다. 필드 매핑을 수정하거나 새로 고치려면:
- HubSpot 계정에서 상단 탐색 모음에 있는 settings 설정 아이콘을 클릭합니다. 왼쪽 사이드바 메뉴에서 통합 > 연결된 앱으로 이동합니다.
- 'Salesforce'를 클릭합니다.
- '동기화 상태 ' 탭을 클릭합니다.
- 동기화 오류나 경고가 있는 경우'동기화 오류' 섹션에 표시됩니다. 동기화 오류 유형을 클릭하면 자세한 정보와 영향을 받은 레코드를 확인하고 추가 조치를 취할 수 있습니다.
- 매핑에 Salesforce 픽리스트 필드가 포함된 경우, 필드를 새로 고침하여 Salesforce의 새로운 픽리스트 옵션을 확인하고 해당 옵션을 HubSpot의 해당 드롭다운 메뉴 속성에 추가할 수 있습니다. 이렇게 하려면 매핑 위에 마우스를 올려놓고 새로 고침을 클릭하세요.
참고: 회사/계정 필드 매핑을 대량으로 다시 동기화할 때, HubSpot은 한 번에 200,000개 이상의 회사를 동기화할 수 없습니다. 이로 인해 '이 매핑에 대한 모든 업데이트를 동기화할 수 없습니다 '라는 오류가 발생할 수 있습니다.
사용자 정의 필드 매핑 삭제
사용자 정의 필드 매핑에서 HubSpot 속성과 Salesforce 필드 간의 데이터 동기화를 더 이상 원하지 않는 경우, 해당 매핑을 삭제할 수 있습니다.
참고: HubSpot에서는 사용자 지정 필드 매핑만 삭제할 수 있습니다. 표준 필드 매핑은 삭제할 수 없지만, 업데이트 규칙을 '동기화하지 않음'으로 설정하여 데이터 동기화를 중지할 수 있습니다. 이는 '모든 이메일연락처에서 구독취소됨' 속성에는 적용되지 않습니다.
- HubSpot 계정에서 상단 탐색 모음에 있는 settings 설정 아이콘을 클릭합니다. 왼쪽 사이드바 메뉴에서 통합 > 연결된 앱으로 이동합니다.
- 'Salesforce'를 클릭합니다.
- 매핑에 해당하는 개체 탭( 연락처,기업 또는거래)을 클릭합니다.
- [개체] 속성 매핑 탭을 클릭합니다.
- 매핑 위에 마우스를 올려놓고'매핑 삭제'를 클릭합니다.

필드 매핑 내보내기
필드 매핑 목록을 내보내려면:
- HubSpot 계정에서 상단 탐색 모음에 있는 settings 설정 아이콘을 클릭합니다. 왼쪽 사이드바 메뉴에서 통합 > 연결된 앱으로 이동합니다.
- Salesforce를 클릭합니다.
- 내보내려는 매핑에 해당하는 개체 탭( 연락처,회사 또는거래)을 클릭합니다.
- [개체] 속성 매핑 탭을 클릭합니다.
- '필드 매핑 내보내기(CSV)'를 클릭합니다.
