# Replace example resource IDs and ownerId with values from your workspace.
: "${POWERDIALER_API_KEY:?Set POWERDIALER_API_KEY to your scoped API key}"
# Set this once per operation; reuse it with the same request after a timeout.
: "${POWERDIALER_REQUEST_ID:?Set POWERDIALER_REQUEST_ID to a new UUID for this operation}"
curl --request PATCH \
--url 'https://api.migration.powerdialer.ai/api/public/v2/webhooks/00000000-0000-4000-8000-000000000001' \
--header "Authorization: Bearer $POWERDIALER_API_KEY" \
--header "Idempotency-Key: $POWERDIALER_REQUEST_ID" \
--header 'Content-Type: application/json' \
--data '{
"active": false
}'{
"name": "CRM updates",
"url": "https://receiver.example.com/powerdialer",
"events": [
"call.completed",
"call.disposition_updated"
],
"id": "00000000-0000-4000-8000-000000000001",
"active": false,
"verifiedAt": null,
"createdAt": "2026-10-08T12:00:00.000Z"
}{
"error": {
"code": "invalid_api_key",
"message": "API key is invalid, expired or revoked",
"requestId": "00000000-0000-4000-8000-000000000004"
}
}Pause or enable a webhook
Temporarily pause a receiver or enable a previously verified subscription without changing its URL or event selection. Requires webhooks:manage, using the credential that owns the subscription. Send only {active:false} or {active:true}; use PUT for configuration changes.
Enabling requires a successful receiver verification. Creating, reconfiguring or rotating the subscription clears verification, so run the verification endpoint before enabling after those actions. The response contains the current subscription details and never the signing secret. An in-flight request may still arrive after a pause. Queued deliveries encountered while inactive can become cancelled and need explicit replay later; a pause is not a guaranteed hold-and-resume queue. Continue to deduplicate events.
Persist an Idempotency-Key for this state change and reuse it only with the same request. 409 verification_required means you must verify the receiver first. 404 not_found means the subscription is absent or owned by another credential. A matching retry returns the saved response only after current access and verification checks. If rotation cleared verification after an enable succeeded, retrying that enable returns 409 verification_required; deliberately reverify the receiver first.
See receiver lifecycle.
# Replace example resource IDs and ownerId with values from your workspace.
: "${POWERDIALER_API_KEY:?Set POWERDIALER_API_KEY to your scoped API key}"
# Set this once per operation; reuse it with the same request after a timeout.
: "${POWERDIALER_REQUEST_ID:?Set POWERDIALER_REQUEST_ID to a new UUID for this operation}"
curl --request PATCH \
--url 'https://api.migration.powerdialer.ai/api/public/v2/webhooks/00000000-0000-4000-8000-000000000001' \
--header "Authorization: Bearer $POWERDIALER_API_KEY" \
--header "Idempotency-Key: $POWERDIALER_REQUEST_ID" \
--header 'Content-Type: application/json' \
--data '{
"active": false
}'{
"name": "CRM updates",
"url": "https://receiver.example.com/powerdialer",
"events": [
"call.completed",
"call.disposition_updated"
],
"id": "00000000-0000-4000-8000-000000000001",
"active": false,
"verifiedAt": null,
"createdAt": "2026-10-08T12:00:00.000Z"
}{
"error": {
"code": "invalid_api_key",
"message": "API key is invalid, expired or revoked",
"requestId": "00000000-0000-4000-8000-000000000004"
}
}Authorizations
Issued in Developers. Workspace/owner/scopes come from credential, never acting-user headers. API keys cannot manage API credentials.
Headers
Persist one key for this logical operation before sending it. Reuse the same value only with the same method, path and body after a timeout. A changed request returns 409 idempotency_conflict; a matching retry returns the original response.
^[A-Za-z0-9._:-]{1,200}$Path Parameters
Subscription UUID returned by registration or listing. It must belong to the credential making this request.
Body
Use false to pause delivery. Setting true requires a previously verified receiver.
Response
The subscription active state was updated, or the saved response for the same operation was replayed.
Subscription UUID chosen by the client when creating it.
Integration label.
HTTPS receiver URL.
Subscribed event types.
contact.created, contact.updated, contact.deleted, list.created, list.updated, list.deleted, list.membership_updated, call.created, call.updated, call.deleted, call.completed, call.disposition_updated, recording.available, transcript.available, contact.access_revoked, list.access_revoked Whether delivery is enabled. Creating or replacing configuration pauses delivery until verification.
Time of the most recent successful verification, or null.
Subscription creation time in UTC.