Attio icon

Attio

Interact with Attio API

Overview

This node allows you to create a new comment in the Attio platform by sending a POST request to the comments endpoint. It is useful for automating the addition of comments to threads within Attio, such as adding notes, feedback, or updates related to workspace activities.

Practical examples include:

  • Automatically posting comments when certain events occur in other systems.
  • Adding collaborative notes to threads based on workflow triggers.
  • Logging communication or status updates programmatically into Attio threads.

Properties

Name Meaning
Data JSON object representing the comment to be created. This includes fields like content (the text of the comment), author (an object specifying the type and ID of the author, e.g., a workspace member), created_at (timestamp of creation), and thread_id (the identifier of the thread where the comment will be posted).

The Data property expects a JSON structure similar to:

{
  "content": "If I put the email address of my colleague on Attio in here, e.g. alice@attio.com, they will be notified. Other emails (e.g. person@example.com) will be turned into clickable links.",
  "author": {
    "type": "workspace-member",
    "id": "50cf242c-7fa3-4cad-87d0-75b1af71c57b"
  },
  "created_at": "2023-01-01T15:00:00.000000000Z",
  "thread_id": "aa1dc1d9-93ac-4c6c-987e-16b6eea9aab2"
}

Output

The node outputs the response from the Attio API as JSON under the json field. This typically contains the details of the newly created comment, including its unique identifier and all submitted properties confirmed by the server.

No binary data output is produced by this node.

Dependencies

  • Requires an API key credential for authenticating with the Attio API.
  • The node sends HTTP requests to the Attio API endpoint https://api.attio.com/v2/comments.
  • Proper configuration of the API key credential in n8n is necessary for successful authentication.

Troubleshooting

  • Common issues:

    • Invalid or missing API key credential will cause authentication failures.
    • Malformed JSON in the Data property can lead to request errors.
    • Providing incorrect or non-existent thread_id or author.id may result in API errors indicating resource not found.
  • Error messages:

    • "Operation POST -v2-comments not found for resource Comments": Indicates a misconfiguration or unsupported operation selection.
    • API error responses related to authorization or validation will be returned in the node's output if "Continue On Fail" is enabled; otherwise, they will stop execution.
  • Resolutions:

    • Ensure the API key credential is correctly set up and has sufficient permissions.
    • Validate the JSON structure before inputting it into the node.
    • Confirm that referenced IDs (thread, author) exist in your Attio workspace.

Links and References

Discussion