Skip to content

Share folder notifications

The NotificationContent sent when a user shares a folder.

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

<Prop.List> <Prop name="id" type="string" required mode="output"> The unique identifier for the notification. </Prop>

<Prop name="created_at" type="integer" required mode="output"> When the notification was created, as a UNIX timestamp (in seconds since the UNIX epoch). </Prop>

<Prop name="content" type="object" required mode="output"> The notification content for when someone shares a folder.

&lt;PillAccordion title={&lt;&gt;Properties of &lt;strong&gt;content&lt;/strong&gt;&lt;/&gt;} defaultExpanded={true}&gt;
  &lt;Prop.List&gt;
    &lt;Prop name="type" type="string" required mode="output"&gt;
      &lt;Prop.Extras&gt;
        **Available values:** The only valid value is `share_folder`.
      &lt;/Prop.Extras&gt;
    &lt;/Prop&gt;

    &lt;Prop name="triggering_user" type="User" required mode="output"&gt;
      Metadata for the user, consisting of the User ID and display name.

      &lt;PillAccordion title={&lt;&gt;Properties of &lt;strong&gt;triggering_user&lt;/strong&gt;&lt;/&gt;}&gt;
        &lt;Prop.List&gt;
          &lt;Prop name="id" type="string" required mode="output"&gt;
            The ID of the user.
          &lt;/Prop&gt;

          &lt;Prop name="display_name" type="string" mode="output"&gt;
            The name of the user as shown in the Canva UI.
          &lt;/Prop&gt;
        &lt;/Prop.List&gt;
      &lt;/PillAccordion&gt;
    &lt;/Prop&gt;

    &lt;Prop name="receiving_team_user" type="TeamUser" required mode="output"&gt;
      Metadata for the user, consisting of the User ID, Team ID, and display name.

      &lt;PillAccordion title={&lt;&gt;Properties of &lt;strong&gt;receiving_team_user&lt;/strong&gt;&lt;/&gt;}&gt;
        &lt;Prop.List&gt;
          &lt;Prop name="user_id" type="string" mode="output"&gt;
            The ID of the user.
          &lt;/Prop&gt;

          &lt;Prop name="team_id" type="string" mode="output"&gt;
            The ID of the user's Canva Team.
          &lt;/Prop&gt;

          &lt;Prop name="display_name" type="string" mode="output"&gt;
            The name of the user as shown in the Canva UI.
          &lt;/Prop&gt;
        &lt;/Prop.List&gt;
      &lt;/PillAccordion&gt;
    &lt;/Prop&gt;

    &lt;Prop name="folder" type="FolderSummary" required mode="output"&gt;
      This object contains some folder metadata. You can retrieve additional metadata
      using the folder ID and the `/v1/folders/{folderId}` endpoint.

      &lt;PillAccordion title={&lt;&gt;Properties of &lt;strong&gt;folder&lt;/strong&gt;&lt;/&gt;}&gt;
        &lt;Prop.List&gt;
          &lt;Prop name="id" type="string" required mode="output"&gt;
            The folder ID.
          &lt;/Prop&gt;

          &lt;Prop name="name" type="string" required mode="output"&gt;
            The folder name, as shown in the Canva UI.
          &lt;/Prop&gt;

          &lt;Prop name="created_at" type="integer" required mode="output"&gt;
            When the folder was created, as a Unix timestamp (in seconds since the
            Unix Epoch).
          &lt;/Prop&gt;

          &lt;Prop name="updated_at" type="integer" required mode="output"&gt;
            When the folder was last updated, as a Unix timestamp (in seconds since the
            Unix Epoch).
          &lt;/Prop&gt;

          &lt;Prop name="url" type="string" mode="output"&gt;
            The folder URL.
          &lt;/Prop&gt;

          &lt;Prop name="title" type="string" deprecated mode="output"&gt;
            The folder name, as shown in the Canva UI. This property is deprecated, so you should
            use the `name` property instead.
          &lt;/Prop&gt;
        &lt;/Prop.List&gt;
      &lt;/PillAccordion&gt;
    &lt;/Prop&gt;

    &lt;Prop name="share" type="ShareAction" mode="output"&gt;
      Metadata about the share event.

      &lt;PillAccordion title={&lt;&gt;Properties of &lt;strong&gt;share&lt;/strong&gt;&lt;/&gt;}&gt;
        &lt;Prop.List&gt;
          &lt;Prop name="message" type="string" required mode="output"&gt;
            The optional message users can include when sharing something with another
            user using the Canva UI.
          &lt;/Prop&gt;
        &lt;/Prop.List&gt;
      &lt;/PillAccordion&gt;
    &lt;/Prop&gt;
  &lt;/Prop.List&gt;
&lt;/PillAccordion&gt;

</Prop> </Prop.List>

Example: Share folder notification

Canva Developer Documentation SOP Site