Design Events

One event fires when a design moves through your approval workflow.

TEMPLATE_STATUS

Triggered any time the workflow status of a design is updated.

Filtering

In the webhook settings, this event can be limited to a specific design.

Payload example

{
  "event_type": "TEMPLATE_STATUS",
  "id": "873608a1-e498-47dd-a36d-bd065e3e2b8e",
  "name": "Template name",
  "created_at": 1623229458,
  "updated_at": 1649837900,
  "status": "APPROVED",
  "status_updated_at": 1649837939
}

Payload fields

Field	Type	Description
event_type	String	Always "TEMPLATE_STATUS".
id	UUID v4	Unique ID of the design whose status changed.
name	string	Design name as defined in the application.
created_at	Unix timestamp	Design creation date.
updated_at	Unix timestamp	Last time the design content or properties were updated.
status	string	The new workflow status (see values below).
status_updated_at	Unix timestamp	When the current status was set.

Possible status values

Status	Description
NONE	No workflow status defined (default).
IN_REVIEW	Submitted and awaiting approval.
ON_HOLD	Review paused — requires further clarification.
REJECTED	Reviewed and officially declined.
APPROVED	Reviewed and officially approved for use.
COMPLETED	Work on the design is finished.

Related

• Webhooks Overview — how to configure webhook endpoints
• Designs — design details and format listing