---
isPrivate: true
title: Use the webhooks integration to create a Trello card
description: Datadog, the leading service for cloud-scale monitoring.
breadcrumbs: >-
  Docs > Extend Datadog > Extending Datadog FAQ > Use the webhooks integration
  to create a Trello card
---

# Use the webhooks integration to create a Trello card

You can use the [webhooks integration](https://docs.datadoghq.com/integrations/webhooks/) to instantly create a Trello card using the [@-notification feature](https://docs.datadoghq.com/monitors/notify/).

This flow uses the Trello REST POST card API endpoint to post an @notification to a relevant Trello list.

## Overview{% #overview %}

- Locate your Trello app key and token

- Find the list in the board to which you want to submit cards

- Configure a webhook

## Getting your Trello app key and token{% #getting-your-trello-app-key-and-token %}

Login to Trello to get your [Trello application key and token](https://trello.com/app-key).

**NOTE**: Trello mentions API key in the URL. For this article, API and app keys are one and the same.

{% image
   source="https://datadog-docs.imgix.net/images/extend/faq/developer_api_key.8814e4d137d3915ecdf70757070ca4bb.png?auto=format"
   alt="developer_api_key" /%}

To get the token, click the token link (green arrow) above, authorize a token with the Trello account you are logged into, and grab the token in the subsequent link:

{% image
   source="https://datadog-docs.imgix.net/images/extend/faq/trello_api_key.483c48548d949269014d71d13c93845f.png?auto=format"
   alt="trello_api_key" /%}



## Designate the Trello list{% #designate-the-trello-list %}

Click on a card in the list you'd like to add cards to. Append `.json` to the URL, and then navigate to that URL.

{% image
   source="https://datadog-docs.imgix.net/images/extend/faq/card_url.167bc10fbc5d3cebc84f2dcb2ca41282.png?auto=format"
   alt="card_url" /%}



From there, find the value of `idList`:

{% image
   source="https://datadog-docs.imgix.net/images/extend/faq/id_list.624ea6da67a4969b6473f411178c3b50.png?auto=format"
   alt="id_list" /%}



## Configure the Webhook{% #configure-the-webhook %}

See the [API documentation for Trello cards](https://trello.com/guide) and Datadog's [webhooks integration](https://docs.datadoghq.com/integrations/webhooks/)

In the configuration:

- "name" is the alias for how you reference this hook (@webhook-NAME)

- "URL" is `https://api.trello.com/1/cards`

Enable Custom Payload and fill in a JSON object that looks like:

```json
{
  "name": "$USER : $EVENT_TITLE",
  "desc": "$EVENT_MSG",
  "key": "{APP_KEY}",
  "token": "{TOKEN_KEY}",
  "pos": "bottom",
  "idList": "{ID_LIST_VALUE}"
}
```

- **name**: title of the card
- **desc**: description of the card
- **key**: application key
- **token**: token key
- **pos**: relative position of the card on the list
- **idList**: list ID

The resulting config looks like this:

{% image
   source="https://datadog-docs.imgix.net/images/extend/faq/integration_config.aef017da5dad309f459344e7f164802a.png?auto=format"
   alt="integration_config" /%}



## Some points to consider{% #some-points-to-consider %}

This flow involves Trello generating a server token for the application. As you can see in the token disclaimer:

{% image
   source="https://datadog-docs.imgix.net/images/extend/faq/trello_disclaimer.178ee87aa19f2c098b90c201bfa018d3.png?auto=format"
   alt="trello_disclaimer" /%}



The token provides read/write access to all your boards and teams, so this is a potential concern if you do not want to give away access in this way.

To avoid this, consider creating a specific Trello user that is only joined to the board you designate. Have that user receive the server token.