TwentyDEV icon

TwentyDEV

Consume the Twenty API

Actions252

Overview

This node allows you to delete a single Opportunity object by its unique identifier. It is useful in scenarios where you need to programmatically remove an opportunity record from your system, such as cleaning up outdated or invalid opportunities, or automating data management workflows.

For example, if you have a list of opportunity IDs that are no longer relevant, you can use this node to delete each one automatically without manual intervention.

Properties

Name Meaning
Id The unique identifier of the Opportunity object to be deleted. This is a required string value.

Output

The node outputs JSON data representing the result of the deletion operation. Typically, this will include confirmation that the specified Opportunity was successfully deleted or an error message if the deletion failed.

If the API supports it, the output may also contain metadata about the deleted object or status codes indicating success or failure.

No binary data output is expected from this operation.

Dependencies

  • Requires an API key credential for authenticating with the Twenty API service.
  • The node uses the Twenty API base URL configured via credentials.
  • Proper permissions to delete Opportunity objects must be granted to the authenticated user.

Troubleshooting

  • Missing or invalid Id: Ensure the "Id" property is provided and correctly references an existing Opportunity. An empty or incorrect ID will cause the deletion to fail.
  • Authentication errors: Verify that the API key credential is valid and has sufficient permissions.
  • Network issues: Check connectivity to the Twenty API endpoint.
  • API errors: If the Opportunity does not exist or cannot be deleted due to business rules, the API will return an error message. Review the output JSON for details.

Links and References

Discussion