Skip to integration content

How to integrate Unify with Trello

To integrate Unify with Trello, configure a Unify Play Webhook action to call the documented API with POST, the required credentials, and the destination-specific JSON body. Use this connection to create a Trello card in a prospect review queue.[1][2][3]

By UnifyDocumentation reviewed
Connection
Via API
Team collaboration
Tool
Trello
Trello
Data flow
Unify → Trello
JSON payload

At a glance

  1. Via API: Trello receives the handoff
  2. POST request with an explicit JSON contract and destination authentication
  3. Test scenario: Prevent duplicate cards

When this workflow makes sense

Start with the decision your team needs to make, then choose the connection that supports it.

A visual queue works when each card has a small decision attached. Include the known account context and the next review step, then agree how the team indicates completion. Treat card volume as a workflow design choice rather than sending every Play event.

A good fit when

Teams that want to create a Trello card in a prospect review queue and have an owner for the receiving process. The destination account must permit the documented request and the chosen downstream action.

Reconsider the plan when

The receiving team has not agreed how this Trello operation should behave when the same record arrives again. Resolve the matching rule before enabling retries.

Design the handoff

Use this framework to agree on the input, the next action, and who owns the result.

Suggested workflow design, based on the documented capabilities below.

StageDecision to make
Business decisionCreate a Trello card in a prospect review queue
Receiving contractAgree which of the 2 example data fields the receiving process actually needs. Set missing-value and identity rules in the field mapping below.
Execution boundaryGive one owner access to inspect the Trello request and its resulting action.
CompletionDecide who can confirm the Trello outcome and recover a failed or repeated handoff. Use the completion check below as the acceptance criterion.

Explore the scenarios

Choose the situation that fits your team and work through the proposed plan.

Open a scenario to explore its plan. Checklists track your selections in this page only.

Create a Trello card in a prospect review queue

Start with one controlled record and one intended Trello outcome. Keep the test destination separate from live operations.

The decision that matters

The receiving owner must distinguish accepted input from completed work. Agree on the evidence required before treating this handoff as successful.

  1. Prepare the destination using the Trello setup checklist
  2. Resolve the sample fields for one known record and inspect the request before sending it
  3. Trace that handoff through the receiving operation and compare the actual destination values with the source
Your validation checklist
0 of 3 checks marked by you
Prevent duplicate cards

Prevent duplicate cards: use a receiver to associate handoff IDs with card IDs, resend a test handoff, and inspect whether the same business event creates only one task.

The decision that matters

Decide whether this case should be held for review, corrected, or retried. Make that decision before running Trello against live records.

  1. Isolate the test in a controlled destination and record the starting state
  2. Run the edge case described above and capture the actual response and destination state
  3. Recover the record once, then check that recovery did not create unintended additional work
Your validation checklist
0 of 3 checks marked by you

Illustrative workflow, not a preconfigured automation. Complete these checks in your own account.

Connect your tools to Unify

Set up your integration or walk through it with our team

Define success before launch

Inspect the data and the intended outcome separately. Connection status is only the first check.

Expected, not tested

Create a Trello card in a prospect review queue

Find the created card in the expected board and list. Inspect its contents and confirm a repeated delivery follows your duplicate policy.

Documentation-based reference. This workflow has not been tested end to end. Use a record or event you control before enabling live activity.

Questions answered

Common decisions when connecting Unify and Trello.

Which destination identifier is required?

The create-card operation requires idList, the identifier of the receiving Trello list. Name and description supply the visible card content.[3]

Limits & decisions

Check these boundaries before designing a live workflow around the connection.

  • Card creation appends work; it does not automatically update an existing card for the same email.[3]
  • API and trigger access depend on the destination account, permissions, and configuration. This request pattern is not a claim of native Unify sync.[3]

What the connection supports

Understand the connection, the data involved, and the behavior that matters for a Unify + Trello workflow.

Connection flowVia API
Prospect data

POST / JSON

Documented behavior at a glance
DecisionWhat to know
Unify actionOutbound HTTP request with configurable method, authentication, headers, and body[1]
Receiving operationChoose the target board and list, then copy idList. Agree who checks new cards and what moves them out of the queue.[3]
Response handlingWebhook response bodies are not available as inputs to later Unify Play actions[2]

Technical setup reference

References and requirements for the Trello connection.

Connection requirements and setup checklist

