Trello

To create cards in Trello for Squadcast Incidents with the help of Outgoing Webhooks

Create a Card in Trello via Webhook Template

Follow the below steps to configure the “Trello - Create Card” action via webhooks.

You will be utilizing Trello's Rest APIs to create cards.

Create API Key and Token to Authenticate Trello Rest API

For generating an API key and Token, you first need to have created a Trello Power-Up.

1. Login to https://trello.com/power-ups/admin -> New

2. Fill all the required fields -> Create

1. Navigate to API Key -> Generate a new API Key -> Copy the API Key

2. On the same page where you found your API key, click the hyperlinked Token at the right of the API key. You will see the following page and Copy the Token

Get List ID to create Trello Cards

You need to have the ID of the list in which you are going to create cards

Here we have used Postman to generate the List ID

1. Log in to Trello and copy your Workspace ID from the browser URL

1. Paste the below cURL in Postman

curl --request GET \
  --url 'https://api.trello.com/1/boards/{id}/lists?key=APIKey&token=APIToken' \
  --header 'Accept: application/json'

1. Paste the API Key and Token in the Params section and replace {id} with your workspace id in the URL and click on Send to get the Lists

2. Copy the List ID in which you would like to create cards

Using Webhooks to create Trello cards for Squadcast Incidents

1. Navigate to Settings -> Webhooks.

2. Click Add Webhook. On the next screen, you will be guided through three steps. Navigate between these steps by clicking on any of the steps on the top bar.

3. Add Webhook Details:

   1. Webhook Name: Enter the webhook name as Trello - Create Card.

   2. Webhook Description (optional): Enter an optional description. For example - This webhook is for ticket creation in Freshservice for Squadcast Incidents.

   3. Failure Notification Email (optional): Enter an email where you want to receive failure notifications. This is particularly helpful when you (or an administrator) want to be notified of webhook-related failures.

   4. URL: Copy and paste the below API.

   https://api.trello.com/1/cards

Note:

Under Additional headers, Content-Type: application/JSON is added by default.

Click Next: Choose Webhook Type, and navigate to the next step.

1. Choose Webhook Type: Choose Webhook type (Manual or Automatic) and add configurations.

   1. Manual Webhook: Manually trigger Webhooks under incidents, on demand. Under Manual Webhook, select the teams that are authorized to access the Webhook. You can select All Teams or enter specific Teams, from the drop-down.

Note:

Select this option only if you want to create Trello cards manually on-demand. If you want a card, created automatically when certain conditions are met, please choose Automatic webhooks.

1. Automatic Webhook: Automatically trigger Webhooks when the configured conditions match. To set up Automatic Webhook Configurations:

   1. Versions: Select v2

   2. Triggers: Select the following Trigger events (conditions) for which the Webhook will be triggered:

      1. Incident Triggered (This will create a Trello card whenever a new incident gets triggered in Squadcast)

   3. Filters: You can apply filters on top of events, based on Teams, Services, Alert Sources, and Tags, by having an individual expression or a combination of expressions/expression groups.

Applying filters will trigger the webhook and create Trello cards only for events that match the filter.

Click Next: Configure Payload, and navigate to the next step.

1. Configure Payload: Select the pre-configured template for Trello - Create Card. You can also test the Webhook by clicking the Test Webhook on the bottom right.

Note:

Enter the List ID, API Key, and Token copied in the above steps in their respective fields.

We have added the necessary fields in the template. You can also use this link to check the fields accepted by Trello Create Card API.

Click Save and your Webhook is created.