Skip to content
Getting Started
/
/
/
Collection Created

Webhooks Introduction (v1.0)

What is a webhook? A webhook is an HTTP request, triggered by an event in a source system (Tenovos) and sent to a destination system.

The destination system is managed by the receiver (customer) of the webhook, or for faster and easier implementation, Tenovos Connect can automatically generate endpoints for receiving webhooks from Tenovos, or any other system.

Webhooks are automated, in other words they are automatically sent out when their corresponding event occurs in Tenovos. These events occur whether you are using the Tenovos UI, or your own custom UI on top of the Tenovos platform.

Find out more about Tenovos
Download OpenAPI description
reference.json
reference.yaml
Overview
E-mail
product@tenovos.com
License
Tenovos Active Story Management
Terms of Service
Languages
Servers
https://api.tenovos.io/v2
https://api.uat.tenovos.io/v2

Assets

Asset related events

Webhooks

Collections

Collection related events

Webhooks

Collection CreatedWebhook

Request

Receive a notification when an Collection in Tenovos is created.

Security
OAuth2
Bodyapplication/json

Information about a Collection when it is created in Tenovos.

eventTypestring

Combination of the Topic and the Event

Example: "collection.created"
eventobject(event)

Object containing event information and the user who triggered the event.

collectionobject(collection)
application/json
{
  "eventType": "collection.created",
  "event": {
    "id": "some-event-type-d231cf1d-86b2-436e-95de-b745c39d2ed5",
    "time": "2024-05-09T17:55:28.462Z",
    "user": { … }
  },
  "collection": {
    "id": "147c8d3d-e0f4-497f-86d3-aa2a4166f304",
    "name": "Outdoor 2025 Spring Catalog",
    "type": "Private"
  }
}

Responses

Return a 200 status to Tenovos to indicate that the data was received successfully

Headers
webhook-idstring

The unique message identifier for the webhook message. This identifier is unique across all messages, but will be the same when the same webhook is being resent (e.g. due to a previous failure).

webhook-timestampstring

Timestamp in seconds since epoch.

webhook-signaturestring

The Base64 encoded list of signatures (space delimitated)

Collection UpdatedWebhook

Request

Receive a notification when an asset is added to or removed from a Collection.

Security
OAuth2
Bodyapplication/json

Information about assets are added to or removed from a Collection.

eventTypestring

Combination of the Topic and the Event

Example: "collection.updated"
eventobject(event)

Object containing event information and the user who triggered the event.

collectionobject(collection.updated)
application/json
{
  "eventType": "collection.updated",
  "event": {
    "id": "some-event-type-d231cf1d-86b2-436e-95de-b745c39d2ed5",
    "time": "2024-05-09T17:55:28.462Z",
    "user": { … }
  },
  "collection": {
    "id": "147c8d3d-e0f4-497f-86d3-aa2a4166f304",
    "name": "Outdoor 2025 Spring Catalog",
    "type": "Private",
    "metadata": [ … ],
    "security": { … }
  }
}

Responses

Return a 200 status to Tenovos to indicate that the data was received successfully

Headers
webhook-idstring

The unique message identifier for the webhook message. This identifier is unique across all messages, but will be the same when the same webhook is being resent (e.g. due to a previous failure).

webhook-timestampstring

Timestamp in seconds since epoch.

webhook-signaturestring

The Base64 encoded list of signatures (space delimitated)

Collection DeletedWebhook

Request

Receive a notification when a Collection in Tenovos is deleted.

Security
OAuth2
Bodyapplication/json

Information about a Collection when it is deleted from Tenovos.

eventTypestring

Combination of the Topic and the Event

Example: "collection.deleted"
eventobject(event)

Object containing event information and the user who triggered the event.

collectionobject(collection)
application/json
{
  "eventType": "collection.deleted",
  "event": {
    "id": "some-event-type-d231cf1d-86b2-436e-95de-b745c39d2ed5",
    "time": "2024-05-09T17:55:28.462Z",
    "user": { … }
  },
  "collection": {
    "id": "147c8d3d-e0f4-497f-86d3-aa2a4166f304",
    "name": "Outdoor 2025 Spring Catalog",
    "type": "Private"
  }
}

Responses

Return a 200 status to Tenovos to indicate that the data was received successfully

Headers
webhook-idstring

The unique message identifier for the webhook message. This identifier is unique across all messages, but will be the same when the same webhook is being resent (e.g. due to a previous failure).

webhook-timestampstring

Timestamp in seconds since epoch.

webhook-signaturestring

The Base64 encoded list of signatures (space delimitated)

Collection Assets UpdatedWebhook

Request

Receive a notification when assets are added to and/or removed from a collection.

Security
OAuth2
Bodyapplication/json

