TwentyDEV icon

TwentyDEV

Consume the Twenty API

Actions252

Overview

This node allows you to delete a single person record from the "People" resource by specifying the unique identifier of that person. It is useful in scenarios where you need to remove outdated, incorrect, or unwanted user data from your system or an external service managing people records.

For example, if you maintain a contact list and want to programmatically remove a contact based on their ID, this node can be used to perform that deletion automatically within an n8n workflow.

Properties

Name Meaning
Id The unique identifier (object id) of the person to delete. This is required to specify which person record should be removed.

Output

The output JSON will typically contain the response from the API after attempting to delete the specified person. This may include confirmation of deletion or any error messages returned by the service.

No binary data output is expected from this operation.

Dependencies

  • Requires an API key credential for authenticating with the external service managing the "People" resource.
  • The node uses a base URL configured via credentials to connect to the API endpoint.
  • The node depends on the external Twenty API (as indicated by the bundled OpenAPI specification), so network access to this API is necessary.

Troubleshooting

  • Missing or invalid Id: If the "Id" property is not provided or is incorrect, the API will likely return an error indicating that the object could not be found or deleted.
  • Authentication errors: Ensure that the API key credential is correctly set up and has sufficient permissions to delete person records.
  • Network issues: Verify connectivity to the API endpoint and that the base URL is correctly configured.
  • API rate limits or restrictions: If the API enforces rate limits, repeated deletion attempts might fail temporarily.

Links and References

  • Refer to the official API documentation of the external service managing the "People" resource for detailed information about the delete operation and error codes.
  • n8n documentation on how to configure API credentials and use HTTP-based nodes.

Discussion