Offer events

The offer and offer condition workflows emit events after they write. Subscribe to them to reindex search, sync an external system, or start a follow-up workflow instead of polling.

The offer workflows emit one event per affected offer. The names come from OfferWorkflowEvents.

Event	Emitted when	Payload
`offer.created`	`createOffersWorkflow` creates an offer	`{ id, product_id }`
`offer.updated`	`updateOffersWorkflow` updates an offer	`{ id, product_id }`
`offer.updated`	`batchOfferInventoryItemsWorkflow` changes an offer’s inventory links	`{ id }`
`offer.deleted`	`deleteOffersWorkflow` soft-deletes an offer	`{ id, product_id }`

upsertOfferPricesWorkflow emits no event of its own. When updateOffersWorkflow runs it, offer.updated covers the change. When you run it directly, use its offerPricesUpserted hook.

Offer condition events

The condition workflows emit one event per condition. The names come from OfferConditionWorkflowEvents.

Event	Emitted when	Payload
`offer_condition.created`	`createOfferConditionsWorkflow` creates a condition	`{ id }`
`offer_condition.updated`	`updateOfferConditionsWorkflow` updates a condition	`{ id }`
`offer_condition.deleted`	`deleteOfferConditionsWorkflow` deletes a condition	`{ id }`

A subscriber receives the payload and the container. This one reads the new offer with its store.

src/subscribers/offer-created.ts

import type { SubscriberArgs, SubscriberConfig } from "@medusajs/framework"
import { ContainerRegistrationKeys } from "@medusajs/framework/utils"

export default async function offerCreatedHandler({
  event,
  container,
}: SubscriberArgs<{ id: string; product_id: string }>) {
  const query = container.resolve(ContainerRegistrationKeys.QUERY)
  const { data: [offer] } = await query.graph({
    entity: "offer",
    fields: ["id", "sku", "seller.name"],
    filters: { id: event.data.id },
  })
  container.resolve("logger").info(`${offer.seller.name} listed ${offer.sku}`)
}

export const config: SubscriberConfig = {
  event: "offer.created",
}

Payloads carry ids only, so query the offer for the fields you need. For an offer.deleted subscriber, read values from the offersDeleted hook instead, since the row is already soft-deleted.

Store

Catalog

Offer

Attribute

Product Edit

Order Group

Commission

Payout

Review

Offer events

Offer events

Offer condition events

​Offer events

​Offer condition events

​Subscribe to an offer event

​Related

Offer events

Offer condition events

Subscribe to an offer event

Related