TwentyDEV icon

TwentyDEV

Consume the Twenty API

Actions252

Overview

This node interacts with the "Messages" resource of the Twenty API to retrieve a single message by its unique identifier. It is useful when you need detailed information about a specific message, including optionally related nested objects. For example, you might use this node to fetch a particular message's content and metadata for display or processing in a workflow.

Properties

Name Meaning
Id The unique identifier of the message object to retrieve.
Depth Determines how much related nested data to include in the response:
- 0: Only the primary message.
- 1: Primary message plus directly related objects.
- 2: Primary message, directly related objects, and their related objects.

Output

The node outputs a JSON object representing the requested message. The structure includes the message's core properties and, depending on the Depth parameter, may also include nested related objects up to two levels deep. This allows workflows to access comprehensive message details and associated entities in one call.

No binary data output is indicated.

Dependencies

  • Requires an API key credential for authenticating requests to the Twenty API.
  • The base URL for the API is configured via credentials.
  • The node uses standard HTTP headers for JSON communication (Accept and Content-Type set to application/json).

Troubleshooting

  • Missing or invalid Id: If the Id property is empty or incorrect, the API will likely return an error indicating the message was not found. Ensure the correct message ID is provided.
  • Authentication errors: If the API key credential is missing or invalid, authentication will fail. Verify that the credential is correctly configured.
  • Depth parameter misuse: Providing an unsupported depth value (outside 0, 1, 2) may cause unexpected results or errors. Use only the allowed options.
  • Network or API issues: Connectivity problems or API downtime can cause request failures. Check network status and API availability.

Links and References

Discussion