Skip navigation

Skip to main content

Canva Audit Logs are currently in development (Beta) and are subject to change at Canva's sole discretion.

Brands

Create a Brand Kit

An actor triggers this event when they create a new Brand Kit. For details, see Canva Help: Setting up Brand Kits⁠(opens in a new tab or window).

typestring

Default value: CREATE_BRAND_KIT

Available values: The only valid value is CREATE_BRAND_KIT.

namestring

The name of the Brand Kit.

Example

{
  "id": ...,
  "timestamp": ...,
  "actor": ...,
  "target": ...,
  "action": {
    "type": "CREATE_BRAND_KIT",
    "name": "Acme Corp Brand Kit"
  },
  "outcome": ...,
  "context": ...
}
JSON

Update a Brand Kit's details

An actor triggers this event when they update a Brand Kit. For details, see Canva Help: Setting up Brand Kits⁠(opens in a new tab or window).

typestring

Default value: UPDATE_BRAND_KIT

Available values: The only valid value is UPDATE_BRAND_KIT.

changed_fieldsstring[]

The fields the actor requested changes for in this update.

Available values:

  • NAME: The name of the Brand Kit.
  • SHARES: The shares of the Brand Kit.
  • FONTS: The fonts of the Brand Kit.
  • FOLDER_LINKS: The links to the Brand Kit folders.
  • INGREDIENT: The ingredient of the Brand Kit.
old_namestring
OPTIONAL

The previous name of the Brand Kit.

new_namestring
OPTIONAL

The new name of the Brand Kit.

old_sharesBrandKitShare[]
OPTIONAL

The shares of the Brand Kit.

Properties of old_shares
typestring

This can be one of the following:

  • TEAM: A team the Brand Kit is shared with.
  • FOLDER: A folder the Brand Kit is shared with.
  • ORGANIZATION: An organization the Brand Kit is shared with.
teamAuditLogTeam
CONDITIONAL

A Canva team.

Properties of team
idstring

The team ID.

display_namestring
OPTIONAL

The display name of the team.

For privacy reasons, this field is redacted for brands outside of your organization. Rarely, it may be unavailable for technical reasons.

folderAuditLogFolder
CONDITIONAL

A Canva folder.

Properties of folder
idstring

The folder ID.

namestring
OPTIONAL

The name of the folder.

organizationAuditLogOrganization
CONDITIONAL

A Canva organization.

Properties of organization
idstring

The organization ID.

display_namestring
OPTIONAL

The display name of the organization.

For privacy reasons, this field is redacted for organizations other than your organization. Rarely, it may be unavailable for technical reasons.

new_sharesBrandKitShare[]
OPTIONAL

The shares of the Brand Kit.

Properties of new_shares
typestring

This can be one of the following:

  • TEAM: A team the Brand Kit is shared with.
  • FOLDER: A folder the Brand Kit is shared with.
  • ORGANIZATION: An organization the Brand Kit is shared with.
teamAuditLogTeam
CONDITIONAL

A Canva team.

Properties of team
idstring

The team ID.

display_namestring
OPTIONAL

The display name of the team.

For privacy reasons, this field is redacted for brands outside of your organization. Rarely, it may be unavailable for technical reasons.

folderAuditLogFolder
CONDITIONAL

A Canva folder.

Properties of folder
idstring

The folder ID.

namestring
OPTIONAL

The name of the folder.

organizationAuditLogOrganization
CONDITIONAL

A Canva organization.

Properties of organization
idstring

The organization ID.

display_namestring
OPTIONAL

The display name of the organization.

For privacy reasons, this field is redacted for organizations other than your organization. Rarely, it may be unavailable for technical reasons.

old_fontsBrandKitFont[]
OPTIONAL

The fonts of the Brand Kit.

Properties of old_fonts
idstring

The ID of the font family.

font_familystring
OPTIONAL

The name of the font family.

font_stylestring
OPTIONAL

The style of the font.

new_fontsBrandKitFont[]
OPTIONAL

The fonts of the Brand Kit.

Properties of new_fonts
idstring

The ID of the font family.

