integrations

Update an integration

Update any subset of an integration's fields, including its live status.

The integration is returned FLAT (fields at the top level, no integration wrapper).

Send auth_secret to rotate the sealed secret, or clear_auth_secret: true to drop it.

Set status: "active" to resume, "paused" to stop firing.

An integration that only receives events has no outbound mapping: field_map, response_map, method, headers, timeout_ms, auth_secret or auth_header_name on it is refused with 409 conflict and details.reason "receive_only", and nothing is written. Setting a real endpoint_url makes it two-way.

patch/api/v1/integrations/{id}

Request

  • Base URL: https://app.blueticked.com
  • URL: https://app.blueticked.com/api/v1/integrations/{id}
  • Auth: HTTP bearer

Path parameters

idstring required

The resource's unique identifier.

Request body

namestring
descriptionstring nullable
kind'custom_webhook' | 'booking_api' | 'crm_api' | 'calendar' | 'other'
business_idstring uuid nullable
status'active' | 'paused' | 'errored'
method'POST' | 'PUT' | 'PATCH'
endpoint_urlstring uri
auth_type'none' | 'signature' | 'bearer' | 'api_key'
auth_secretstring
clear_auth_secretboolean
auth_header_namestring
auth_prefixstring
headersobject
sample_payloadobject
timeout_msinteger
inbound_target_channel'whatsapp' | 'sms' | 'email' nullable

Response

Success

organization_idstring uuid required
auth_configobject required
sample_payloadobject required
headersobject required
inbound_enabledboolean required
credential_updated_atstring date-time nullable required
credential_updated_bystring nullable required
inbound_token_hintstring nullable required
inbound_last_atstring date-time nullable required
inbound_last_status'accepted' | 'rejected' | 'null' nullable required
inbound_target_channel'whatsapp' | 'sms' | 'email' | 'null' nullable required
last_success_atstring date-time nullable required
last_failure_atstring date-time nullable required
last_delivery_atstring date-time nullable required
last_health_alert_atstring date-time nullable required
last_test_status'passed' | 'failed' | 'null' nullable required
last_test_atstring date-time nullable required
last_errorstring nullable required
last_response_statusnumber nullable required
idstring uuid required
business_idstring uuid nullable required
namestring required
descriptionstring nullable required
kind'custom_webhook' | 'booking_api' | 'crm_api' | 'calendar' | 'other' required
status'active' | 'paused' | 'errored' required
method'POST' | 'PUT' | 'PATCH' required
endpoint_urlstring required
auth_type'none' | 'signature' | 'bearer' | 'api_key' required
has_secretboolean required
health_status'unknown' | 'healthy' | 'degraded' | 'failing' required
success_countnumber required
failure_countnumber required
timeout_msnumber required
created_atstring date-time required
updated_atstring date-time required
connector_keystring nullable required
connection_state'pending' | 'connected' | 'expiring' | 'needs_reauth' | 'revoked' | 'null' nullable required
connection_state_sincestring nullable required
connection_state_reasonstring nullable required
external_account_labelstring nullable required
request_idstring required

Example response

{
  "id": "75cafe56-e3f9-4253-8f2b-c51090d65540",
  "business_id": "22222222-2222-4222-9222-222222222222",
  "name": "Booking CRM",
  "endpoint_url": "https://api.example.com/blueticked/hook",
  "has_secret": true,
  "success_count": 42,
  "timeout_ms": 15000,
  "created_at": "2026-07-01T08:00:00.000Z",
  "updated_at": "2026-07-02T11:00:00.000Z",
  "request_id": "req_b2e3d610e10f1b07468721ee98f0e1d2"
}

Changes

No recorded changes to this operation across all 1 revision of this API.