Skip navigation

Skip to main content

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

Organizations

Update organization

An actor triggers this event when they update the details of a Canva organization, such as the organization's display name.

typestring

The value for this can only be UPDATE_ORGANIZATION.

changed_fieldsstring[]
OPTIONAL

Fields requested to be changed in this update. This can be an array of the following:

  • ORG_NAME: The name of the organization.
  • DEFAULT_TEAM_ID: The team to provision users into by default.
  • DEFAULT_TEAM_POLICY: The policy for determining if a user can be provisioned into a default team.
old_namestring
OPTIONAL

The previous name of the organization.

new_namestring
OPTIONAL

The new name of the organization.

default_team_idstring
OPTIONAL

The team to provision users into by default.

default_team_policystring
OPTIONAL

The policy for determining if a user can be provisioned into a default team. This can be one of the following:

  • ADMIN_AND_UP: Users with the ADMIN organization role or higher are added to the team.
  • DESIGNER_AND_UP: Users with the DESIGNER organization role or higher are added to the team.
  • MEMBER_AND_UP: Users with the MEMBER organization role or higher are added to the team.

Example

{
  "id": ...,
  "timestamp": ...,
  "actor": ...,
  "target": ...,
  "action": {
    "type": "UPDATE_ORGANIZATION",
    "changed_fields": [
      "ORG_NAME",
      "DEFAULT_TEAM_ID",
      "DEFAULT_TEAM_POLICY"
    ],
    "old_name": "Untitled Corporation",
    "new_name": "Acme Corporation",
    "default_team_id": "BXeFatjDhdR",
    "default_team_policy": "ADMIN_AND_UP"
  },
  "outcome": ...,
  "context": ...
}
JSON

Create organization user role

An actor triggers this event when they promote a Canva organization MEMBER to BRAND_DESIGNER or ADMIN.

typestring

The value for this can only be CREATE_ORGANIZATION_USER_ROLE.

userAuditLogUser

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.

rolestring

The user's role in the organization. This can be one of the following:

  • ADMIN: Organization admin.
  • BRAND_DESIGNER: Organization brand designer.

Example

{
  "id": ...,
  "timestamp": ...,
  "actor": ...,
  "target": ...,
  "action": {
    "type": "CREATE_ORGANIZATION_USER_ROLE",
    "user": {
      "id": "UXoqDbwwSbQ",
      "display_name": "Jane Doe",
      "email": "[email protected]"
    },
    "role": "ADMIN"
  },
  "outcome": ...,
  "context": ...
}
JSON

Update organization user role

An actor triggers this event when they update a Canva user's membership within a Canva organization, such as changing the user's role from BRAND_DESIGNER to ADMIN. This event is only triggered when changing their role between either BRAND_DESIGNER or ADMIN. Giving a user one of the roles or taking one of these roles away from a user will trigger either the CREATE_ORGANIZATION_USER_ROLE or DELETE_ORGANIZATION_USER_ROLE events.

typestring

The value for this can only be UPDATE_ORGANIZATION_USER_ROLE.

userAuditLogUser

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.

old_rolestring

The user's role in the organization. This can be one of the following:

  • ADMIN: Organization admin.
  • BRAND_DESIGNER: Organization brand designer.
new_rolestring

The user's role in the organization. This can be one of the following:

  • ADMIN: Organization admin.
  • BRAND_DESIGNER: Organization brand designer.

Example

{
  "id": ...,
  "timestamp": ...,
  "actor": ...,
  "target": ...,
  "action": {
    "type": "UPDATE_ORGANIZATION_USER_ROLE",
    "user": {
      "id": "UXoqDbwwSbQ",
      "display_name": "Jane Doe",
      "email": "[email protected]"
    },
    "old_role": "BRAND_DESIGNER",
    "new_role": "ADMIN"
  },
  "outcome": ...,
  "context": ...
}
JSON

Remove organization user role

An actor triggers this event when they remove a user's ADMIN or BRAND_DESIGNER role within a Canva organization.

typestring

The value for this can only be DELETE_ORGANIZATION_USER_ROLE.

userAuditLogUser

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.

old_rolestring

The user's role in the organization. This can be one of the following:

  • ADMIN: Organization admin.
  • BRAND_DESIGNER: Organization brand designer.

Example

{
  "id": ...,
  "timestamp": ...,
  "actor": ...,
  "target": ...,
  "action": {
    "type": "DELETE_ORGANIZATION_USER_ROLE",
    "user": {
      "id": "UXoqDbwwSbQ",
      "display_name": "Jane Doe",
      "email": "[email protected]"
    },
    "old_role": "ADMIN"
  },
  "outcome": ...,
  "context": ...
}
JSON

Add team to organization

An actor triggers this event when they add a Canva Team to their Canva organization.

typestring

The value for this can only be ADD_TEAM_TO_ORGANIZATION.

teamAuditLogTeam

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.

Example

{
  "id": ...,
  "timestamp": ...,
  "actor": ...,
  "target": ...,
  "action": {
    "type": "ADD_TEAM_TO_ORGANIZATION",
    "team": {
      "id": "BXeFatjDhdR",
      "display_name": "Acme Team"
    }
  },
  "outcome": ...,
  "context": ...
}
JSON

Remove team from organization

An actor triggers this event when they remove a Canva Team from their Canva organization.

typestring

The value for this can only be REMOVE_TEAM_FROM_ORGANIZATION.

teamAuditLogTeam

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.

Example

{
  "id": ...,
  "timestamp": ...,
  "actor": ...,
  "target": ...,
  "action": {
    "type": "REMOVE_TEAM_FROM_ORGANIZATION",
    "team": {
      "id": "BXeFatjDhdR",
      "display_name": "Acme Team"
    }
  },
  "outcome": ...,
  "context": ...
}
JSON