> ## Documentation Index > Fetch the complete documentation index at: https://docs.pubrio.com/llms.txt > Use this file to discover all available pages before exploring further. # 모니터 생성 > 지정된 감지 규칙 및 웹훅 구성으로 새 데이터 모니터를 생성합니다. ## OpenAPI ````yaml ko-openapi POST /monitors/create openapi: 3.0.0 info: description: >- Pubrio API는 마켓 확장 인텔리전스를 제공합니다——기업의 신규 시장 진입을 포착하는 실시간 시그널과 그 기반이 되는 기업·인물 데이터. 계정과 연락처를 검색·조회·보강하고, 200+ 시장에 걸친 유형·날짜가 있는 움직임 시그널을 구독하세요. version: 1.0.0 title: Pubrio OpenAPI termsOfService: https://pubrio.com/ko/terms-of-service contact: email: king.lai@pubrio.com name: King Lai url: https://pubrio.com/ko/get-in-touch license: name: Apache 2.0 url: http://www.apache.org/licenses/LICENSE-2.0.html servers: - url: https://api.pubrio.com security: - pubrio_api_key: [] tags: - name: Profile description: 워크스페이스 프로필 정보 및 사용량 통계 - name: Enrichment description: 상세한 B2B 데이터로 인물 및 기업 레코드를 보강 - name: Lookalike description: 지정된 기업과 유사한 기업 검색 - name: Search description: 필터를 사용하여 인물, 기업, 채용, 뉴스 및 광고 검색 - name: Lookup description: 특정 인물, 기업, 채용, 뉴스, 광고 및 기술의 상세 정보 조회 - name: LinkedIn description: LinkedIn 프로필 URL을 통한 인물 및 기업 데이터 조회 - name: Redeem description: 크레딧을 사용하여 인물 연락처 정보 잠금 해제 (단건 및 배치) - name: Channels description: 아웃리치 채널 템플릿 관리 (생성, 수정, 삭제, 목록) - name: Monitor description: 웹훅, 통계 및 처리를 포함한 데이터 모니터 생성 및 관리 - name: Filters description: 검색 매개변수에 사용 가능한 필터 값 조회 (기술, 지역, 버티컬 등) - name: API Keys description: API 키의 요청 로그 및 사용량 분석 조회 - name: Insights description: 회사의 신호 집계 인사이트(채용, 뉴스, 광고). - name: Export description: 대량 데이터 내보내기(크레딧 차감). - name: Expansion description: '회사 시장 확장 인텔리전스: 신호, 단계, 시장, 내보내기.' externalDocs: description: >- Pubrio API는 연락처와 계정 정보를 검색, 미리보기, 그리고 보강하는 데 사용됩니다. Pubrio 데이터베이스는 풍부한 B2B 연락처 및 영업 인텔리전스 데이터를 제공합니다. url: https://docs.pubrio.com paths: /monitors/create: post: tags: - Monitor summary: 모니터 생성 description: 지정된 감지 규칙 및 웹훅 구성으로 새 데이터 모니터를 생성합니다. operationId: monitors_create parameters: [] requestBody: required: true content: application/json: schema: type: object properties: name: type: string description: 모니터의 이름입니다. description: type: string description: 모니터의 설명입니다. detection_mode: type: string description: >- 감지 모드: 'company_first'는 기업을 먼저 찾은 다음 신호를 확인하고, 'signal_first'는 신호를 먼저 찾은 다음 기업을 매칭합니다. enum: - company_first - signal_first signal_types: type: array items: type: string enum: - jobs - news - advertisements description: 모니터링할 신호 유형입니다. signal_filters: type: array items: type: object description: >- 신호 필터 객체 배열입니다. 각 객체는 `signal_type` (jobs, news, advertisements 중 하나)과 `filters` (신호별 매개변수가 포함된 객체)로 구성됩니다. 사용 가능한 필터 매개변수는 [Job Search](/ko/api-reference/endpoint/companies/job_search), [News Search](/ko/api-reference/endpoint/companies/news_search) 또는 [Advertisement Search](/ko/api-reference/endpoint/companies/advertisements_search) 엔드포인트를 참조하세요. example: - filters: locations: - US signal_type: jobs - filters: locations: - US signal_type: news - filters: target_locations: - US signal_type: advertisements company_filters: type: object description: >- 글로벌 기업 필터로 두 번째 레이어로 적용됩니다. [Company Search](/ko/api-reference/endpoint/companies/search) 엔드포인트와 동일한 매개변수 — locations, employees, technologies, verticals 등을 허용합니다. example: locations: - US employees: - - 501 - 1000 - - 1001 - 5000 companies: type: array items: type: string format: uuid description: >- 모니터링할 기업 domain_search_id UUID 목록입니다. 주로 company_first 모드에서 대상 기업을 지정하는 데 사용됩니다. `domains` 또는 `linkedin_urls`를 대안으로 사용할 수 있습니다 — 셋 중 하나만 입력하면 됩니다. domains: type: array items: type: string description: >- 모니터링할 회사 도메인 목록 (예: ["openai.com", "google.com"]). `companies`의 대안으로 사용 가능 — Pubrio가 해당 회사를 자동으로 확인합니다. `companies`, `domains`, `linkedin_urls` 중 하나만 입력하면 됩니다. linkedin_urls: type: array items: type: string format: uri description: >- LinkedIn 회사 페이지 URL 목록 (예: ["https://linkedin.com/company/pubrio"]). `companies`의 대안으로 사용 가능합니다. 셋 중 하나만 입력하면 됩니다. is_company_enrichment: type: boolean description: 결과에서 기업 데이터를 보강할지 여부입니다. is_people_enrichment: type: boolean description: 결과에서 인물 데이터를 보강할지 여부입니다. people_enrichment_configs: type: array items: type: object description: >- 인물 보강 레이어 배열입니다. 각 레이어는 독립적인 인물 검색을 수행합니다. `max_people_to_return` (1-25), `people_contact_types` (배열 — [Redeem](/ko/api-reference/endpoint/redeem/people) 엔드포인트의 연락처 유형 참조: email-work, email-personal, phone), `filters` ([People Search](/ko/api-reference/endpoint/people/search) 엔드포인트와 동일한 매개변수)를 포함합니다. 사용 가능한 필터 매개변수는 인물 검색(People Search)을, 연락처 유형 세부 정보는 Redeem을 참조하세요. example: - filters: people_locations: - US max_people_to_return: 3 people_contact_types: - email-work destination_type: type: string description: 전달 대상 유형입니다. enum: - webhook - email - sequences destination_config: type: object description: >- 대상 구성입니다. 웹훅의 경우: `webhook_url` (문자열) 필수, `headers` (객체) 및 `body` (객체) 선택 사항. 이메일의 경우: `email` (문자열) 필수. sequences 유형은 `sequence_identifier`(문자열)와 `record_type`(문자열)이 필요합니다. frequency_minute: type: integer description: '트리거 빈도(분)입니다. 최소: 0, 최대: 10080, 기본값: 0.' minimum: 0 maximum: 10080 default: 0 max_failure_trigger: type: integer description: '모니터 일시 중지 전 최대 연속 실패 횟수입니다. 최소: 1, 최대: 10, 기본값: 5.' minimum: 1 maximum: 10 default: 5 max_daily_trigger: type: integer description: '일일 최대 트리거 수입니다. 최소: 0, 최대: 86400, 기본값: 500.' minimum: 0 maximum: 86400 default: 500 max_records_per_trigger: type: integer description: >- 트리거당 최대 전달 레코드 수를 제어합니다. 값을 낮추면 전달당 페이로드 크기가 줄어들며, 결과 세트가 크거나 속도 제한이 있는 통합에 권장됩니다. 최소값: 1, 최대값: 100, 기본값: 25. 자세한 내용은 [Webhook 설정](/ko/developer-guides/setting-up-webhooks)을 참조하세요. minimum: 1 maximum: 100 default: 25 notification_email: type: string format: email description: 모니터 실패 알림 이메일 주소입니다. max_retry_per_trigger: type: integer description: '트리거당 최대 재시도 횟수입니다. 최소: 0, 최대: 3, 기본값: 1.' minimum: 0 maximum: 3 default: 1 retry_delay_second: type: integer description: '재시도 간 지연 시간(초)입니다. 최소: 1, 최대: 5, 기본값: 1.' minimum: 1 maximum: 5 default: 1 profile_id: $ref: '#/components/schemas/profile_id' required: - name - detection_mode - signal_types - destination_type - destination_config responses: '200': description: 새로 생성된 모니터 세부 정보가 포함된 성공적인 응답입니다. content: application/json: schema: type: object properties: data: type: object properties: monitor_id: type: string format: uuid description: 새로 생성된 모니터의 고유 식별자입니다. name: type: string description: 모니터의 이름입니다. description: type: string description: 모니터의 설명입니다. detection_mode: type: string description: '감지 모드: ''company_first'' 또는 ''signal_first''입니다.' destination_type: type: string description: 전달 대상 유형입니다. is_active: type: boolean description: 모니터 활성화 여부입니다. is_paused: type: boolean description: 모니터 일시 중지 여부입니다. masked_signature: type: string description: 표시용 마스킹된 웹훅 서명입니다. created_at: type: string format: date-time description: 모니터 생성 타임스탬프입니다. signature: type: string format: uuid description: 페이로드 확인을 위한 웹훅 서명입니다. 생성 시에만 반환됩니다. example: data: monitor_id: c3d4e5f6-a7b8-9012-cdef-123456789012 name: My Monitor description: Monitors news and job signals for target companies detection_mode: signal_first destination_type: webhook is_active: true is_paused: false masked_signature: 7••••••••••••••••8df created_at: '2026-04-05T20:30:17.792Z' signature: d4e5f6a7-b8c9-0123-defa-234567890123 '400': $ref: '#/components/responses/general_error' '429': $ref: '#/components/responses/rate_limit_error' '500': $ref: '#/components/responses/server_error' components: schemas: profile_id: type: integer description: >- 선택 사항. 요청을 수행하는 팀 식별자입니다. API 키에 이미 워크스페이스 정보가 포함되어 있으므로 이 매개변수는 더 이상 필수가 아닙니다. 제공되면 조회 및 사용 크레딧 추적을 위해 특정 팀(작업 공간)과 연계됩니다. 자세한 내용은 팀 탭의 `user details` 엔드포인트를 참고하세요. responses: general_error: description: 잘못된 요청. 요청 형식이 올바르지 않거나 잘못된 매개변수가 포함되어 있습니다. 오류 코드와 메시지를 확인하세요. content: application/json: schema: required: - code - message - details type: object properties: code: example: 40001 type: integer message: example: 오류 코드 및 메시지는 상황에 따라 다를 수 있습니다. 자세한 내용은 문서를 참조하세요. type: string details: type: object rate_limit_error: description: 요청 속도 제한 초과. 주어진 시간 내에 너무 많은 요청이 전송되었습니다. 속도 제한 창이 재설정된 후 다시 시도하세요. content: application/json: schema: required: - error type: object properties: error: example: 요청 빈도가 제한을 초과했습니다. 잠시 후 다시 시도해주세요. type: string server_error: description: 내부 서버 오류. 서버에서 예기치 않은 오류가 발생했습니다. 오류가 지속되면 지원팀에 문의하세요. content: application/json: schema: required: - error type: object properties: error: example: 요청을 처리하는 중 서버에서 예기치 않은 오류가 발생했습니다 type: string securitySchemes: pubrio_api_key: type: apiKey name: pubrio-api-key description: >- API에서 수행하는 작업 및 해당 권한을 식별하는 고유한 API 토큰입니다. 이 토큰은 [설정](https://dashboard.pubrio.com/#/settings/) 섹션에서 생성할 수 있습니다. in: header ````