Oracle Fusion REST API Webhooks: What Actually Exists (Business Events + Atom Feeds)
Search for “oracle fusion rest api webhooks” and you’ll find integration guides that answer the question by pointing at Oracle Content Management’s webhook feature — a real Oracle product, but not Fusion SaaS (HCM/FSCM/ERP), and not what most people mean when they ask. The honest answer is shorter: Oracle Fusion Cloud applications don’t have webhooks in the “give me a URL and I’ll POST to it when something changes” sense that Stripe, GitHub, or Slack have. What Fusion has instead is a layered set of change-notification mechanisms, and which one you use depends on the module and how real-time you actually need to be.
If you’re looking for the HCM-specific mechanism, see Oracle HCM Atom Feeds: REST API Change Detection — this post covers the FSCM/ERP side and the general “why doesn’t Fusion just have webhooks” question.
The three real options, in order of how “push-like” they are
- Business Events (ERP/FSCM) — an internal publish/subscribe mechanism. Fusion raises an event when a transaction happens (an invoice is approved, a PO is created); the event doesn’t leave Fusion on its own — something has to subscribe to it.
- Atom feeds (HCM) — a pull-based feed of recent changes (new hires, terminations, updates) that a client polls on a schedule, filtered by
updated-min/updated-max. Closer to RSS than a webhook. - Oracle Integration Cloud (OIC) as the bridge — this is the piece most “does Fusion have webhooks” questions are actually asking about. OIC’s ERP Adapter can subscribe to Fusion’s business events, and once OIC has the event, an OIC integration flow can do whatever you want with it — including making an outbound HTTP call to your own endpoint. That outbound call is the closest thing to a Fusion “webhook,” but the push only happens because you built an OIC flow to do it. Fusion itself never calls your URL directly.
If you don’t have OIC in the picture, you’re back to polling — either the Atom feeds for HCM, or a scheduled q-filtered REST call for FSCM/ERP resources that don’t have an Atom feed equivalent. See Oracle Fusion REST API Pagination and Rate Limits for the mechanics of doing that politely.
Business Events: checking and enabling them via REST
Business events exist independently of whether anything is listening to them, and by default most are already enabled. The ERP Business Events REST resource lets you check and control that enabled state — it does not deliver events to you; it configures whether Fusion raises them at all for a given business object.
# List business events and their current enabled state
curl -u username:password \
"https://<pod>.fa.<dc>.oraclecloud.com/fscmRestApi/resources/11.13.18.05/erpBusinessEvents" \
-H "REST-Framework-Version: 4"
# Get one specific business event record
curl -u username:password \
"https://<pod>.fa.<dc>.oraclecloud.com/fscmRestApi/resources/11.13.18.05/erpBusinessEvents/{ErpBusinessEventId}" \
-H "REST-Framework-Version: 4"
# Turn a business event off (e.g. to cut noise while troubleshooting)
curl -u username:password -X PATCH \
"https://<pod>.fa.<dc>.oraclecloud.com/fscmRestApi/resources/11.13.18.05/erpBusinessEvents/{ErpBusinessEventId}" \
-H "Content-Type: application/vnd.oracle.adf.resourceitem+json" \
-d '{ "EnabledFlag": false }'
This resource is a control plane, not a data feed — turning an event on doesn’t give you a URL to poll for its payloads. To actually receive the event, something needs to subscribe to it: in practice, that’s OIC’s ERP Adapter, configured as a trigger on a specific business event, which then starts an integration flow with the event payload available to it.
Why the “just use webhooks” advice keeps showing up wrong
A few integration guides answer “does Oracle Fusion have webhooks” by describing Oracle Content Management’s webhook feature, which really does let you register a URL that Content Management calls on document events. It’s a legitimate Oracle product feature — just a different Oracle Cloud service from Fusion SaaS applications (HCM/FSCM/ERP/SCM), which is what almost everyone asking this question means. If a guide’s webhook section is really describing document/content events rather than worker records, invoices, or purchase orders, you’re reading about the wrong product.
Practical guidance
- If you have OIC: use the ERP Adapter’s business-event trigger for FSCM/ERP objects, or the HCM Adapter’s Atom feed subscription for HCM objects. Either way, OIC — not Fusion — is what calls your endpoint.
- If you don’t have OIC and need HCM changes: poll Atom feeds on a schedule with a persisted checkpoint, using
updated-min/updated-max. - If you don’t have OIC and need FSCM/ERP changes with no Atom feed equivalent: a scheduled
q-filtered poll (e.g.LastUpdateDate >= <checkpoint>) is the fallback — see the q parameter guide and watch your rate limits if the polling interval is aggressive. - For bulk, non-real-time sync: neither business events nor Atom feeds are the right tool — that’s what HCM Data Loader / FBDI exist for.
None of this shows up as a single “webhooks” toggle anywhere in Fusion, which is exactly why the question keeps getting asked and answered incorrectly. If you want to see the real shape of the erpBusinessEvents resource or any other endpoint mentioned here, OPAL bundles the parsed OpenAPI spec for the entire Oracle Fusion Cloud surface offline — no login, no waiting on the docs site to load.
This post is part of our complete Oracle Fusion API guide — auth, base URLs, q filters, finders, and the key endpoints in one place.