Actions60
- User Actions
- Teams Actions
- Custom Fields Actions
- Tickets Actions
- Deals Actions
- Webhooks Actions
- Contacts Actions
- Companies Actions
- Bussiness Types Actions
- Tags Actions
- Deal Phases Actions
- Invoices Actions
- Subscriptions Actions
- Products Actions
- Projects Actions
- Tasks Actions
- Files Actions
Overview
The "Win Deal" operation in the Teamleader node marks a specific deal as won within the Teamleader CRM system. This action updates the status of the deal to indicate successful closure, which is useful for sales and business development workflows that track deal progress and outcomes.
Common scenarios where this node is beneficial include:
- Automating sales pipelines by programmatically marking deals as won after certain criteria are met.
- Integrating with other systems to update deal statuses based on external triggers or events.
- Reporting and analytics workflows that require up-to-date deal statuses.
For example, after a contract is signed in an external system, this node can be used to automatically mark the corresponding deal as won in Teamleader, ensuring consistent data across platforms.
Properties
| Name | Meaning |
|---|---|
| ID | The unique identifier of the deal to mark as won. This is required to specify which deal the operation applies to. |
Output
The output of the "Win Deal" operation is a JSON object representing the updated deal data returned from the Teamleader API. The structure typically includes details about the deal such as its ID, title, status (now marked as won), and other related metadata.
If multiple deals were processed (in batch mode), the output will be an array of such deal objects.
No binary data is output by this operation.
Dependencies
- Requires an active OAuth2 API credential configured in n8n to authenticate requests to the Teamleader API.
- The node sends HTTP POST requests to the Teamleader API endpoint
https://api.focus.teamleader.euwith the operation path set to"deals.win".
Troubleshooting
- Missing or invalid deal ID: The operation requires a valid deal ID. If the ID is missing or incorrect, the API will return an error indicating the deal could not be found.
- Authentication errors: Ensure the OAuth2 credentials are correctly set up and have not expired. Authentication failures will prevent the operation from succeeding.
- API response issues: If the API returns no data or unexpected responses, verify network connectivity and API availability.
- Continue on Fail: If enabled, the node will continue processing subsequent items even if one fails, returning error messages in the output JSON.
Links and References
- Teamleader API Documentation - Official documentation for the Teamleader API endpoints and usage.