Design approval response notifications

The NotificationContent sent when a user responds to a design approval request.

If the type of notification is design_approval_response, the webhook payload object contains the following parameters:

#idstring

The unique identifier for the notification.

#created_atinteger

When the notification was created, as a UNIX timestamp (in seconds since the UNIX epoch).

#contentobject

The notification content for when someone approves a design or gives feeback.

Properties of content
#typestring

The value for this can only be design_approval_response.

#triggering_userUser

Metadata for the user, consisting of the User ID and display name.

Properties of triggering_user
#idstring

The ID of the user.

#display_namestring
Optional

The name of the user as shown in the Canva UI.

#receiving_team_userTeamUser

Metadata for the user, consisting of the User ID, Team ID, and display name.

Properties of receiving_team_user
#user_idstring
Optional

The ID of the user.

#team_idstring
Optional

The ID of the user's Canva Team.

#display_namestring
Optional

The name of the user as shown in the Canva UI.

#initial_requesting_userTeamUser

Metadata for the user, consisting of the User ID, Team ID, and display name.

Properties of initial_requesting_user
#user_idstring
Optional

The ID of the user.

#team_idstring
Optional

The ID of the user's Canva Team.

#display_namestring
Optional

The name of the user as shown in the Canva UI.

#responding_groupsGroup[]

Metadata for the Canva Group, consisting of the Group ID, display name, and whether it's an external Canva Group.

Properties of responding_groups
#idstring

The ID of the group with permissions to access the design.

#externalboolean

Is the user making the API call (the authenticated user) and the Canva Group from different Canva Teams?

  • When true, the user and the group aren't in the same Canva Team.
  • When false, the user and the group are in the same Canva Team.
#display_namestring
Optional

The display name of the group.

#designDesignSummary

Basic details about the design, such as the design's ID, title, and URL.

Properties of design
#idstring

The design ID.

#urlsDesignLinks

A temporary set of URLs for viewing or editing the design.

Properties of urls
#edit_urlstring

A temporary editing URL for the design.

#view_urlstring

A temporary viewing URL for the design.

#created_atinteger

When the design was created in Canva, as a Unix timestamp (in seconds since the Unix Epoch).

#updated_atinteger

When the design was last updated in Canva, as a Unix timestamp (in seconds since the Unix Epoch).

#titlestring
Optional

The design title.

#urlstring
Optional

URL of the design.

#thumbnailThumbnail
Optional

A thumbnail image representing the object.

Properties of thumbnail
#widthinteger

The width of the thumbnail image in pixels.

#heightinteger

The height of the thumbnail image in pixels.

#urlstring

A URL for retrieving the thumbnail image. This URL expires after 15 minutes. This URL includes a query string that's required for retrieving the thumbnail.

#approval_responseApprovalResponseAction

Metadata about the design approval response.

Properties of approval_response
#approvedboolean

Whether the design was approved. When true, the reviewer has approved the design.

#ready_to_publishboolean
Optional

Whether the design is ready to publish. When true, the design has been approved by all reviewers and can be published.

#messagestring
Optional

The message included by a user responding to a design approval request.

{
"id": "eb595730",
"created_at": 1377396000,
"content": {
"type": "design_approval_response",
"triggering_user": {
"id": "uKakKUfI03Fg8k2gZ6OkT",
"display_name": "John Doe"
},
"receiving_team_user": {
"user_id": "auDAbliZ2rQNNOsUl5OLu",
"team_id": "Oi2RJILTrKk0KRhRUZozX",
"display_name": "Jane Doe"
},
"initial_requesting_user": {
"user_id": "auDAbliZ2rQNNOsUl5OLu",
"team_id": "Oi2RJILTrKk0KRhRUZozX",
"display_name": "Jane Doe"
},
"responding_groups": [
{
"id": "dl9n9SoWoExMsw6Ri1iTg",
"display_name": "Sales team",
"external": true
}
],
"design": {
"id": "DAFVztcvd9z",
"title": "My summer holiday",
"url": "https://www.canva.com/design/DAFVztcvd9z/edit",
"thumbnail": {
"width": 595,
"height": 335,
"url": "https://document-export.canva.com/Vczz9/zF9vzVtdADc/2/thumbnail/0001.png?<query-string>"
},
"urls": {
"edit_url": "https://www.canva.com/api/design/{token}/edit",
"view_url": "https://www.canva.com/api/design/{token}/view"
},
"created_at": 1377396000,
"updated_at": 1692928800
},
"approval_response": {
"approved": true,
"ready_to_publish": true,
"message": "string"
}
}
}
json