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.

Properties of content
typestring

The value for this can only be folder_access_requested.

triggering_userTeamUser

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

Properties of triggering_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.

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.

folderFolderSummary

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

Properties of folder
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).

urlstring
OPTIONAL

The folder URL.

titlestring
DEPRECATED

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