Canva Trigger icon

Canva Trigger

Recebe notificações webhook do Canva em tempo real

Overview

This node acts as a webhook trigger for real-time notifications from Canva. It listens for specific Canva event types and triggers workflows when those events occur. This is useful for automating responses to design comments, access requests, approvals, sharing events, team invitations, and preview notifications related to suggestions or mentions in designs.

Practical examples include:

  • Automatically notifying a team chat when a comment is added to a design.
  • Triggering an approval workflow when a design is approved.
  • Logging sharing events of folders or designs for audit purposes.
  • Filtering events by specific design, folder, or user IDs to focus on relevant updates.

Properties

Name Meaning
Event Type of Canva event that will trigger the webhook. Options: Comment Notification, Design Access Request, Design Approval, Design Sharing Event, Folder Access Request, Folder Sharing Event, Team Access Invitation, Suggestion Notification (Preview), Design Mention Notification (Preview).
Design ID Filter Optional filter to only trigger the webhook for a specific design ID. Visible for certain design-related events.
Folder ID Filter Optional filter to only trigger the webhook for a specific folder ID. Visible for folder access and sharing events.
User ID Filter Optional filter to only trigger the webhook for a specific user ID. Visible for user mention, comment creation, and suggestion creation events.
Validate Signature Boolean flag to enable or disable HMAC signature validation for webhook security. Defaults to true.
Webhook Secret Shared secret used to validate the HMAC signature of incoming webhook requests. Required if signature validation is enabled.

Output

The node outputs JSON data representing the received Canva event with the following structure:

{
  "event_type": "string",        // The type of event received
  "event_id": "string",          // Unique identifier for the event
  "timestamp": "string",         // Timestamp of the event occurrence
  "created_at": "string",        // Creation time of the event record
  "data": {                      // Event-specific payload data from Canva
    "...": "..."
  },
  "metadata": {
    "webhook_url": "string",     // URL of this webhook endpoint
    "processed_at": "string",    // ISO timestamp when the event was processed
    "filters_applied": {         // Filters applied to the event triggering
      "event": "string",
      "design_id_filter": "string|null",
      "folder_id_filter": "string|null",
      "user_id_filter": "string|null"
    }
  }
}

No binary data output is produced by this node.

Dependencies

  • Requires an API key credential for authenticating with Canva's API.
  • Uses a shared webhook secret for optional HMAC signature validation to ensure webhook security.
  • Node expects to be configured with a publicly accessible webhook URL to receive Canva events.

Troubleshooting

  • Webhook rejected: Signature missing
    Occurs if signature validation is enabled but the incoming request lacks the required HMAC signature header.
    Resolution: Ensure Canva sends the x-canva-signature header and the webhook secret is correctly configured.

  • Webhook rejected: Invalid signature
    Happens when the HMAC signature does not match the expected value computed using the webhook secret.
    Resolution: Verify the webhook secret matches between Canva and the node configuration.

  • No workflow trigger despite event sent
    Could be due to event type mismatch or filters (design ID, folder ID, user ID) not matching the incoming event data.
    Resolution: Check that the selected event type matches the incoming event and that any filters are correct or disabled.

  • Missing or incorrect credentials
    The node requires valid API credentials to function properly.
    Resolution: Confirm that the API key credential is set up and authorized.

Links and References

Discussion