---
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.