Use the webhooks integration to create a Trello card

This page is not yet available in Spanish. We are working on its translation.
If you have any questions or feedback about our current translation project, feel free to reach out to us!

You can use the webhooks integration to instantly create a Trello card using the @-notification feature.

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

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

Login to Trello to get your Trello application key and token.

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

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:

trello_api_key

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.

card_url

From there, find the value of idList:

id_list

Configure the Webhook

See the API documentation for Trello cards and Datadog’s webhooks integration

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:

{
  "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:

integration_config

Some points to consider

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

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.

PREVIEWING: safchain/fix-custom-agent