How to reset a communication channel?

I have a task that sends course level notifications to students using the Canvas API, using communication channels, notification preferences, and conversations.

Communication Channel Fact of Canvas Data shows that, bounce_count is the Number of permanent bounces since the channel was last reset. If it's greater than 0, then no email is sent to the channel, until it is either reset by a siteadmin or it is removed and re-added by a user.

I read that description to say that no email is sent once 1 fails. District emails are all on same email system, so seeing 1-87 bounces for school emails is troublesome. The fact that a single bounce prevents the communication channel from future messages seems terrible.

How does the site admin reset the channel?

Communication Channels - Canvas LMS REST API Documentation

Does not have a reset option.

Seems like the only solution would be to DELETE and CREATE with skip_confirmation flag?

Any ideas?

Find more posts tagged with

Accepted answers

audra_agnelly

carroll-ccsd‌, the only way I know how to do this is to send a ticket to Canvas Support and ask them to remove the flag on the email. For our K-5 students we block all external emails so their addresses get flagged as soon as they're in Canvas. In September I send Support a list of accounts for our rising 6th graders so that we can get Canvas notifications to start sending back to their district email. I don't know of any other way as a site admin to reset the bounce count. Since the user account's primary email (district email) is sent from our SIS it can't be deleted by myself or the user to reset it. If someone's found a way to do this through API, I'd love to know.

All comments

audra_agnelly

RobDitto

Seems like the only solution would be to DELETE and CREATE with skip_confirmation flag?

That is indeed what I do with Communication Channels API when I need to force-confirm a channel for a user. Thankfully the need is rare.

James

There is a reset_bounce_count method in the communication_channels_controller. It's not documented because it's not an API call.

According to the routes.rb, it's

post 'users/:user_id/communication_channels/:id', action: :reset_bounce_count, as: 'reset_bounce_count'

Strangely, the next line mentions a bouncing_channel_report. Calling the route listed makes Canvas say there's nothing there.

The line after that talks about a post that will bulk_reset_bounce_counts.

The communication_channel.rb file has a note to reset bounce count when we're being reactivated.

The communication_channels_controller_spec.rb file says that POST 'reset_bounce_count' "should allow siteadmins to reset the bounce count" but not account admins.

All of that said, I do not know where it is accessible from within Canvas. The closest I can find is as the user themselves, when they go to Account > Settings, they get this:

With some quick playing around, I was not able to get a request to any of internal calls those to work. Mostly getting 422 Unprocessable Entity status codes.

When I go to the Account > Settings > Account Admins, I see that I'm listed as an Account Admin. Maybe none of thise works because I'm not a site admin, just an account admin at the root account level. I don't think I've ever encountered that before.

I share the findings here. It's not a working solution, but perhaps it will spark something that does work.

There is a constant RETIRE_THRESHOLD that is used to determine how many bounces can happen before retiring the account. It is set to 1.

Robert

Thanks Everyone!

I submitted a ticket to support and they returned with, providing the domains I want reset. This is easy enough to request once a year or before each term if the channels are cut for currently enrolled users.

dgorman73

My students can contact me in canvas but I cannot respond through my university email, I have to do it in Canvas, and it told me to set up the communication channel.

Thanks in advance.

David

Unanswered Questions

Web bug... not sure where to report.
Rendering bug here: Canvas - Instructure Community Seems to only appear in Edge; fine in Chrome and Firefox https://us.v-cdn.net/6038536/uploads/W3BKB9LY5FCV/recording-2026-04-08-144351.mp4
Obtaining access token using developer key for server-to-server REST API access
I have a developer key in our Test instance: How would I use this in a local program to make a REST API call? Looking at https://developerdocs.instructure.com/services/canvas/oauth2/file.developer_keys: Developer keys are OAuth2 client ID and secret pairs stored in Canvas that allow third-party applications to request…
Finding the LTIv1.3 IDs for Members of a Course
I'm building a tool for my institution that imports grades from another LTI tool into Canvas so instructors can automate late assignment policies not otherwise supported by Canvas. I'm trying to use the LTIv1.3 ID which is readily available on the LTI-side as a link to the student record on Canvas, but I can't find the ID…
Canvas Media Question
How can one track Canvas Media use without having the reports available from Canvas Studio? Checking API endpoints and the Data 2 schema, there do not seem to be dedicated Canvas Media endpoints. Am I missing some? A method I've considered is using the body field of the wiki_pages table, as this contains the html code of…
Canvas Catalog API - Completed Certificates
Hello, I'm trying to utilize an API call to pull completed certificates and was hoping to download and store the certs as a backup. I can successfully run the API call but it will not allow me to view the certificate unless I access the URL while signed into an account where it's "my" cert. Is there a permissions setting…