Register Incoming Source
A 3-step recipe with Convoy. We can help you get access.
Recipe · 3 steps
Register Incoming Source
with Convoy · Webhook & Event Subscription Management
Create a verified source, subscribe it to an endpoint, and confirm the binding.
- Create an HTTP source with an HMAC verifier so inbound webhook requests are authenticated before ingestion.
- Create a subscription that connects the verified source to the supplied destination endpoint.
- Retrieve the subscription to confirm the source binding and endpoint routing were stored correctly.
What you'll need to have ready
- apiKey: Convoy API key used as the Bearer token on the Authorization header.
- projectID: The Convoy project identifier the source belongs to.
- sourceName: Human-readable name for the incoming source.
- hmacSecret: Shared secret used to HMAC-verify inbound webhook requests.
- hmacHeader: Request header carrying the HMAC signature (e.g. X-Hub-Signature).
- endpointId: Existing destination endpoint the source should route events to.
- subscriptionName: Name for the subscription binding the source to the endpoint.
For your developer
Arazzo workflow convoy:register-incoming-source, 3 operations: CreateSource → CreateSubscription → GetSubscription. Specs on APIs.io.