> ## Documentation Index > Fetch the complete documentation index at: https://docs.talentunveiled.com/llms.txt > Use this file to discover all available pages before exploring further. # Create a webhook > Create a webhook. The signing secret is returned once, unmasked, in this response only. ## OpenAPI ````yaml /swagger/v2_schema.yaml post /webhooks openapi: 3.0.3 info: title: TalentUnveiled API v2 version: 2.0.0 description: >- Public API v2 for managing jobs, applications, interviews, and webhooks. **Pagination:** list endpoints return a `{count, next, previous, results}` envelope. Page with the `limit` and `offset` query parameters; `limit` defaults to 50 and is capped at 200. servers: - url: https://api.talentunveiled.com/api/v2 description: Production server security: [] tags: - name: Meta description: Identify the organization an API key belongs to. - name: Jobs description: Create, read, update, and archive job postings. - name: Applications description: Create applications and track them through the pipeline. - name: Interview Configuration description: The interview config and call schedule for a job. - name: Interview Criteria description: Evaluation criteria for a job's interview. - name: Interview Questions description: Questions asked during a job's interview. - name: Interview Results description: The scored interview result for an application. - name: Interview Calls description: Call attempts, scheduling, and transcripts. - name: CV Evaluations description: AI scoring of a candidate's CV against the job. - name: Insights description: Combined CV and interview insights for an application. - name: Webhooks description: Manage webhook subscriptions and inspect deliveries. - name: Hiring Team description: Manage the hiring team assigned to a job posting. - name: Members description: List the members of the organization. paths: /webhooks: post: tags: - Webhooks summary: Create a webhook description: >- Create a webhook. The signing secret is returned once, unmasked, in this response only. operationId: webhooks_create requestBody: content: application/json: schema: $ref: '#/components/schemas/WebhookCreateRequest' required: true responses: '201': content: application/json: schema: $ref: '#/components/schemas/V2WebhookCreated' description: '' '400': description: Invalid input. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '401': description: Authentication credentials were not provided or are invalid. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '409': description: A webhook with this URL already exists in your organization. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' security: - apiKeyAuth: [] components: schemas: WebhookCreateRequest: type: object description: Request serializer for POST /webhooks. properties: url: type: string format: uri minLength: 1 description: >- Endpoint URL to send webhook events to. Must be an https URL with a publicly routable host: this endpoint rejects http, loopback, private, and link-local targets. maxLength: 2048 event_types: type: array items: $ref: '#/components/schemas/WebhookEventTypeEnum' description: Event types to subscribe to. Omit or pass [] to receive all events. required: - url V2WebhookCreated: type: object description: Create/rotate response. The real secret is shown exactly once. properties: id: type: string format: uuid readOnly: true url: type: string format: uri readOnly: true description: >- Endpoint URL to send webhook events to. A delivery whose host resolves to a private, loopback, or link-local address is blocked and not retried, regardless of which surface created the webhook. event_types: type: array items: $ref: '#/components/schemas/WebhookEventTypeEnum' readOnly: true description: >- Event types this webhook subscribes to. An empty list means all events. enabled: type: boolean readOnly: true description: Disabled webhooks receive no deliveries. secret: type: string readOnly: true created_at: type: string format: date-time readOnly: true required: - created_at - enabled - event_types - id - secret - url ErrorResponse: type: array description: List of errors items: $ref: '#/components/schemas/ErrorItem' WebhookEventTypeEnum: enum: - job_application.deleted - interview.completed - interview_v2.completed - application.created - application.status_changed - cv_evaluation.completed - insights.completed type: string description: |- * `job_application.deleted` - Job Application Deleted * `interview.completed` - Interview Completed * `interview_v2.completed` - Interview V2 Completed * `application.created` - Application Created * `application.status_changed` - Application Status Changed * `cv_evaluation.completed` - CV Evaluation Completed * `insights.completed` - Insights Completed ErrorItem: type: object description: Individual error item properties: code: allOf: - $ref: '#/components/schemas/ErrorCodeEnum' description: Machine-readable error code detail: type: string description: Human-readable error message attr: type: string nullable: true description: Field name this error relates to (for validation errors) required: - code - detail ErrorCodeEnum: type: string enum: - error - invalid_input - parse_error - authentication_failed - not_authenticated - permission_denied - not_found - method_not_allowed - not_acceptable - unsupported_media_type - throttled - required - does_not_exist - incorrect_type - no_match - incorrect_match - not_a_list - not_a_dict - empty - candidate_user_mismatch - candidate_not_found - cross_organization_application - already_exists - call_service_error - call_not_joinable - call_config_error - call_access_denied - call_already_linked - date_range_too_large - date_range_start_after_end - invalid_date - language_not_configured - vapi_api_error - webhook_processing_error - proxy_error - configuration_error - interview_call_already_processed - call_type_switch_error - slot_in_past - interview_not_scheduled - interview_opt_out_not_eligible - interview_retry_not_allowed - retake_limit_reached - interview_session_not_joinable - interview_session_retake_not_eligible - interview_session_already_processing - interview_session_not_completed - interview_session_reset_not_allowed - interview_mode_locked - application_already_exists - gateway_verification_failed - invalid_file_type - file_too_large - cv_already_exists - cv_required - custom_fields_too_large - nylas_grant_already_exists - nylas_upstream_error - otp_challenge_not_found - job_posting_not_found - job_application_not_found - workflow_execution_error - llm_generation_failed - report_generation_failed - interview_config_has_no_criteria - scheduling_not_enabled - interview_session_not_reschedulable - interview_version_mismatch - v3_job_missing_config - idempotency_key_conflict - idempotency_key_invalid - application_status_transition_invalid - application_state_conflict - external_id_conflict - qualification_cannot_have_score - competency_requires_bars description: Machine-readable error code securitySchemes: apiKeyAuth: type: http scheme: bearer description: >- API key authentication for the public API. Pass your API key as a Bearer token. ````