mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-06-04 09:16:49 +00:00
66 lines
2.2 KiB
Markdown
66 lines
2.2 KiB
Markdown
---
|
|
layout: page
|
|
title: "Wunderlist"
|
|
description: "Instructions on how to use Wunderlist with Home Assistant."
|
|
date: 2018-10-09 10:10
|
|
sidebar: true
|
|
comments: false
|
|
sharing: true
|
|
footer: true
|
|
logo: wunderlist.png
|
|
ha_category: Calendar
|
|
ha_release: 0.84
|
|
---
|
|
|
|
The `wunderlist` component allows you to create tasks in [Wunderlist](https://www.wunderlist.com) from Home Assistant. You can use this if you want Home Assistant to send you a task that
|
|
you should not forget, e.g., Congratulate Dani.
|
|
|
|
## {% linkable_title Setup %}
|
|
|
|
Wunderlist API uses OAuth2, so you need to obtain a `client_id` and an `access_token`.
|
|
There are two ways:
|
|
|
|
|
|
1. Go to the [Wunderlist IOT app page](https://wunderlist-iot.herokuapp.com), login with your Wunderlist account and accept the application permissions.
|
|
It will print for you the `client_id` and the `access_token`.
|
|
2. Or you can create your own application and `access_token` following the instructions at the [Wunderlist developer page](https://developer.wunderlist.com/).
|
|
|
|
Store the parameters in your Home Assistant configuration:
|
|
|
|
```yaml
|
|
# Example configuration.yaml entry
|
|
|
|
wunderlist:
|
|
client_id: YOUR_CLIENT_ID
|
|
access_token: YOUR_ACCESS_TOKEN
|
|
|
|
```
|
|
|
|
|
|
{% configuration %}
|
|
client_id:
|
|
description: The ID of your Wunderlist application (OAuth2).
|
|
required: true
|
|
type: string
|
|
|
|
access_token:
|
|
description: A token for your Wunderlist personal account (For the ``client_id`` application).
|
|
required: true
|
|
type: string
|
|
{% endconfiguration %}
|
|
|
|
## {% linkable_title Creating tasks with service `create_task`%}
|
|
|
|
This component offers a new service domain `wunderlist` with the service `create_task`.
|
|
You can call this service with the argument `list_name` the argument `name` and the optional parameter `starred` to create a new task.
|
|
|
|
|
|
|Service data attribute | Optional | Description | Example |
|
|
|-----------------------|----------|-------------|---------|
|
|
| list_name | no | Name of the list | "Shopping list"
|
|
| name | no | Name of the new task | "Spanish Jam" |
|
|
| starred | yes | Create the task starred or not | false |
|
|
|
|
## {% linkable_title Disclaimer %}
|
|
This product uses the Wunderlist API but is not endorsed or certified by Wunderlist.
|