font_familystring
OPTIONAL

The name of the font family.

font_stylestring
OPTIONAL

The style of the font.

old_ingredientBrandKitIngredient
OPTIONAL

An ingredient of the Brand Kit.

Properties of old_ingredient
namestring
OPTIONAL

A name of the ingredient.

idstring
OPTIONAL

ID of the ingredient.

guidelinesstring
OPTIONAL

User-provided guidelines to help members of the team understand how, where, and when to use the ingredient.

color_palettesBrandKitColorPalette[]
OPTIONAL

The color palettes of the Brand Kit.

Properties of color_palettes
namestring
OPTIONAL

The name of the color palette.

colorsBrandKitColor[]
OPTIONAL

The colors in the palette.

Properties of colors
namestring
OPTIONAL

The name of the color.

hexstring
OPTIONAL

The hex value of the color.

cmykstring
OPTIONAL

The CMYK value of the color.

gradientBrandKitGradient
OPTIONAL

A color gradient in the Brand Kit.

Properties of gradient
typestring

This can be one of the following:

  • LINEAR: A linear gradient in the Brand Kit.
  • RADIAL: A radial gradient in the Brand Kit.
stopsBrandKitGradientStop[]

The color stops in the gradient.

Properties of stops
colorstring

The color of the stop.

transparencynumber

The transparency of the stop.

positionnumber

The position of the stop as a percentage along the gradient line.

rotationnumber
CONDITIONAL

The rotation of the gradient in degrees.

centerobject
CONDITIONAL

The center of the radial gradient. If the top and left are both zero, the center is in the top-left of the gradient.

Properties of center
topnumber

The top position of the center, as a percentage down from the top of the gradient.

leftnumber

The left position of the center, as a percentage from the left of the gradient.

text_stylesBrandKitTextStylesGroup[]
OPTIONAL

The text styles of the Brand Kit.

Properties of text_styles
namestring

The name of the text style group.

text_stylesBrandKitTextStyle[]

The formatting set for the text style.

Properties of text_styles
fontBrandKitFont

A font in the Brand Kit.

Properties of font
idstring

The ID of the font family.

font_familystring
OPTIONAL

The name of the font family.

font_stylestring
OPTIONAL

The style of the font.

sizeinteger

The size of the text style in pixels.

namestring
OPTIONAL

The name of the text style.

custom_namestring
OPTIONAL

The user-defined text style name.

voicestring
OPTIONAL

The voice of the brand.

assetsBrandKitAsset[]
OPTIONAL

The assets in the ingredient.

Properties of assets
idstring

An ID of the asset.

namestring
OPTIONAL

A name of the asset.

file_namestring
OPTIONAL

A name of the asset file.

new_ingredientBrandKitIngredient
OPTIONAL

An ingredient of the Brand Kit.

Properties of new_ingredient
namestring
OPTIONAL

A name of the ingredient.

idstring
OPTIONAL

ID of the ingredient.

guidelinesstring
OPTIONAL

User-provided guidelines to help members of the team understand how, where, and when to use the ingredient.

color_palettesBrandKitColorPalette[]
OPTIONAL

The color palettes of the Brand Kit.

Properties of color_palettes
namestring
OPTIONAL

The name of the color palette.

colorsBrandKitColor[]
OPTIONAL

The colors in the palette.

Properties of colors
namestring
OPTIONAL

The name of the color.

hexstring
OPTIONAL

The hex value of the color.

cmykstring
OPTIONAL

The CMYK value of the color.

gradientBrandKitGradient
OPTIONAL

A color gradient in the Brand Kit.

Properties of gradient
typestring

This can be one of the following:

  • LINEAR: A linear gradient in the Brand Kit.
  • RADIAL: A radial gradient in the Brand Kit.
stopsBrandKitGradientStop[]

The color stops in the gradient.

Properties of stops
colorstring

The color of the stop.

transparencynumber

The transparency of the stop.

positionnumber

The position of the stop as a percentage along the gradient line.

rotationnumber
CONDITIONAL

The rotation of the gradient in degrees.

centerobject
CONDITIONAL

