Skip navigation

Skip to main content

Webhook notifications
Collaborating
Webhook notifications

Folder access requested notifications

The NotificationContent sent when a user requests access to a folder.

Webhook notifications are currently provided as a preview. Be aware of the following:

  • There might be unannounced breaking changes.
  • Any breaking changes to preview features won't produce a new API version.
  • Public integrations that use preview features will not pass the review process, and can't be made available to all Canva users.

If the type of notification is folder_access_requested, 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 requests access to a folder.

typestring

Available values: The only valid value is folder_access_requested.

triggering_userTeamUser

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

user_idstringOptional

The ID of the user.

team_idstringOptional

The ID of the user's Canva Team.

display_namestringOptional

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.

user_idstringOptional

The ID of the user.

team_idstringOptional

The ID of the user's Canva Team.

display_namestringOptional

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

folderFolderSummary

This object contains some folder metadata. You can retrieve additional metadata using the folder ID and the /v1/folders/{folderId} endpoint.

idstring

The folder ID.

namestring

The folder name, as shown in the Canva UI.

created_atinteger

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

updated_atinteger

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

urlstringOptional

The folder URL.

titlestringDeprecated

The folder name, as shown in the Canva UI. This property is deprecated, so you should use the name property instead.

Example: Design access requested notification

{
  "id": "eb595730",
  "created_at": 1377396000,
  "content": {
    "type": "folder_access_requested",
    "triggering_user": {
      "user_id": "auDAbliZ2rQNNOsUl5OLu",
      "team_id": "Oi2RJILTrKk0KRhRUZozX",
      "display_name": "Jane Doe"
    },
    "receiving_team_user": {
      "user_id": "auDAbliZ2rQNNOsUl5OLu",
      "team_id": "Oi2RJILTrKk0KRhRUZozX",
      "display_name": "Jane Doe"
    },
    "folder": {
      "id": "FAF2lZtloor",
      "name": "My awesome holiday",
      "created_at": 1377396000,
      "updated_at": 1692928800,
      "url": "https://www.canva.com/folder/FAF2lZtloor"
    }
  }
}
JSON