EventSources

Create event source

Creates an external event source. Two kinds:

  • Connected-app trigger (default): deploys a third-party trigger. The account must have previously connected the underlying app (Gmail, Slack, Calendar, etc.) at /integrations. Use GET /event_sources/available?app=... to discover the vendor_component_id values. configured_props carries only that trigger's own settings (label, sheet, channel, filters) — the connected account it runs as is resolved automatically from the linked app, and the deploy fails with a message naming the app if none is connected.
  • Inbound webhook (vendor: "webhook"): a Crevio-hosted URL any service (Typeform, Stripe, GitHub, Zapier, a custom script) can POST JSON to. event_name is a short name (e.g. typeform_applications); the source's event_name becomes webhook.<name>. The response's inbound_url carries an unguessable token and is the credential — treat it as a secret. Set signature_required: true to also require an HMAC-SHA256 signature (X-Hub-Signature-256, Typeform-Signature, X-Signature, or Standard Webhooks headers); the signing secret is shown only to the account's admins in the Crevio app, never over the API. Unknown or inactive URLs answer 404; bodies over 1 MB answer 413.

Once active, every delivery fires external.<event_name> and any AiTask with trigger_type: "event" + matching event_conditions.event_type runs with the delivered payload as event.data.

post/event_sources

Request

  • Base URL: https://api.crevio.co/v1
  • URL: https://api.crevio.co/v1/event_sources
  • Auth: API key in header Authorization

Headers

Idempotency-Keystring

Makes this write safe to retry: a repeat with the same key replays the first response instead of creating a second resource. Scoped to the account, remembered for 24 hours; reusing a key with a different payload is an error.

Request body

vendor'pipedream' | 'webhook'
vendor_component_idstring nullable
event_namestring
descriptionstring nullable
signature_requiredboolean
configured_propsobject

Response

Event source created

idstring required
objectstring required
vendor'pipedream' | 'webhook' required
vendor_trigger_idstring nullable required
vendor_component_idstring nullable required
event_namestring required
configured_propsobject required
descriptionstring nullable required
signature_requiredboolean required
activeboolean required
last_delivered_atstring date-time nullable required
created_atstring date-time required
updated_atstring date-time required
qualified_event_namestring required
inbound_urlstring nullable required

Changes

No recorded changes to this operation across all 2 revisions of this API.