Circle
Verification available
v2 notifications only, not legacy SNS. A pinned key ID and public key are required; key retrieval and rotation are manual. No incoming certificate URL is trusted.
Signature scheme
- Algorithm
- ECDSA P-256/SHA256
- Signature
- X-Circle-Signature + X-Circle-Key-Id
- Signed data
- original body
- Encoding
- base64 ASN.1 signature
- Timestamp
- No signed freshness check
Configure verification
Create or edit a source, enable Verify signature and search for Circle. The source remains active independently of this switch. Save the provider and its configuration together.
Copy the exact ingress URL from your source when configuring the sender. Save every required field together; saved configuration is encrypted and never returned in source reads.
- Trusted key ID (
key_id) (required). - Trusted Circle public key (
public_key) (required). Get the matching key through Circle's authenticated public-key endpoint; paste base64 SPKI or PEM.
For API clients, encode these fields as one JSON object inside the signing_secret string. The dashboard assembles it from the fields above.
Inspect the recorded valid, invalid or not-checked signature result after sending a new event. Changing configuration does not change historical results; replay preserves the original bytes and does not re-sign the webhook.
Capture, delivery and acknowledgement
Verification availability describes the inbound validator. The original incoming query string is not retained or forwarded, and the destination URL or path can differ from the signed request. Acklane does not re-sign deliveries; schemes using that original context may not be verifiable again at the destination.
With async enabled, a failed signature may still be captured and retained, but does not become eligible for signature-on delivery. Replay requires current source eligibility, preserves the event ID and original content, and creates a separate delivery history.
Async capture returns 202 after durable acceptance. A provider that requires HTTP 200 or a special acknowledgement may retry; an implemented validator does not establish compatibility with its acknowledgement rules. No real provider sandbox delivery is certified by this catalog.