The center of the radial gradient. If the top and left are both zero, the center is in the top-left of the gradient.

Properties of center
topnumber

The top position of the center, as a percentage down from the top of the gradient.

leftnumber

The left position of the center, as a percentage from the left of the gradient.

text_stylesBrandKitTextStylesGroup[]
OPTIONAL

The text styles of the Brand Kit.

Properties of text_styles
namestring

The name of the text style group.

text_stylesBrandKitTextStyle[]

The formatting set for the text style.

Properties of text_styles
fontBrandKitFont

A font in the Brand Kit.

Properties of font
idstring

The ID of the font family.

font_familystring
OPTIONAL

The name of the font family.

font_stylestring
OPTIONAL

The style of the font.

sizeinteger

The size of the text style in pixels.

namestring
OPTIONAL

The name of the text style.

custom_namestring
OPTIONAL

The user-defined text style name.

voicestring
OPTIONAL

The voice of the brand.

assetsBrandKitAsset[]
OPTIONAL

The assets in the ingredient.

Properties of assets
idstring

An ID of the asset.

namestring
OPTIONAL

A name of the asset.

file_namestring
OPTIONAL

A name of the asset file.

Example

{
  "id": ...,
  "timestamp": ...,
  "actor": ...,
  "target": ...,
  "action": {
    "type": "UPDATE_BRAND_KIT",
    "changed_fields": [
      "NAME",
      "SHARES",
      "FONTS",
      "FOLDER_LINKS",
      "INGREDIENT"
    ],
    "old_name": "Marketing Brand Kit",
    "new_name": "Growth Brand Kit",
    "old_shares": [
      {
        "type": "TEAM",
        "team": {
          "id": "BXeFatjDhdR",
          "display_name": "Acme Team"
        }
      },
      {
        "type": "FOLDER",
        "folder": {
          "id": "FXeFatjDhdR",
          "name": "Marketing Folder"
        }
      },
      {
        "type": "ORGANIZATION",
        "organization": {
          "id": "OXtgecafZvh",
          "display_name": "Acme Corporation"
        }
      }
    ],
    "new_shares": [
      {
        "type": "TEAM",
        "team": {
          "id": "BXeFatjDhdR",
          "display_name": "Acme Team"
        }
      },
      {
        "type": "FOLDER",
        "folder": {
          "id": "FXeFatjDhdR",
          "name": "Marketing Folder"
        }
      },
      {
        "type": "ORGANIZATION",
        "organization": {
          "id": "OXtgecafZvh",
          "display_name": "Acme Corporation"
        }
      }
    ],
    "old_fonts": [
      "Roboto Thin",
      "Mona Sans"
    ],
    "new_fonts": [
      "Roboto Thin",
      "Mona Sans"
    ],
    "old_folder_links": [
      {
        "folder": {
          "id": "FXeFatjDhdR",
          "name": "Marketing Folder"
        },
        "type": "CHARTS"
      }
    ],
    "new_folder_links": [
      {
        "folder": {
          "id": "FXeFatjDhdR",
          "name": "Marketing Folder"
        },
        "type": "CHARTS"
      }
    ],
    "old_ingredient": {
      "name": "Colors",
      "id": "IG-123456789000",
      "guidelines": "Use these colors for all marketing materials.",
      "color_palettes": [
        {
          "name": "Main brand colors",
          "colors": [
            {
              "name": "Primary",
              "hex": "#FF0000",
              "cmyk": "cmyk(0, 100, 100, 0)",
              "gradient": {
                "type": "LINEAR",
                "stops": [
                  {
                    "color": "#FF0000",
                    "transparency": 0.5,
                    "position": 50
                  }
                ],
                "rotation": 90
              }
            }
          ]
        }
      ],
      "text_styles": [
        {
          "name": "Title",
          "text_styles": [
            {
              "name": "Title",
              "font": {
                "id": "YXeFatjDhdR",
                "font_family": "Roboto",
                "font_style": "Bold"
              },
              "custom_name": "Main Title",
              "size": 12
            }
          ]
        }
      ],
      "voice": "Our voice is professional and formal.",
      "assets": [
        {
          "id": "M1234567890",
          "name": "Our primary logo",
          "file_name": "main-logo.png"
        }
      ]
    },
    "new_ingredient": {
      "name": "Colors",
      "id": "IG-123456789000",
      "guidelines": "Use these colors for all marketing materials.",
      "color_palettes": [
        {
          "name": "Main brand colors",
          "colors": [
            {
              "name": "Primary",
              "hex": "#FF0000",
              "cmyk": "cmyk(0, 100, 100, 0)",
              "gradient": {
                "type": "LINEAR",
                "stops": [
                  {
                    "color": "#FF0000",
                    "transparency": 0.5,
                    "position": 50
                  }
                ],
                "rotation": 90
              }
            }
          ]
        }
      ],
      "text_styles": [
        {
          "name": "Title",
          "text_styles": [
            {
              "name": "Title",
              "font": {
                "id": "YXeFatjDhdR",
                "font_family": "Roboto",
                "font_style": "Bold"
              },
              "custom_name": "Main Title",
              "size": 12
            }
          ]
        }
      ],
      "voice": "Our voice is professional and formal.",
      "assets": [
        {
          "id": "M1234567890",
          "name": "Our primary logo",
          "file_name": "main-logo.png"
        }
      ]
    }
  },
  "outcome": ...,
  "context": ...
}
JSON

