Setting up the topping

1. Navigate to the Connections section in the left panel and click the Get Started button.
   

1. Under the Services section, select Custom Services, then click Create Service.
   

1. Fill in the required details for the custom service in the configuration screen.
   

1. Enter a name for the custom service connection under Service Name; this will automatically generate the service link name.
   
2. Select the appropriate authentication type supported by the third-party application from the available options: API key, Basic Authentication, OAuth 1, OAuth 2, or AWS signature.

Note:

Refer to the official API documentation of the third-party application to determine the authentication type.

1. Each authentication type has its own set of parameters to ensure secure integration with the third-party app. For detailed instructions on configuring each authentication type and field, refer to this guide.
   
2. For integrating with Trello, we'll choose API Key, which is the authentication type supported by the Trello app. For more information on getting your API key and token, refer to the Trello API documentation. Trello requires an API key and token to authenticate with another app. They have to be configured as query parameters, so set the parameter type to Query String.
   
3. In the Parameter Key fields, enter the key and token, and set their corresponding Parameter Display Names to Trello API Key and Trello Token respectively.

Note:

Providing both the key and token is essential because Trello requires these two credentials for secure API access.

The key is the unique identifier for your application, and the token is a user-specific credential that authorizes our application to access and modify Trello data.

1. Once all the required parameters are configured, click Create Service.
   

1. On the following screen, provide a connection name for your Trello integration; this name will automatically generate the Connection Link Name.
   
2. Once you've entered the necessary details, click the Create And Connect button to start the connection process.

1. You'll be prompted to authenticate your Trello account using the API key and token you got from the Trello API documentation.
   
2. After entering these credentials, click Connect to authenticate and integrate your Trello account with the custom service you have created.
   

1. Once the connection is established, you'll be redirected back to the Bigin Developer Console. Here, you can view the details of your custom service connection, including the connection link name, confirming that the integration with Trello is active and ready for use.
   

1. Retrieve the details of the newly created task from Bigin using its Task ID.
   
2. Extract relevant task data such as the subject (used as the task name) and description.
   
3. Identify the target Trello board and the specific list where the card should be created.
   
4. Fetch all lists from the Trello board and locate the list ID that matches the desired list name. For our use case, we'll be creating the task as a card in the Trello list named "Today" so that the task created on that specific day will fall under the Today list. Later, it can be moved across other lists in Trello as its status updates.
   
5. Prepare the card details using the extracted task information and the identified list ID.
   
6. Create a new card in Trello using the prepared details.