Nuvemshop Tiendanube · AsyncAPI Specification

Nuvemshop Tiendanube Webhook Events

Version 2025-03

Webhook event surface for the Nuvemshop/Tiendanube platform. Apps register a Webhook resource (event + url) and receive HTTP POST callbacks signed with HMAC-SHA256 in the x-linkedstore-hmac-sha256 header.

View Spec View on GitHub CompanyE-CommerceRetailOnline StoresPaymentsShippingWebhooksOAuthLatin AmericaStorefrontApps PlatformAsyncAPIWebhooksEvents

Channels

app/uninstalled

app/suspended

app/resumed

category/created

category/updated

category/deleted

customer/created

customer/updated

customer/deleted

order/created

order/updated

order/paid

order/packed

order/fulfilled

order/cancelled

order/custom_fields_updated

order/edited

order/pending

order/voided

product/created

product/updated

product/deleted

product_variant/custom_fields_updated

domain/updated

subscription/updated

fulfillment/updated

fulfillment_order/status_updated

fulfillment_order/tracking_event_created

location/created

location/updated

location/deleted

store/redact

customers/redact

customers/data_request

Messages

✉

storeEvent

Servers

https

merchant-endpoint {app_webhook_url}

The HTTPS endpoint the app registers to receive webhook POSTs.

AsyncAPI Specification

# generated: '2026-07-20'
# method: generated
# source: https://tiendanube.github.io/api-documentation/resources/webhook
# note: Faithful AsyncAPI generated from the provider's documented webhook event
#       catalog. Nuvemshop/Tiendanube does not publish an AsyncAPI document; this
#       captures the real event names and HMAC-SHA256 signature binding.
asyncapi: 2.6.0
info:
  title: Nuvemshop Tiendanube Webhook Events
  version: '2025-03'
  description: >-
    Webhook event surface for the Nuvemshop/Tiendanube platform. Apps register a
    Webhook resource (event + url) and receive HTTP POST callbacks signed with
    HMAC-SHA256 in the x-linkedstore-hmac-sha256 header.
defaultContentType: application/json
servers:
  merchant-endpoint:
    url: '{app_webhook_url}'
    protocol: https
    description: The HTTPS endpoint the app registers to receive webhook POSTs.
    variables:
      app_webhook_url:
        default: https://example.com/webhooks
components:
  messageTraits:
    signed:
      headers:
        type: object
        properties:
          x-linkedstore-hmac-sha256:
            type: string
            description: HMAC-SHA256 signature of the raw body using the app client secret.
  messages:
    storeEvent:
      contentType: application/json
      traits:
      - $ref: '#/components/messageTraits/signed'
      payload:
        type: object
        properties:
          store_id:
            type: integer
          event:
            type: string
          id:
            type: integer
            description: Identifier of the affected resource (when applicable).
channels:
  app/uninstalled: { subscribe: { message: { $ref: '#/components/messages/storeEvent' } } }
  app/suspended: { subscribe: { message: { $ref: '#/components/messages/storeEvent' } } }
  app/resumed: { subscribe: { message: { $ref: '#/components/messages/storeEvent' } } }
  category/created: { subscribe: { message: { $ref: '#/components/messages/storeEvent' } } }
  category/updated: { subscribe: { message: { $ref: '#/components/messages/storeEvent' } } }
  category/deleted: { subscribe: { message: { $ref: '#/components/messages/storeEvent' } } }
  customer/created: { subscribe: { message: { $ref: '#/components/messages/storeEvent' } } }
  customer/updated: { subscribe: { message: { $ref: '#/components/messages/storeEvent' } } }
  customer/deleted: { subscribe: { message: { $ref: '#/components/messages/storeEvent' } } }
  order/created: { subscribe: { message: { $ref: '#/components/messages/storeEvent' } } }
  order/updated: { subscribe: { message: { $ref: '#/components/messages/storeEvent' } } }
  order/paid: { subscribe: { message: { $ref: '#/components/messages/storeEvent' } } }
  order/packed: { subscribe: { message: { $ref: '#/components/messages/storeEvent' } } }
  order/fulfilled: { subscribe: { message: { $ref: '#/components/messages/storeEvent' } } }
  order/cancelled: { subscribe: { message: { $ref: '#/components/messages/storeEvent' } } }
  order/custom_fields_updated: { subscribe: { message: { $ref: '#/components/messages/storeEvent' } } }
  order/edited: { subscribe: { message: { $ref: '#/components/messages/storeEvent' } } }
  order/pending: { subscribe: { message: { $ref: '#/components/messages/storeEvent' } } }
  order/voided: { subscribe: { message: { $ref: '#/components/messages/storeEvent' } } }
  product/created: { subscribe: { message: { $ref: '#/components/messages/storeEvent' } } }
  product/updated: { subscribe: { message: { $ref: '#/components/messages/storeEvent' } } }
  product/deleted: { subscribe: { message: { $ref: '#/components/messages/storeEvent' } } }
  product_variant/custom_fields_updated: { subscribe: { message: { $ref: '#/components/messages/storeEvent' } } }
  domain/updated: { subscribe: { message: { $ref: '#/components/messages/storeEvent' } } }
  subscription/updated: { subscribe: { message: { $ref: '#/components/messages/storeEvent' } } }
  fulfillment/updated: { subscribe: { message: { $ref: '#/components/messages/storeEvent' } } }
  fulfillment_order/status_updated: { subscribe: { message: { $ref: '#/components/messages/storeEvent' } } }
  fulfillment_order/tracking_event_created: { subscribe: { message: { $ref: '#/components/messages/storeEvent' } } }
  location/created: { subscribe: { message: { $ref: '#/components/messages/storeEvent' } } }
  location/updated: { subscribe: { message: { $ref: '#/components/messages/storeEvent' } } }
  location/deleted: { subscribe: { message: { $ref: '#/components/messages/storeEvent' } } }
  store/redact: { subscribe: { message: { $ref: '#/components/messages/storeEvent' } } }
  customers/redact: { subscribe: { message: { $ref: '#/components/messages/storeEvent' } } }
  customers/data_request: { subscribe: { message: { $ref: '#/components/messages/storeEvent' } } }