Return a 200 status to Tenovos to indicate that the data was received successfully

Any of:
eventTypestring

Combination of the Topic and the Event

Example: "collection.assets.updated"
eventobject(event)

Object containing event information and the user who triggered the event.

collectionobject

Object containing information regarding the collection and the assets it contains.

application/json
{
  "eventType": "collection.assets.updated",
  "event": {
    "id": "some-event-type-d231cf1d-86b2-436e-95de-b745c39d2ed5",
    "time": "2024-05-09T17:55:28.462Z",
    "user": { … }
  },
  "collection": {
    "id": "147c8d3d-e0f4-497f-86d3-aa2a4166f304",
    "name": "Outdoor 2025 Spring Catalog",
    "type": "Private",
    "assets": { … }
  }
}

Responses

Return a 200 status to Tenovos to indicate that the data was received successfully

Headers
webhook-idstring

The unique message identifier for the webhook message. This identifier is unique across all messages, but will be the same when the same webhook is being resent (e.g. due to a previous failure).

webhook-timestampstring

Timestamp in seconds since epoch.

webhook-signaturestring

The Base64 encoded list of signatures (space delimitated)

Collection DownloadedWebhook

Request

Receive a notification when a Collection in Tenovos is downloaded.

Security
OAuth2
Bodyapplication/json

Information about a Collection when it is downloaded from Tenovos.

eventTypestring

Combination of the Topic and the Event

Example: "collection.downloaded"
eventobject(event)

Object containing event information and the user who triggered the event.

collectionobject(collection)
application/json
{
  "eventType": "collection.downloaded",
  "event": {
    "id": "some-event-type-d231cf1d-86b2-436e-95de-b745c39d2ed5",
    "time": "2024-05-09T17:55:28.462Z",
    "user": { … }
  },
  "collection": {
    "id": "147c8d3d-e0f4-497f-86d3-aa2a4166f304",
    "name": "Outdoor 2025 Spring Catalog",
    "type": "Private"
  }
}

Responses

Return a 200 status to Tenovos to indicate that the data was received successfully

Collection SharedWebhook

Request

Receive a notification when a Collection in Tenovos is shared.

Security
OAuth2
Bodyapplication/json

Information about a Collection when it is shared.

eventTypestring

Combination of the Topic and the Event

Example: "collection.shared"
eventobject(event)

Object containing event information and the user who triggered the event.

shareobject(collection.share)
application/json
{
  "eventType": "collection.shared",
  "event": {
    "id": "some-event-type-d231cf1d-86b2-436e-95de-b745c39d2ed5",
    "time": "2024-05-09T17:55:28.462Z",
    "user": { … }
  },
  "share": {
    "type": "Internal",
    "recipients": [ … ],
    "collection": { … }
  }
}

Responses

Return a 200 status to Tenovos to indicate that the data was received successfully

EventPulse

Tenovos EventPulse is COMING SOON!

Receive a notification when an event occurs from human interaction and decision making (button click, etc.). In support of manually triggered events, EventPulse brings a human touch to Webhooks. EventPulse notifications contain an array of objects for which an event has been raised, manually. Tenovos will offer Administrative configuration of these special events from the Admin --> Webhooks page, or they can be incorporated into customer managed user interfaces.

Tenovos API v1.5 will also fully support EventPulse with several new endpoints.

These capabilities are currently supported via Tenovos Actions, which consists of Asset Actions, Web Actions, and Workflow Actions. EventPulse replaces and extends these capabilities to all customers in a manner customers can manage and control themselves.

Metadata

These events are raised when a user with Administrative privileges take various actions within the Metadata section of the Platform. This includes Metadata Templates, Metadata Groups, Controlled Vocabularies, and Metadata Attributes.

Webhooks

Requests

Requests represent a one step workflow within Tenovos. Users with the Request Management and Request Inbox privileges can see and manage any type of request in the system. Each request is assigned a specific type, which can be defined based on your needs. Examples include:

  • Upload
  • Download
  • Asset Change
  • Merchandising Review
  • Archive

In these examples, one or more assets are part of a request, and each asset can be assigned to a different user for review. The reviewer can updated the status of each asset they are assigned to, such as Approved, Rejected, In Progress, Auto Approved, etc. The request itself can also have a status. These terms are completely customizable, and therefore are not an enum in the API documentation.

Webhooks

Relationships

Relationship related events

Webhooks

Rights Management

Rights Management related events.

Webhooks

Security

These events are raised when a user with Administrative privileges take various actions within the Administration section of the Platform. This includes Groups, Roles, Security Templates, and more.

Webhooks

Story Boards

Story Board related events

Webhooks

Users

User related events

Webhooks

Versions

Webhooks