Ridwell

The Ridwell integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] allows users to track waste recycling pickups scheduled with Ridwell.

Configuration

To add the Ridwell service to your Home Assistant instance, use this My button:

Options

Options for Ridwell can be set via the user interface, by taking the following steps:

• Browse to your Home Assistant instance.
• Go to Settings > Devices & services.
• If multiple instances of Ridwell are configured, choose the instance you want to configure.
• Select the integration, then select Configure.

Event summary details

The calendar event summary can be customized to display different details about a given pickup.

The following choices are available for customizing the text. Each option is also detailed more in separate sections below.

Pickup status

Common statuses for an individual pickup include:

• initialized: Available for customers to opt-in for pickup
• scheduled: Opted-into; Ridwell will include you in their route that day
• notified: Ridwell has attempted to contact customers who have not opted-in to pickups happening soon
• skipped: Previously scheduled but then later unscheduled (canceled)

Rotating category

The rotating category will be displayed once a pickup has been scheduled successfully.

If a pickup does not have the scheduled status, the calendar event will display the Pickup status values described under Pickup status until the pickup has a scheduled status.

No details

The calendar title will show “Ridwell Pickup” only, but full details on the various pickup types will still be included in the description of the event.

Calendar

The calendar sensor contains a calendar state attribute, which contains:

• The name of the Ridwell Calendar.
• If the event is an all-day event (Boolean).
• The start time of the calendar event. Starts at midnight.
• The end time of the event. Ends at midnight.
• The location of the event.
• The description of the items being picked up.
• Friendly name of the calendar event.

For example:

message: Ridwell Pickup (scheduled)
all_day: true
start_time: 2024-07-26 00:00:00
end_time: 2024-07-27 00:00:00
location: 
description: Pickup types: Light Bulbs (quantity: 1), Hand Tools (quantity: 1), Batteries (quantity: 1), Threads (quantity: 1), Plastic Film (quantity: 1)
friendly_name: Ridwell

Pickup types

The pickup sensor contains a pickup_types state attribute, which contains:

• The items being picked up during this particular event
• The category of each item
• The quantity of each item

For example:

{
  "Latex Paint": {
    "category": "add_on",
    "quantity": 7
  },
  "Beyond the Bin": {
    "category": "add_on",
    "quantity": 2
  },
  "Fluorescent Light Tubes": {
    "category": "add_on",
    "quantity": 1
  },
  "Winter Coats and Jackets": {
    "category": "rotating",
    "quantity": 1
  },
  "Light Bulbs": {
    "category": "standard",
    "quantity": 1
  },
  "Batteries": {
    "category": "standard",
    "quantity": 1
  },
  "Threads": {
    "category": "standard",
    "quantity": 1
  },
  "Plastic Film": {
    "category": "standard",
    "quantity": 1
  }
}

Troubleshooting

If pickup information in Home Assistant does not match recent changes to your Ridwell account, you can manually trigger a check for new details by reloading the Ridwell integration. On the integration overview page, choose Reload from the options menu on the specific account instance you want refreshed.

Removing the integration

This integration follows standard integration removal steps.

Any pickups scheduled or modified by this integration will persist after removing the integration, and they can continue to be managed using the Ridwell site or app.

To remove an integration instance from Home Assistant

1. Go to Settings > Devices & services and select the integration card.
2. From the list of devices, select the integration instance you want to remove.
3. Next to the entry, select the three dots menu. Then, select Delete.