Account

account_created

Definition: The event is emitted anytime an account is created by an end user or API request.

Trigger: Triggered anytime a new account is created.

Payload Example:

{
  "metadata": {
    "root_account_uuid": "VicYj3cu5BIFpoZhDVU4DZumnlBrWi1grgJEzADs",
    "root_account_id": "21070000000000001",
    "root_account_lti_guid": "7db438071375c02373713c12c73869ff2f470b68.example.instructure.com",
    "user_login": "example@example.com",
    "user_account_id": "21070000000000001",
    "user_sis_id": "456-T45",
    "user_id": "21070000000000001",
    "time_zone": "America/Chicago",
    "request_id": "1dd9dc6f-2fb0-4c19-a6c5-7ee1bf3ed295",
    "session_id": "ef686f8ed684abf78cbfa1f6a58112b5",
    "hostname": "sample.instructure.com",
    "http_method": "POST",
    "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_14_3) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/73.0.3683.103 Safari/537.36",
    "client_ip": "93.184.216.34",
    "url": "https://sample.instructure.com/accounts",
    "referrer": "https://sample.instructure.com/accounts/",
    "producer": "canvas",
    "event_name": "account_created",
    "event_time": "2024-11-01T18:42:07.091Z"
  },
  "body": {
    "name": "Account Name",
    "account_id": 3,
    "root_account_id": 1,
    "parent_account_id": 2,
    "external_status": "paid",
    "workflow_state": "active",
    "default_time_zone": "America/Chicago",
    "default_locale": "en"
  }
}

Event Body Schema

Field
Description

name

The name of the account.

account_id

The Canvas id of the account.

root_account_id

The id of the Canvas root account the created account belongs to.

parent_account_id

The id of the Canvas parent account of the created account.

external_status

The external status of the account.

workflow_state

The workflow state of the account.

default_time_zone

The default time zone of the account.

default_locale

The default locale of the account.

account_notification_created

Definition: The event is emitted anytime an account level notification is created by and end user or API request.

Trigger: Triggered anytime a new account notification is created.

Payload Example:

{
  "metadata": {
    "root_account_uuid": "VicYj3cu5BIFpoZhDVU4DZumnlBrWi1grgJEzADs",
    "root_account_id": "21070000000000001",
    "root_account_lti_guid": "7db438071375c02373713c12c73869ff2f470b68.oxana.instructure.com",
    "user_login": "oxana@example.com",
    "user_account_id": "21070000000000001",
    "user_sis_id": "456-T45",
    "user_id": "21070000000000001",
    "time_zone": "America/Chicago",
    "context_type": "Account",
    "context_id": "21070000000000565",
    "context_sis_source_id": "2017.100.101.101-1",
    "context_account_id": "21070000000000079",
    "context_role": "TaEnrollment",
    "request_id": "1dd9dc6f-2fb0-4c19-a6c5-7ee1bf3ed295",
    "session_id": "ef686f8ed684abf78cbfa1f6a58112b5",
    "hostname": "oxana.instructure.com",
    "http_method": "POST",
    "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_14_3) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/73.0.3683.103 Safari/537.36",
    "client_ip": "93.184.216.34",
    "url": "https://oxana.instructure.com/accounts/4/account_notifications",
    "referrer": "https://oxana.instructure.com/accounts/8/settings",
    "producer": "canvas",
    "event_name": "account_notification_created",
    "event_time": "2019-11-01T18:42:07.091Z"
  },
  "body": {
    "account_notification_id": "21070000000000004",
    "end_at": "2018-10-12T06:00:00Z",
    "icon": "information",
    "message": "<p>This is a new Announcement</p>",
    "start_at": "2018-10-12T06:00:00Z",
    "subject": "This is a new Announcement"
  }
}

Event Body Schema

Field
Description

account_notification_id

The Canvas id of the account notification.

end_at

When to expire the notification.

icon

The icon to display with the message. Defaults to warning.

message

The message to be sent in the notification. NOTE: This field will be truncated to only include the first 8192 characters.

start_at

When to send out the notification.

subject

The subject of the notification. NOTE: This field will be truncated to only include the first 8192 characters.

account_updated

Definition: The event is emitted anytime an account is updated by an end user or API request.

Trigger: Triggered anytime an existing account is updated.

Payload Example:

{
  "metadata": {
    "root_account_uuid": "VicYj3cu5BIFpoZhDVU4DZumnlBrWi1grgJEzADs",
    "root_account_id": "21070000000000001",
    "root_account_lti_guid": "7db438071375c02373713c12c73869ff2f470b68.example.instructure.com",
    "user_login": "example@example.com",
    "user_account_id": "21070000000000001",
    "user_sis_id": "456-T45",
    "user_id": "21070000000000001",
    "time_zone": "America/Chicago",
    "request_id": "1dd9dc6f-2fb0-4c19-a6c5-7ee1bf3ed295",
    "session_id": "ef686f8ed684abf78cbfa1f6a58112b5",
    "hostname": "sample.instructure.com",
    "http_method": "POST",
    "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_14_3) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/73.0.3683.103 Safari/537.36",
    "client_ip": "93.184.216.34",
    "url": "https://sample.instructure.com/accounts/3",
    "referrer": "https://sample.instructure.com/accounts/3",
    "producer": "canvas",
    "event_name": "account_updated",
    "event_time": "2024-11-01T18:42:07.091Z"
  },
  "body": {
    "name": "Account Name",
    "account_id": 3,
    "root_account_id": 1,
    "parent_account_id": 2,
    "external_status": "paid",
    "workflow_state": "active",
    "default_time_zone": "America/Chicago",
    "default_locale": "en"
  }
}

Event Body Schema

Field
Description

name

The name of the account.

account_id

The Canvas id of the account.

root_account_id

The id of the Canvas root account the created account belongs to.

parent_account_id

The id of the Canvas parent account of the created account.

external_status

The external status of the account.

workflow_state

The workflow state of the account.

default_time_zone

The default time zone of the account.

default_locale

The default locale of the account.


This documentation is generated directly from the Canvas LMS source code, available on Github.

Last updated

Copyright © 2008-2024 Instructure, Inc. All rights reserved. Various trademarks held by their respective owners.