Webhooks

Webhooks are used to notify external systems of changes within Struct PIM through a web request

Get a webhook

get

#Available from v.3.11.0

Authorizations

ApiKey

AuthorizationstringRequired

Path parameters

uidstring · uuidRequired

Uid of webhook

Responses

200

OK

application/json

Model representing a webhook

Uidstring · uuidOptional

Unique id of webhook

Titlestring · nullableOptional

Title of webhook

Urlstring · nullableOptional

Url for the webhook to request when triggered

ActivebooleanOptional

Activate / deactivate webhook

EnabledEventsstring[] · nullableOptional

Events this webhook shall act on

get

/v1/webhooks/{uid}

HTTPcURLJavaScriptPython

GET /v1/webhooks/{uid} HTTP/1.1
Authorization: YOUR_API_KEY
Accept: */*

200

OK

{
  "Uid": "708de479-ad79-4668-af49-cf2bee48ae3e",
  "Title": "Website integration",
  "Url": "https://someeventhub.com/triggerme",
  "Active": true,
  "EnabledEvents": [
    "variants:created",
    "variants:updated",
    "variants:deleted"
  ],
  "AdvancedSettings": {
    "variants:updated": {
      "ConditionalTriggering": true,
      "TriggerOnProductIdUpdates": false,
      "TriggerOnVariantGroupIdUpdates": false,
      "TriggerOnSortOrderUpdates": false,
      "TriggerOnVariantGroupSortOrderUpdates": false,
      "TriggerOnArchivingUpdates": false,
      "TriggerOnAttributeUpdates": {},
      "AttributesToTriggerOn": null,
      "DataModelType": {},
      "EventSettingsType": "VariantsUpdatedEventArgsAdvancedSettings"
    }
  },
  "RequestHeaders": []
}

Delete a webhook

delete

Authorizations

ApiKey

AuthorizationstringRequired

Path parameters

uidstring · uuidRequired

Uid of webhook to delete

Responses

200

OK

No content

delete

/v1/webhooks/{uid}

HTTPcURLJavaScriptPython

DELETE /v1/webhooks/{uid} HTTP/1.1
Authorization: YOUR_API_KEY
Accept: */*

200

OK

No content

Get all configured webhooks

get

Authorizations

ApiKey

AuthorizationstringRequired

Responses

200

OK

application/json

Model representing a webhook

Uidstring · uuidOptional

Unique id of webhook

Titlestring · nullableOptional

Title of webhook

Urlstring · nullableOptional

Url for the webhook to request when triggered

ActivebooleanOptional

Activate / deactivate webhook

EnabledEventsstring[] · nullableOptional

Events this webhook shall act on

get

/v1/webhooks

HTTPcURLJavaScriptPython