Before connecting

  • A Unify Play with a Webhook action and a controlled record for testing
  • Access to the intended Trello environment and the permissions required by the cited API or trigger
  • The destination identifiers, credentials, and schema used by the request below
  • An agreed record identity, duplicate policy, and owner for failed handoffs
  1. Prepare the Trello destination

    Choose the target board and list, then copy idList. Agree who checks new cards and what moves them out of the queue.[3]

  2. Configure the destination action

    POST the card body with name and desc. Add members or labels only using valid IDs from the target board.[3]

  3. Configure the Unify request

    Use POST, the endpoint and authentication below, and JSON body format in the Webhook action. Replace setup placeholders, then inspect Expand preview with a controlled record. The receiver must respond within 8 seconds; webhook response bodies are not exposed to later Play steps.[1][2]

  4. Validate the complete handoff

    Run the success and edge-case scenarios in Explore the scenarios with a controlled record. Save the request identity and destination evidence, then apply the completion check before enabling live traffic.[3]

Request configuration

Method
POST
URL pattern
https://api.trello.com/1/cards?key=YOUR_API_KEY&token=YOUR_TRELLO_TOKEN
Headers
Content-Type: application/json
Authentication
Use a Trello API key and an authorized token for the board. Keep both query credentials private and avoid logging full request URLs.

Choose JSON as the body format. Unify sets Content-Type automatically. The receiver must respond within Unify’s 8-second timeout; request responses are not passed to later Play steps.[2]

Replace URL placeholders with the actual receiver URL from your account or deployed application. These example URLs are not working endpoints.

Example handoff payload

Start with a fictional prospect. Validate the resolved values before using a real record.

Inspect the sample payload and field mapping
Example request body
{
  "idList": "YOUR_LIST_ID",
  "name": "Review Example Company",
  "desc": "Alex Morgan, alex@example.com. Review the Unify handoff before outreach."
}

Fictional data. Replace sample values before using a real Play.

Illustrative JSON for the documented receiving operation. All prospect values are fictional. Replace credentials, identifiers, schema-specific fields, and fixed example values before a controlled test. Use the field mapping to distinguish record data from fixed settings. Select available fields in your Play and inspect Expand preview; do not replace configuration values with prospect data.[1][2][3]

Payload fieldValue to send
idListstring / configured / Destination settingsReplace this placeholder with the actual destination identifier or credential from the receiving account. Keep credentials out of prospect fields and shared examples.

If missing: Do not send the request until this setting has been supplied and checked.

namestring / dynamic / Message template plus selected person/company fieldsKeep the editorial message template and replace only its fictional person name, email, or company name with available source fields. Preserve JSON escaping.

If missing: Remove optional missing context from the message; hold it if the receiving team cannot identify the record.

descstring / dynamic / Message template plus selected person/company fieldsKeep the editorial message template and replace only its fictional person name, email, or company name with available source fields. Preserve JSON escaping.

If missing: Remove optional missing context from the message; hold it if the receiving team cannot identify the record.

idList chooses the destination list. Map the person and company context into desc; a board URL or list title is not an idList.

Troubleshooting

Start with the stage where the expected data or action stops appearing.

The request is rejected

Use a Trello API key and an authorized token for the board. Keep both query credentials private and avoid logging full request URLs. Check the receiving account, permissions, endpoint, and required fields against the cited documentation.[3]

The values or destination are wrong

Compare the resolved JSON with the field-by-field contract in Example handoff payload. Check identifiers against the selected Trello environment, and distinguish an absent source value from an intentional static value. Fix the mapping before repeating the write.[3]

Receipt does not match the expected result

Find the request in the receiving logs, then inspect the actual Trello resource or execution. If the request was accepted but no result exists, investigate the destination failure before retrying. Keep the same logical handoff identity when recovering a repeat.[3]

Sources & review

Official documentation reviewed on September 15, 2026.

Technical claims link to primary documentation from Unify and the destination tool. Scenarios, field choices, and recovery plans are editorial implementation examples. Documentation review is separate from execution testing.

Documentation reviewed; end-to-end execution not tested. No named technical reviewer has signed off on these articles yet.

Content updated: . Report a correction to Unify with the tool name, source URL, and behavior you observed.

  1. [1] Unify: Webhook action
  2. [2] Unify: Webhooks in Plays
  3. [3] Trello: official connection reference

Get started with Unify

Create your account or book a demo with our team