웹훅 등록

Webhook 등록

POST https://api.roundhr.com/v1/webhooks

새로운 Webhook을 등록합니다.

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token>

Body

Name	Type	필수	Description
callback_url	string	required	이벤트 발생 시 호출할 URL
signing_key	string	optional	서명 검증을 위한 비밀 키
active	boolean	optional	활성화 여부 (기본값: true)
kinds	string[]	optional	구독할 이벤트 타입 배열

구독 가능한 이벤트 (kinds)

이벤트 타입	설명
candidate_stage_changed	지원자의 채용 단계가 변경될 때
candidate_pass	지원자가 합격 단계로 이동할 때
feedback_created	평가가 생성될 때
feedback_completed	평가가 완료될 때
interview_scheduled	면접 일정이 확정될 때

각 이벤트의 상세 payload는 Webhook 이벤트 목록을 참조하세요.

요청 예제

curl -X POST https://api.roundhr.com/v1/webhooks \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <token>" \
  -d '{
    "callback_url": "https://example.com/webhook",
    "signing_key": "your_secret_key",
    "kinds": ["candidate_stage_changed", "feedback_created"]
  }'

응답 예제

200

{
  "resource": {
    "code": "WH12345678",
    "active": true,
    "provider": "round",
    "callback_url": "https://example.com/webhook",
    "signing_key": "your_secret_key",
    "events": [
      "candidate_stage_changed",
      "feedback_created"
    ],
    "created_at": "2025-01-15T00:00:00+09:00",
    "updated_at": "2025-01-15T00:00:00+09:00"
  }
}