Skip to main content

​
Prerequisites

The connector should already be set up, with a Connector Profile and a Linked Account. See Getting Started on the Go1 connector page.

​
How webhooks are set up

StackOne creates and manages the webhook subscription automatically when the account is connected. It registers a single Go1 webhook named StackOne webhook for the connected portal, covering every event you enable, and updates it when the selection changes. There is nothing to configure in Go1.

  • Do not edit or deactivate the StackOne webhook in Go1 (visible with the connector’s list_webhooks action). Changing its URL, event types, or status stops event delivery.

​
Available webhook events

The following Go1 events can be enabled. Only events selected in StackOne are registered on the Go1 webhook.

1

Enrollment events

Events related to the lifecycle of learner enrollments.

  • Enrollment Created (enrollment.create) — Fired when a user starts or is assigned a learning object
  • Enrollment Completed (enrollment.complete) — Fired when a user completes a learning object
  • Enrollment Deleted (enrollment.delete) — Fired when an enrollment is deleted
2

Content events

Events related to the content available to the portal.

  • Content Added (content.add) — Fired when a learning object is added to the portal’s available content
  • Content Updated (content.update) — Fired when a subscribed, parent-level learning object is updated
  • Content Removed (content.remove) — Fired when a learning object is removed from the portal’s content offering
  • Content Decommission Pending (content.decommission.pending) — Fired when a learning object is flagged for decommissioning on a future date
  • Content Decommissioned (content.decommission) — Fired when a learning object is decommissioned and stops accepting new enrollments
3

Content Library events

Events related to the portal’s curated Library.

  • Library Content Added (content.library.add) — Fired when a learning object is added to the curated Library
  • Library Content Updated (content.library.update) — Fired when a learning object in the curated Library is updated
  • Library Content Removed (content.library.remove) — Fired when a learning object is removed from the curated Library
  • Library Content Decommissioned (content.library.decommission) — Fired when a learning object in the curated Library is decommissioned
  • Library Sync Requested (content.library.sync.request) — Fired when an admin requests a Library sync. Only fires for webhooks registered with a Go1-issued integration system ID

​
Delivery format

Go1 sends one JSON request per event. Each request has the event type in event_type, a delivery id that stays the same across retries, and a data object with the enrollment or learning object id, portal_id, and event_time. Payloads carry IDs only, so use the connector’s get actions for full details.

  • Go1 retries a delivery that times out after 10 seconds or returns a non-2xx status: after 30 seconds, then 15 minutes, 4 hours, and 24 hours.
  • content.add and content.remove are portal-scoped. A webhook on a master portal does not receive them for child portals.

​
Verify

Your Connector should now be able to receive and process events. Try triggering an event and you should see an Event appear in the Connector logs.