> For the complete documentation index, see [llms.txt](https://guide.roundhr.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guide.roundhr.com/setting/integrations/data.md).

# 데이터 연동 (API Key / Webhook)

## 개요

**데이터 연동**은 API Key와 Webhook을 통해 라운드HR 데이터를 외부 시스템과 주고받을 수 있게 하는 설정입니다. `설정` > `서비스 연동` > `보안/SSO` 탭에서 관리합니다.

* **API Key:** 외부 시스템에서 라운드HR 데이터에 접근할 때 사용합니다.
* **Webhook:** 라운드HR에서 발생한 이벤트를 외부 시스템으로 자동 전달합니다.

{% hint style="warning" %}
API Key와 Webhook은 **엔터프라이즈 플랜**에서만 사용할 수 있습니다.
{% endhint %}

## 사전 준비

* 엔터프라이즈 플랜이 필요하며, API Key·Webhook은 **Admin 권한**을 가진 사용자만 관리할 수 있습니다.

***

## 1. API Key 관리

API Key를 발급하면 외부 시스템에서 라운드HR 데이터에 접근할 수 있습니다.

* **발급:** `[API Key 발급하기]` 버튼을 클릭하고 이름을 입력해 발급합니다. 발급된 API Key는 목록에서 확인·복사할 수 있습니다.
* **복사:** API Key 옆 복사 아이콘을 클릭해 토큰을 복사합니다.
* **삭제:** 삭제 아이콘을 클릭해 사용하지 않는 API Key를 삭제합니다.

{% hint style="info" %}
API Key **발급·삭제는 Admin 권한**이 필요하며, 목록 조회는 매니저 이상 권한에서 가능합니다.
{% endhint %}

***

## 2. Webhook 관리

Webhook을 등록하면 라운드HR에서 발생하는 이벤트를 외부 시스템으로 자동 전달할 수 있습니다.

* **등록:** `[Webhook 등록하기]` 버튼을 클릭하고 **Callback URL**을 입력해 등록합니다.
* **수정:** 등록된 Webhook의 Callback URL을 수정합니다.
* **삭제:** 사용하지 않는 Webhook을 삭제합니다.

{% hint style="info" %}
Webhook은 **Admin 권한**을 가진 사용자만 등록·수정·삭제할 수 있습니다.
{% endhint %}

***

## 자주 묻는 질문

<details>

<summary>API Key와 Webhook은 누구나 사용할 수 있나요?</summary>

엔터프라이즈 플랜에서만 제공되며, Admin 권한을 가진 사용자만 발급·등록·삭제할 수 있습니다.

</details>

<details>

<summary>API Key와 Webhook은 어떻게 다른가요?</summary>

API Key는 외부 시스템이 라운드HR 데이터에 \*\*접근(가져가기)\*\*할 때 사용하고, Webhook은 라운드HR의 이벤트를 외부 시스템으로 \*\*자동 전달(내보내기)\*\*할 때 사용합니다.

</details>

<details>

<summary>Webhook으로는 어떤 이벤트가 전달되나요?</summary>

지원자의 채용 단계 변경, 평가 생성·완료, 면접 일정 등록, 폼(양식) 제출 등의 이벤트가 등록한 Callback URL로 전달됩니다. 각 요청에는 위·변조를 확인할 수 있는 서명(`Round-Webhook-Signature`)이 포함되며, 전송이 연속으로 실패하면 해당 Webhook은 자동으로 비활성화됩니다.

</details>