1. Webhook Endpoints
Jicoo Developer Potal
  • Create powerful apps with Jicoo's API
  • Quick start
  • Authentication
  • Errors
  • Versioning
  • Types
  • API Reference Overview
  • Guide
    • How to use webhook
    • How to use Account integration
  • Guide(Japanese)
    • アカウント連携の使い方
    • Webhookの使い方
    • ホストの優先度を更新する方法
  • API Reference
    • Jicoo API
    • Webhook Schema
      • Webhook schema
      • event property
      • createdAt property
      • object property
      • contact property
      • answers property
      • answers items property
      • tracking property
    • Booking
      • List Bookings
      • Get Booking
      • Cancel Booking
      • Reschedule Booking
      • Create Booking
      • Update Booking
      • Get Booking Contacts
    • Schedule
      • Update Schedule
      • Create Schedule
      • List Schedules
      • Delete Schedule
    • Availability
      • List User Availability Calendars
      • Get User Availability Calendar
    • Oraganization
      • User
        • List Organization Users
        • Delete Organization User
        • Get Organization User
        • Update Organization User
      • Invitation
        • Create Organiztion Invitation
        • List Organization Invitations
        • Get Organization Invitation
        • Delete Organiztion Invitation
      • Get Organization Team
    • Event Types
      • Get Event Type
      • List Event Types
      • List Event Type Hosts
      • Get Event Type Available Schedules
      • Account Integration
      • Update Event Type Host
      • Delete Event Type Host
      • Create Event Type Host
      • Delete Event Type Host Assign Rule
      • Update Event Type Host Assign Rule
      • Create Event Type Host Assign Rule
      • List Event Type Host Assign Rules
  • Webhook Endpoints
    • List webhook endpoints
      GET
    • Create a webhook endpoint
      POST
    • Get a webhook endpoint
      GET
    • Update a webhook endpoint
      PATCH
    • Delete a webhook endpoint
      DELETE
  • Booking Meeting Intelligence
    • List recaps for a booking
      GET
    • List transcripts for a booking
      GET
    • List recordings for a booking
      GET
  • Event Types
    • Update an event type
    • Create an event type
    • Delete an event type
  • Schemas
    • Booking
    • OrganizationUser
    • OrganizationInvitation
    • UserAvailabilityCalendar
    • OrganizationTeam
    • EventType
    • Host
    • Pagination
    • AvailableSchedule
    • BookingRecapSummary
    • BookingTranscriptSpeakerTimelineSegment
    • BookingRecording
    • EventTypeUpdateRequest
    • EventTypeCreateRequest
    • WebhookEndpointPublicCreateBody
    • BookingRecapRisk
    • BookingTranscript
    • BookingRecordingResponse
    • EventTypeCreateEventType
    • GeneratedEventTypeUpdateRequest
    • EventTypeUpdateLocation
    • EventTypeCreateLocation
    • WebhookEndpointPublicUpdateBody
    • BookingRecap
    • ErrorEnvelope
    • EventTypeUserUpdate
    • BookingTranscriptResponse
    • BookingRecapResponse
    • WebhookEndpointCreateResponse
    • EventTypeUserCreate
    • EventTypeUpdateForm
    • WebhookEndpoint
    • EventTypeUpdateWorkflow
    • EventTypeUpdateHostAssignRule
    • EventTypeCalendarCreateBody
    • EventTypeCalendarCreate
    • EventTypeNotification
    • EventTypeSettingCreateBody
    • EventFormCreateBody
    • EventTypeTransparencyKeywordCreateBody
    • EventTypeCreateHostAssignRule
    • Schedule
    • EmptySuccessResponse
    • ErrorResponse
    • Booking Contact
    • HostAssignRule
  1. Webhook Endpoints

Create a webhook endpoint

POST
/api/v1/webhook_endpoints
新しい webhook endpoint を作成する。レスポンスで平文 signing secret を
この 1 回だけ 返す (以降 public API からは取得できない)。
Team プラン以上が必要。event type の紐付けは本 endpoint ではサポートしない。

Request

Authorization
API Key
Add parameter in header
x-jicoo-api-key
Example:
x-jicoo-api-key: ********************
or
JWT Bearer
Add the parameter
Authorization
to Headers
Example:
Authorization: ********************
or
Header Params

Body Params application/jsonRequired

Example
{
    "url": "string",
    "status": "disable",
    "description": "string",
    "scope": "team"
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '/api/v1/webhook_endpoints' \
--header 'X-Jicoo-Team;' \
--header 'x-jicoo-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "url": "string",
    "status": "disable",
    "description": "string",
    "scope": "team"
}'

Responses

🟢201
application/json
Created
Body

Example
{
    "data": {
        "uid": "string",
        "url": "string",
        "userId": "string",
        "status": "disable",
        "description": "string",
        "createdAt": "string",
        "updatedAt": "string",
        "scope": "team",
        "signingSecret": "string"
    }
}
🟠400InvalidParams
🟠401Unauthorized
🟠403Forbidden
🔴500InternalServerError
Modified at 2026-04-20 12:16:06
Previous
List webhook endpoints
Next
Get a webhook endpoint
Built with