Delete a Brand Kit

An actor triggers this event when they delete a Brand Kit. For details, see Canva Help: Setting up Brand Kits⁠(opens in a new tab or window).

typestring

Default value: DELETE_BRAND_KIT

Available values: The only valid value is DELETE_BRAND_KIT.

Example

{
  "id": ...,
  "timestamp": ...,
  "actor": ...,
  "target": ...,
  "action": {
    "type": "DELETE_BRAND_KIT"
  },
  "outcome": ...,
  "context": ...
}
JSON

Send a brand template share notification

An actor triggers this event when they share a brand template. Canva will attempt to send an email and an in-app notification to the user the brand template is shared with (recipient).

typestring

Default value: SEND_BRAND_TEMPLATE_SHARE_NOTIFICATION

Available values: The only valid value is SEND_BRAND_TEMPLATE_SHARE_NOTIFICATION.

recipientShareNotificationRecipient

The recipient of the share notification.

The recipient can be a user, a group, an organization, or an email address.

Properties of recipient
typestring

This can be one of the following:

  • USER_RECIPIENT
  • GROUP_RECIPIENT
  • ORGANIZATION_RECIPIENT
  • EMAIL_RECIPIENT
userAuditLogUser
CONDITIONAL

A Canva user.

Properties of user
idstring

The user ID.

display_namestring
OPTIONAL

The display name of the user.

For privacy reasons, this field is redacted for users outside of your organization. Rarely, it may also be unavailable for technical reasons.

emailstring
OPTIONAL

The email address of the user.

For privacy reasons, this field is redacted for users outside of your organization. Rarely, it may also be unavailable for technical reasons.

groupAuditLogGroup
CONDITIONAL

A Canva group.

Properties of group
idstring

The group ID.

display_namestring
OPTIONAL

The display name of the group.

organizationAuditLogOrganization
CONDITIONAL

A Canva organization.

Properties of organization
idstring

The organization ID.

display_namestring
OPTIONAL

The display name of the organization.

For privacy reasons, this field is redacted for organizations other than your organization. Rarely, it may be unavailable for technical reasons.

emailstring
CONDITIONAL

The email address the design invite was sent to.

messagestring
OPTIONAL

An optional message from the actor to the recipient.

Example

{
  "id": ...,
  "timestamp": ...,
  "actor": ...,
  "target": ...,
  "action": {
    "type": "SEND_BRAND_TEMPLATE_SHARE_NOTIFICATION",
    "message": "Check out my brand template!",
    "recipient": {
      "type": "USER_RECIPIENT",
      "user": {
        "id": "UXoqDbwwSbQ",
        "display_name": "Jane Doe",
        "email": "[email protected]"
      }
    }
  },
  "outcome": ...,
  "context": ...
}
JSON