---
title: "Patch Customer Webhook Integration"
method: PATCH
path: "/v1/integrate/clouds/webhooks/{integrationId}"
tags: ["IoT Integrator"]
---

# Patch Customer Webhook Integration

`PATCH /v1/integrate/clouds/webhooks/{integrationId}`

## Request

- Base URL: `https://api.1nce.com/management-api`
- URL: `https://api.1nce.com/management-api/v1/integrate/clouds/webhooks/{integrationId}`
- Auth: HTTP bearer

Patch Customer Webhook Integration

## Path parameters

- `integrationId` string, required

## Request body

- Patchschema4: Patch Webhook integration request
  - `url` string, uri: URL of the webhook (HTTPS required)
  - `headers` object: Headers that should be sent to the webhook. Only string values and no nested objects
  - `eventTypes` Patchschema3EventTypesInner[]: A list of all event types
    - `type` 'TELEMETRY_DATA' | 'LIFECYCLE' | 'ERROR' | 'GEOFENCE' | 'LOCATION', required: Name of the event type
    - `version` string: Version of the event type
  - `jsonPayloadEnabled` boolean: Flag if the payloads of this integration should be bridged in JSON format.

## Response `200`

Customer Webhook Integration Details.

- PatchResponseschema2: Patch Webhook integration response
  - `name` string, required: Name of the integration.
  - `eventTypes` PostResponseschema5EventTypesInner[], required: A list of event types
    - `type` 'TELEMETRY_DATA' | 'LIFECYCLE' | 'ERROR' | 'GEOFENCE' | 'LOCATION', required: Name of the event type
    - `version` string, required: Version of the event type
  - `state` 'ROLLOUT_DONE' | 'INTEGRATION_ACTIVE' | 'INTEGRATION_FAILED', required: State of the integration.
  - `type` 'WEBHOOK', required: Type of the integration.
  - `id` string, required: ID of the integration.
  - `createdTime` string, date-time, required: Created timestamp of the integration.
  - `updatedTime` string, date-time, required: Updated timestamp of the integration.
  - `headers` object, required: Headers of the integration.
  - `url` string, uri, required: URL of the integration.
  - `jsonPayloadEnabled` boolean, required: Flag if the payloads of this integration should be bridged in JSON format.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found Error
- `409`: Conflict
- `500`: Internal Server Error

---

[API](https://skmtc.dev/1nce/apis/1nce-os.md) - [All operations](https://skmtc.dev/1nce/apis/1nce-os/llms.txt) - [OpenAPI document](https://skmtc.dev/1nce/apis/1nce-os/revisions/f1aabbc6aeea?raw)