PATCH /public/v1/webhooks/{id}

Update a webhook. Only the fields you send are changed. triggerTypes replaces the full list. enabled=false pauses delivery without deleting the webhook; enabled=true resumes it. WORKSPACE webhooks require ADMIN/OWNER.

PATCH /public/v1/webhooks/{id}

API key in header x-api-key

curl --request PATCH \
  --url 'https://api.joinvalley.co/public/v1/webhooks/{ID}' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "key": "value"
}'

{
  "statusCode": 1,
  "status": true,
  "message": "example",
  "data": {
    "webhook": {
      "id": "id_01JXY9AZK4KV",
      "label": "example",
      "scope": "PERSONAL",
      "webhookUrl": "https://example.com/webhook",
      "triggerTypes": [
        "example"
      ],
      "payloadFields": "example",
      "isActive": true,
      "createdByUserId": "created_by_user_01JXY9AZK4KV",
      "workspaceId": "workspace_01JXY9AZK4KV",
      "createdAt": "2026-01-01T12:00:00Z",
      "lastUsedAt": "2026-01-01T12:00:00Z"
    }
  }
}

Default Response

Path parameters

· 1

id string · min length: 1 required

Body

required application/json

label string · min length: 1· max length: 255

webhookUrl string · min length: 1

New absolute http(s) endpoint.

triggerTypes array of string · min items: 1· unique items

Events that fire this webhook. PROSPECT_RESPONSE and SEND_FIRST_PROSPECT_RESPONSE are mutually exclusive; if both are sent only PROSPECT_RESPONSE is kept.

values

PROSPECT_RESPONSE
SEND_FIRST_PROSPECT_RESPONSE
CONNECTION_ACCEPTED
SEND_INTERESTED_RESPONSES
SEND_MIGHT_BE_INTERESTED_RESPONSES
SEND_NOT_INTERESTED_RESPONSES

payloadFields object | null

Optional payload opt-ins (extra fields to include in the delivered JSON). null clears them.

enabled boolean

false pauses delivery, true resumes it.

Path parameters

Body

Responses