Skip to content

Overview

THG Connect Integration Platform utilises Event-based patterns for asynchronous integration to any available product, all changes to data, partnerships, etc. will trigger an event of varying types. These are designed to be consumed by both consumer and providers of a partnership through the use of subscriptions.

Structure

All events created within the platform will conform to a standard event resource, this resource will contain a type, id, attributes and meta.

Example Event Payload:

{
"id": "AQEBXbrH27EN4oVoO3UqfE7AHNRTO3/GSlZ9yMk1JrW1T3boAOc6Mh91IxJ5LzKhEAsJ5BvnyYPnaz7nh8kyVJXJWiLHv4sbWnSmmtEe8xYKmpePc+zAhdvA8HdAd+aX0IA0FCjyXo3sZf/YXyyAXK6LfiKfU5y/oT4W8sZDOiXlRufuIdzcDCpxF2kH5Ge9c4z08WMXgYsXxvQP9fJHDLmPNXXe67zyBfLeo0SMvShQQ96qz8XO2OSjHJ4xtE5PVmR9eCMIolH1JVDi2OGPY/ugxuD9my9T+BYKJIBJnrLfgRGldtS30gpog5BSZPCyMXCIGqRMTlQdDcosxbiqSybculhCHZ5qLbKlXDBX+egc1turNAtpTesWMOECZfT8XjDshEu5KJp3jU2ToWWyVfp2K+dIdNTNYt46nHxMdNvZhcWiC/IvaBJZVSnfjwQRFeII",
"type": "DataChangedEvent",
"attributes": {
"id": "d91063ad-8164-419b-8fe5-4368f4416f34",
"type": "thg-commerce:site",
"version": "1",
"attributes": {
"siteName": "will test site 5",
"domainName": "https://will-site.test"
},
"links": null,
"meta": {
"product": "thg-commerce",
"reference": "thg:thg-commerce:site:thgcommerce@d91063ad-8164-419b-8fe5-4368f4416f34",
"createdAt": "2025-04-23T09:22:11.530782",
"updatedAt": "2025-04-23T09:28:23.013937",
"status": {
"site-status": {
"value": "APPROVED"
}
},
"owner": "thgcommerce",
"creator": "thgaltitude"
}
},
"meta": {
"receiptHandle": "AQEBXbrH27EN4oVoO3UqfE7AHNRTO3/GSlZ9yMk1JrW1T3boAOc6Mh91IxJ5LzKhEAsJ5BvnyYPnaz7nh8kyVJXJWiLHv4sbWnSmmtEe8xYKmpePc+zAhdvA8HdAd+aX0IA0FCjyXo3sZf/YXyyAXK6LfiKfU5y/oT4W8sZDOiXlRufuIdzcDCpxF2kH5Ge9c4z08WMXgYsXxvQP9fJHDLmPNXXe67zyBfLeo0SMvShQQ96qz8XO2OSjHJ4xtE5PVmR9eCMIolH1JVDi2OGPY/ugxuD9my9T+BYKJIBJnrLfgRGldtS30gpog5BSZPCyMXCIGqRMTlQdDcosxbiqSybculhCHZ5qLbKlXDBX+egc1turNAtpTesWMOECZfT8XjDshEu5KJp3jU2ToWWyVfp2K+dIdNTNYt46nHxMdNvZhcWiC/IvaBJZVSnfjwQRFeII",
"subscriptionId": "WillSiteSubscription",
"method": "update"
}
}

The above example is of a Data Changed Event, in the data section is the payload of the data object being changed. Then within the meta is any platform data associated to the event.

Common Event Types