Skip to content

Share design notifications

The NotificationContent sent when a user shares a design.

If the type of notification is share_design, 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 design.

&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_design`.
      &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="design" type="DesignSummary" required mode="output"&gt;
      Basic details about the design, such as the design's ID, title, and URL.

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

          &lt;Prop name="urls" type="DesignLinks" required mode="output"&gt;
            A temporary set of URLs for viewing or editing the design.

            &lt;PillAccordion title={&lt;&gt;Properties of &lt;strong&gt;urls&lt;/strong&gt;&lt;/&gt;}&gt;
              &lt;Prop.List&gt;
                &lt;Prop name="edit_url" type="string" required mode="output"&gt;
                  A temporary editing URL for the design. This URL is only accessible to the user that made the API request, and is designed to support return navigation workflows.

                  NOTE: This is not a permanent URL, it is only valid for 30 days.
                &lt;/Prop&gt;

                &lt;Prop name="view_url" type="string" required mode="output"&gt;
                  A temporary viewing URL for the design. This URL is only accessible to the user that made the API request, and is designed to support return navigation workflows.

                  NOTE: This is not a permanent URL, it is only valid for 30 days.
                &lt;/Prop&gt;
              &lt;/Prop.List&gt;
            &lt;/PillAccordion&gt;
          &lt;/Prop&gt;

          &lt;Prop name="created_at" type="integer" required mode="output"&gt;
            When the design was created in Canva, 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 design was last updated in Canva, as a Unix timestamp (in seconds since the
            Unix Epoch).
          &lt;/Prop&gt;

          &lt;Prop name="title" type="string" mode="output"&gt;
            The design title.
          &lt;/Prop&gt;

          &lt;Prop name="url" type="string" mode="output"&gt;
            URL of the design.
          &lt;/Prop&gt;

          &lt;Prop name="thumbnail" type="Thumbnail" mode="output"&gt;
            A thumbnail image representing the object.

            &lt;PillAccordion title={&lt;&gt;Properties of &lt;strong&gt;thumbnail&lt;/strong&gt;&lt;/&gt;}&gt;
              &lt;Prop.List&gt;
                &lt;Prop name="width" type="integer" required mode="output"&gt;
                  The width of the thumbnail image in pixels.
                &lt;/Prop&gt;

                &lt;Prop name="height" type="integer" required mode="output"&gt;
                  The height of the thumbnail image in pixels.
                &lt;/Prop&gt;

                &lt;Prop name="url" type="string" required mode="output"&gt;
                  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.
                &lt;/Prop&gt;
              &lt;/Prop.List&gt;
            &lt;/PillAccordion&gt;
          &lt;/Prop&gt;

          &lt;Prop name="page_count" type="integer" mode="output"&gt;
            The total number of pages in the design. Some design types don't have pages (for example, Canva docs).
          &lt;/Prop&gt;
        &lt;/Prop.List&gt;
      &lt;/PillAccordion&gt;
    &lt;/Prop&gt;

    &lt;Prop name="share_url" type="string" required mode="output"&gt;
      A URL that the user who receives the notification can use to access the shared design.
    &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 design notification

Canva Developer Documentation SOP Site