Reconcile a managed provider trigger registration

curl --request POST \
  --url https://api.checkfu.com/v1/automations/{id}/provider-webhook-registrations/{registrationId}/reconcile \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'checkfu-version: <checkfu-version>' \
  --data '{}'

import requests

url = "https://api.checkfu.com/v1/automations/{id}/provider-webhook-registrations/{registrationId}/reconcile"

payload = {}
headers = {
    "checkfu-version": "<checkfu-version>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'checkfu-version': '<checkfu-version>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({})
};

fetch('https://api.checkfu.com/v1/automations/{id}/provider-webhook-registrations/{registrationId}/reconcile', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.checkfu.com/v1/automations/{id}/provider-webhook-registrations/{registrationId}/reconcile",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json",
    "checkfu-version: <checkfu-version>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.checkfu.com/v1/automations/{id}/provider-webhook-registrations/{registrationId}/reconcile"

	payload := strings.NewReader("{}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("checkfu-version", "<checkfu-version>")
	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.checkfu.com/v1/automations/{id}/provider-webhook-registrations/{registrationId}/reconcile")
  .header("checkfu-version", "<checkfu-version>")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.checkfu.com/v1/automations/{id}/provider-webhook-registrations/{registrationId}/reconcile")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["checkfu-version"] = '<checkfu-version>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{}"

response = http.request(request)
puts response.read_body

{
  "id": "<string>",
  "workspace_id": "<string>",
  "automation_id": "<string>",
  "webhook_source_id": "<string>",
  "connection_id": "<string>",
  "callback_key": "<string>",
  "config": {
    "provider": "<string>",
    "resource": {
      "resource_type": "<string>",
      "external_id": "<string>"
    },
    "event_types": [
      "<string>"
    ],
    "polling_props": {}
  },
  "config_fingerprint": "<string>",
  "status": "pending",
  "external_id": "<string>",
  "claim": {
    "epoch": 1,
    "operation": "create",
    "callback_key": "<string>",
    "config_fingerprint": "<string>",
    "expires_at": "<string>"
  },
  "last_verified_at": "<string>",
  "last_delivery_at": "<string>",
  "last_error": {
    "code": "<string>",
    "at": "<string>"
  },
  "version": 1,
  "created_at": "<string>",
  "updated_at": "<string>"
}

{
  "error": {
    "type": "validation.malformed",
    "message": "<string>",
    "more": "https://docs.checkfu.com/reference/errors#validation-malformed"
  }
}

{
  "error": {
    "type": "auth.invalid_key",
    "message": "<string>",
    "more": "https://docs.checkfu.com/reference/errors#auth-invalid-key"
  }
}

{
  "error": {
    "type": "auth.disabled_tenancy",
    "message": "<string>",
    "more": "https://docs.checkfu.com/reference/errors#auth-disabled-tenancy"
  }
}

{
  "error": {
    "type": "validation.not_found",
    "message": "<string>",
    "more": "https://docs.checkfu.com/reference/errors#validation-not-found"
  }
}

{
  "error": {
    "type": "validation.conflict",
    "message": "<string>",
    "more": "https://docs.checkfu.com/reference/errors#validation-conflict"
  }
}

{
  "error": {
    "type": "budget.exceeded",
    "message": "<string>",
    "more": "https://docs.checkfu.com/reference/errors#budget-exceeded"
  }
}

{
  "error": {
    "type": "runtime.internal",
    "message": "<string>",
    "more": "https://docs.checkfu.com/reference/errors#runtime-internal"
  }
}

Reconcile a managed provider trigger registration

For auto-registration, inspect the provider hook and apply lost-response adoption: only the exact callback key plus config fingerprint may be claimed. Mismatch or unproved ownership settles degraded or indeterminate rather than duplicating, and delete converges when the provider already removed the hook. For polling, request an immediate scheduler retry without calling provider hook APIs; a sustained-auth disabled registration returns to pending and its consecutive-auth counter resets.

Checkfu support posture: alpha; hosted. Required evidence journey: automation-firing. Deployment-specific readiness and the latest proven release are available from GET /v1/support/capabilities.

POST

automations

{id}

provider-webhook-registrations

{registrationId}

reconcile

Reconcile a managed provider trigger registration

curl --request POST \
  --url https://api.checkfu.com/v1/automations/{id}/provider-webhook-registrations/{registrationId}/reconcile \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'checkfu-version: <checkfu-version>' \
  --data '{}'

import requests

url = "https://api.checkfu.com/v1/automations/{id}/provider-webhook-registrations/{registrationId}/reconcile"

payload = {}
headers = {
    "checkfu-version": "<checkfu-version>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'checkfu-version': '<checkfu-version>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({})
};

fetch('https://api.checkfu.com/v1/automations/{id}/provider-webhook-registrations/{registrationId}/reconcile', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.checkfu.com/v1/automations/{id}/provider-webhook-registrations/{registrationId}/reconcile",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json",
    "checkfu-version: <checkfu-version>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.checkfu.com/v1/automations/{id}/provider-webhook-registrations/{registrationId}/reconcile"

	payload := strings.NewReader("{}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("checkfu-version", "<checkfu-version>")
	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.checkfu.com/v1/automations/{id}/provider-webhook-registrations/{registrationId}/reconcile")
  .header("checkfu-version", "<checkfu-version>")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.checkfu.com/v1/automations/{id}/provider-webhook-registrations/{registrationId}/reconcile")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["checkfu-version"] = '<checkfu-version>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{}"

response = http.request(request)
puts response.read_body

{
  "id": "<string>",
  "workspace_id": "<string>",
  "automation_id": "<string>",
  "webhook_source_id": "<string>",
  "connection_id": "<string>",
  "callback_key": "<string>",
  "config": {
    "provider": "<string>",
    "resource": {
      "resource_type": "<string>",
      "external_id": "<string>"
    },
    "event_types": [
      "<string>"
    ],
    "polling_props": {}
  },
  "config_fingerprint": "<string>",
  "status": "pending",
  "external_id": "<string>",
  "claim": {
    "epoch": 1,
    "operation": "create",
    "callback_key": "<string>",
    "config_fingerprint": "<string>",
    "expires_at": "<string>"
  },
  "last_verified_at": "<string>",
  "last_delivery_at": "<string>",
  "last_error": {
    "code": "<string>",
    "at": "<string>"
  },
  "version": 1,
  "created_at": "<string>",
  "updated_at": "<string>"
}

{
  "error": {
    "type": "validation.malformed",
    "message": "<string>",
    "more": "https://docs.checkfu.com/reference/errors#validation-malformed"
  }
}

{
  "error": {
    "type": "auth.invalid_key",
    "message": "<string>",
    "more": "https://docs.checkfu.com/reference/errors#auth-invalid-key"
  }
}

{
  "error": {
    "type": "auth.disabled_tenancy",
    "message": "<string>",
    "more": "https://docs.checkfu.com/reference/errors#auth-disabled-tenancy"
  }
}

{
  "error": {
    "type": "validation.not_found",
    "message": "<string>",
    "more": "https://docs.checkfu.com/reference/errors#validation-not-found"
  }
}

{
  "error": {
    "type": "validation.conflict",
    "message": "<string>",
    "more": "https://docs.checkfu.com/reference/errors#validation-conflict"
  }
}

{
  "error": {
    "type": "budget.exceeded",
    "message": "<string>",
    "more": "https://docs.checkfu.com/reference/errors#budget-exceeded"
  }
}

{
  "error": {
    "type": "runtime.internal",
    "message": "<string>",
    "more": "https://docs.checkfu.com/reference/errors#runtime-internal"
  }
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

checkfu-version

enum<string>

required

Available options:

2026-08-29

idempotency-key

string

Maximum string length: 255

Path Parameters

string

required

Pattern: ^auto_[0-9a-f]{32}$

registrationId

string

required

Pattern: ^pwreg_[0-9a-f]{32}$

Body

application/json

An exact empty JSON object with no named properties.

Response

Closed provider-trigger lifecycle and health for one Automation and WebhookSource. Custody-held credentials never appear; caller-supplied polling props are publicly readable and must not contain credentials.

string

required

Pattern: ^pwreg_[0-9a-f]{32}$

workspace_id

string

required

Pattern: ^wrkspc_[0-9a-f]{32}$

automation_id

string

required

Pattern: ^auto_[0-9a-f]{32}$

webhook_source_id

string

required

Pattern: ^whsrc_[0-9a-f]{32}$

connection_id

string

required

Pattern: ^conn_[0-9a-f]{32}$

callback_key

string

required

Pattern: ^pwcbk_[0-9a-f]{32}$

config

object

required

Show child attributes

config_fingerprint

string

required

Pattern: ^sha256:[0-9a-f]{64}$

status

enum<string>

required

Available options:

pending,

active,

degraded,

disabled,

indeterminate,

revoked,

deleted

external_id

string | null

required

Pattern: ^[a-z0-9](?:[a-z0-9._-]{0,93})$

claim

object | null

required

Show child attributes

last_verified_at

string | null

required

A canonical UTC ISO-8601 timestamp with millisecond precision.

Maximum string length: 24

Pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z$

last_delivery_at

string | null

required

A canonical UTC ISO-8601 timestamp with millisecond precision.

Maximum string length: 24

Pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z$

last_error

object | null

required

Show child attributes

version

integer

required

Required range: x > 0

created_at

string

required

A canonical UTC ISO-8601 timestamp with millisecond precision.

Maximum string length: 24

Pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z$

updated_at

string

required

A canonical UTC ISO-8601 timestamp with millisecond precision.

Maximum string length: 24

Pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z$

Developer tools

Canonical tables

Author protocols

Generated HTTP API

Reconcile a managed provider trigger registration

Authorizations

Headers

Path Parameters

Body

Response