home-assistant.io/source/_components/wunderlist.markdown
Luis Martinez de Bartolome Izquierdo 212108c8fe Wunderlist Docs (#7448)
* Wunderlist Docs

* Review

* Update wunderlist.markdown
2018-11-27 15:45:11 +01:00

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.