Source type

CircleCI Source Configuration

CircleCI sources receive workflow and job webhooks and verify CircleCI's outbound webhook signature.

CIRCLECIPOST, PUT, PATCH, DELETEWebhook Signing SecretDeveloper tools
CircleCI webhooks documentationAll source types
CircleCI sends webhook traffic to a FastHook source, FastHook validates the provider contract, records the request, and routes accepted events through connections to destinations.CircleCIProviderPOST, PUT, PATCH, DELETESignedFastHookSource URLCIRCLECIProvider credentialsignatureVerify before queue401 on auth failure405 on wrong methodAcceptedRequestverified: trueConnections route the accepted request to destinationsFilters, transformations, retries, replay, and destination signatures stay downstream from source verification.

CircleCI configuration

Create a CircleCI source, keep POST and PUT and PATCH and DELETE enabled, and provide the configured Webhook Signing Secret values for provider signature. FastHook uses these settings to validate each CircleCI delivery before it enters the routing workflow.

Source Type

CIRCLECI

Allowed methods

POST, PUT, PATCH, DELETE

Authentication

Provider signature

Credential fields

Webhook Signing Secret

CircleCI source config
{
  "type": "CIRCLECI",
  "config": {
    "auth_type": "PROVIDER_SIGNATURE",
    "auth": {
      "provider": "CIRCLECI",
      "webhook_signing_secret": "provider-secret"
    },
    "allowed_http_methods": ["POST","PUT","PATCH","DELETE"]
  }
}

CircleCI request contract

FastHook computes HMAC-SHA256 hex over the raw body and compares it with the v1 value in circleci-signature.

POSTPUTPATCHDELETE

CircleCI headers

Preserve circleci-signature when sending CircleCI test deliveries. FastHook evaluates this request context before accepting the payload, so missing or modified values remain visible as rejected requests instead of routed events.

circleci-signature

v1 HMAC-SHA256 signature or plain signature value.

CircleCI setup

  1. Create a CircleCI outbound webhook using the FastHook Source URL.
  2. Paste the webhook signing secret into FastHook.
  3. Use pipeline, workflow, and project fields to route CI notifications.

Continue with CircleCI