GET /v1/webhooks HTTP/1.1
Authorization: YOUR_API_KEY
Accept: */*

200

OK

[
  {
    "Uid": "1c2d98d6-ffb5-48ba-a590-11c3a41b60b6",
    "Title": "Website integration",
    "Url": "https://someeventhub.com/triggerme",
    "Active": true,
    "EnabledEvents": [
      "variants:created",
      "variants:updated",
      "variants:deleted"
    ],
    "AdvancedSettings": {
      "variants:updated": {
        "ConditionalTriggering": true,
        "TriggerOnProductIdUpdates": false,
        "TriggerOnVariantGroupIdUpdates": false,
        "TriggerOnSortOrderUpdates": false,
        "TriggerOnVariantGroupSortOrderUpdates": false,
        "TriggerOnArchivingUpdates": false,
        "TriggerOnAttributeUpdates": {},
        "AttributesToTriggerOn": null,
        "DataModelType": {},
        "EventSettingsType": "VariantsUpdatedEventArgsAdvancedSettings"
      }
    },
    "RequestHeaders": []
  },
  {
    "Uid": "afd3dae3-5381-446a-a5e1-db8ac7186262",
    "Title": "Website integration",
    "Url": "https://integrations.com/productupdate",
    "Active": true,
    "EnabledEvents": [
      "products:created",
      "products:updated"
    ],
    "AdvancedSettings": null,
    "RequestHeaders": []
  }
]

Create a new webhook

post

Authorizations

ApiKey

AuthorizationstringRequired

Body

application/json

Model representing a webhook

Uidstring · uuidOptional

Unique id of webhook

Titlestring · nullableOptional

Title of webhook

Urlstring · nullableOptional

Url for the webhook to request when triggered

ActivebooleanOptional

Activate / deactivate webhook

EnabledEventsstring[] · nullableOptional

Events this webhook shall act on

Responses

200

OK

No content

post

/v1/webhooks

HTTPcURLJavaScriptPython

POST /v1/webhooks HTTP/1.1
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 628

{
  "Uid": "a6eb804c-27c8-4459-b0e7-e29aecee7188",
  "Title": "Website integration",
  "Url": "https://someeventhub.com/triggerme",
  "Active": true,
  "EnabledEvents": [
    "variants:created",
    "variants:updated",
    "variants:deleted"
  ],
  "AdvancedSettings": {
    "variants:updated": {
      "ConditionalTriggering": true,
      "TriggerOnProductIdUpdates": false,
      "TriggerOnVariantGroupIdUpdates": false,
      "TriggerOnSortOrderUpdates": false,
      "TriggerOnVariantGroupSortOrderUpdates": false,
      "TriggerOnArchivingUpdates": false,
      "TriggerOnAttributeUpdates": {},
      "AttributesToTriggerOn": null,
      "DataModelType": {},
      "EventSettingsType": "VariantsUpdatedEventArgsAdvancedSettings"
    }
  },
  "RequestHeaders": []
}

200

OK

No content

Update a webhook

put

Authorizations

ApiKey

AuthorizationstringRequired

Body

application/json

Model representing a webhook

Uidstring · uuidOptional

Unique id of webhook

Titlestring · nullableOptional

Title of webhook

Urlstring · nullableOptional

Url for the webhook to request when triggered

ActivebooleanOptional

Activate / deactivate webhook

EnabledEventsstring[] · nullableOptional

Events this webhook shall act on

Responses

200

OK

No content

put

/v1/webhooks

HTTPcURLJavaScriptPython

PUT /v1/webhooks HTTP/1.1
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 628

{
  "Uid": "4881363b-9793-45a1-a652-560a4b3699af",
  "Title": "Website integration",
  "Url": "https://someeventhub.com/triggerme",
  "Active": true,
  "EnabledEvents": [
    "variants:created",
    "variants:updated",
    "variants:deleted"
  ],
  "AdvancedSettings": {
    "variants:updated": {
      "ConditionalTriggering": true,
      "TriggerOnProductIdUpdates": false,
      "TriggerOnVariantGroupIdUpdates": false,
      "TriggerOnSortOrderUpdates": false,
      "TriggerOnVariantGroupSortOrderUpdates": false,
      "TriggerOnArchivingUpdates": false,
      "TriggerOnAttributeUpdates": {},
      "AttributesToTriggerOn": null,
      "DataModelType": {},
      "EventSettingsType": "VariantsUpdatedEventArgsAdvancedSettings"
    }
  },
  "RequestHeaders": []
}

200

OK

No content

Get requests made from a webhook. Note that webhook requests are only stored for 14 days

get

Authorizations

ApiKey

AuthorizationstringRequired

Path parameters

webhookUidstring · uuidRequired

Uid of webhook

Query parameters

sincestring · date-timeOptional

return webhook requests newer than this timestamp

onlyFailedbooleanOptional

Only return failed webhook requests

pageinteger · int32Optional

Page to get (1 is first page)

Responses

200

OK

application/json

Model containing response from a webhook request search

Pageinteger · int32Optional

Page of the search request

TotalHitsinteger · int32Optional

Total number of hits in the search

get

/v1/webhooks/{webhookUid}/requests

HTTPcURLJavaScriptPython

GET /v1/webhooks/{webhookUid}/requests HTTP/1.1
Authorization: YOUR_API_KEY
Accept: */*

200

OK

