이벤트
조직에서 변경이 생기면 웹훅이 받는 이벤트 유형 60개예요. 정확한 유형을 구독하거나 card.* 같은 마스크로 구독하세요.
카드
- card.archived카드 보관됨
- card.created카드 생성됨
- card.deleted카드 삭제됨
- card.index_failed카드 인덱싱 실패
- card.indexed카드 인덱싱됨
- card.moved카드 이동됨
- card.published초안이 새 카드로 게시됨
- card.restored카드 복원됨
- card.updated카드 수정됨
검증
- card.unverified카드 신뢰 해제됨
- card.verified카드 검증됨
- verification.expired검증 만료됨
- verification.requested검증 요청됨
컬렉션과 폴더
- collection.created컬렉션 생성됨
- collection.deleted컬렉션 삭제됨
- collection.updated컬렉션 수정됨
- folder.created폴더 생성됨
- folder.deleted폴더 삭제됨
- folder.updated폴더 수정됨
협업
- announcement.read공지 읽음
- announcement.sent공지 전송됨
- comment.created댓글 추가됨
- comment.resolved댓글 스레드 해결됨
- draft.approved초안 승인됨
- draft.created초안 생성됨
- draft.publish_requested게시 승인 요청됨
질문과 답변
- access_request.created접근 요청됨
- access_request.resolved접근 요청 처리됨
- gap.detected지식 빈틈 발견됨
- question.answered질문 답변됨
- question.feedback_created답변 평가됨
- question.unanswered질문에 답변하지 못함
사용자와 접근 권한
- api_key.createdAPI 키 생성됨
- api_key.expiringAPI 키 만료 임박
- api_key.revokedAPI 키 폐기됨
- app.authorized앱 인가됨
- app.revoked앱 인가 취소됨
- group.created그룹 생성됨
- group.deleted그룹 삭제됨
- group.member_added그룹 멤버 추가됨
- group.member_removed그룹 멤버 제거됨
- group.updated그룹 수정됨
- user.created사용자 생성됨
- user.deactivated사용자 비활성화됨
- user.offboarded사용자 오프보딩됨
- user.updated사용자 수정됨
소스와 가져오기
- import.document_failed가져오기 문서 처리 실패
- import.sync_completed가져오기 동기화 완료됨
- source.connection_lost소스 연결 끊김
- source.sync_completed소스 동기화 완료됨
- source.sync_failed소스 동기화 실패
작업과 내보내기
- export.ready내보내기 준비됨
- job.completed작업 완료됨
- job.failed작업 실패
결제 및 요금
- credits.low크레딧 부족
- invoice.issued청구서 발행됨
- invoice.paid청구서 결제됨
- subscription.updated구독 변경됨
웹훅 서비스 이벤트
- webhook.endpoint_disabled웹훅 비활성화됨
- webhook.ping테스트 이벤트
이벤트 수신
각 전송은 이 JSON 본문을 웹훅의 수신 주소로 보내는 POST 요청이에요. 본문을 신뢰하기 전에 webhook-signature 헤더(Standard Webhooks)를 검증하고, 몇 초 안에 2xx 상태로 응답한 다음 처리는 그 뒤에 하세요. 한 웹훅으로 가는 전송은 이벤트 순서를 지키며, 실패한 전송은 간격을 늘려 가며 재시도해요.
새 이벤트 유형과 새 필드는 언제든 추가될 수 있어요. 모르는 유형과 필드는 건너뛰세요.