{
  "WebhookRequests": [
    {
      "Uid": "715782e7-e7a6-4b81-859b-ba796959e702",
      "WebhookUid": "578f4c10-0994-4c59-8bc1-39d0305ad94f",
      "WebhookUrl": "https://structintegration.com/pimevent",
      "EventKey": "products:updated",
      "EventTimestamp": "2025-11-03T22:40:49.1774518+01:00",
      "RequestTimestamp": "2025-11-03T22:40:49.1874662+01:00",
      "RequestHeaders": {
        "X-Event-Key": "products:updated",
        "X-User": "[email protected]",
        "X-Hook-UID": "578f4c10-0994-4c59-8bc1-39d0305ad94f",
        "X-Request-UID": "715782e7-e7a6-4b81-859b-ba796959e702"
      },
      "RequestBody": "{\"ProductIds\":[2385147],\"TransactionUid\":\"40239249-8feb-4e22-b854-fd693ce1d8a7\"}",
      "ElapsedMilliseconds": 57,
      "ResponseCode": 200,
      "ResponseHeaders": {
        "Pragma": "no-cache",
        "Cache-Control": "no-cache",
        "Date": "Fri, 03 Feb 2023 13:07:40 GMT"
      },
      "ParentWebhookRequestUid": "9dda0fc0-9b2f-4d2c-b106-4d98302d8231",
      "IsRetry": false
    }
  ],
  "Page": 1,
  "TotalHits": 1
}

Get a specific request made from a webhook. Note that webhook requests are only stored for 14 days

get

Authorizations

ApiKey

AuthorizationstringRequired

Path parameters

webhookUidstring · uuidRequired

Uid of webhook

requestUidstring · uuidRequired

Uid of webhook request

Responses

200

OK

application/json

Model representing a webhook request

Uidstring · uuidOptional

Unique id of this webhook request (Passed in the X-Request-UID header of the request)

WebhookUidstring · uuidOptional

Unique id of the webhook that triggered the request (Passed in the X-Hook-UID header of the request)

WebhookUrlstring · nullableOptional

Url that was called

EventKeystring · nullableOptional

The key of the event that triggered the event (Passed in the X-Event-Key header of the request)

EventTimestampstring · date-timeOptional

Timestamp of the event that triggered the webhook request

RequestTimestampstring · date-timeOptional

Timestamp of when the webhook request was made

RequestBodystring · nullableOptional

The request body sent in the webhook request

ElapsedMillisecondsinteger · int64Optional

The time in ms it took to get a response from the recipient of the request

ResponseCodeinteger · int32Optional

The response code of the webhook request

ParentWebhookRequestUidstring · uuid · nullableOptional

Uid of parent webhook request (only has value, if this is a retry of a failed webhook request)

IsRetrybooleanRead-onlyOptional

Indicates whether this request is a retry of a previously failed request

get

/v1/webhooks/{webhookUid}/requests/{requestUid}

HTTPcURLJavaScriptPython

GET /v1/webhooks/{webhookUid}/requests/{requestUid} HTTP/1.1
Authorization: YOUR_API_KEY
Accept: */*

200

OK

{
  "Uid": "715782e7-e7a6-4b81-859b-ba796959e702",
  "WebhookUid": "578f4c10-0994-4c59-8bc1-39d0305ad94f",
  "WebhookUrl": "https://structintegration.com/pimevent",
  "EventKey": "products:updated",
  "EventTimestamp": "2025-11-03T22:40:49.1780709+01:00",
  "RequestTimestamp": "2025-11-03T22:40:49.1880722+01:00",
  "RequestHeaders": {
    "X-Event-Key": "products:updated",
    "X-User": "[email protected]",
    "X-Hook-UID": "578f4c10-0994-4c59-8bc1-39d0305ad94f",
    "X-Request-UID": "715782e7-e7a6-4b81-859b-ba796959e702"
  },
  "RequestBody": "{\"ProductIds\":[2385147],\"TransactionUid\":\"40239249-8feb-4e22-b854-fd693ce1d8a7\"}",
  "ElapsedMilliseconds": 57,
  "ResponseCode": 200,
  "ResponseHeaders": {
    "Pragma": "no-cache",
    "Cache-Control": "no-cache",
    "Date": "Fri, 03 Feb 2023 13:07:40 GMT"
  },
  "ParentWebhookRequestUid": "4860f963-f500-4216-95e3-94fb01ee40b9",
  "IsRetry": false
}