AttioInstall

Overview

This node allows you to create a new record within a specified object in the Attio platform. It is useful when you want to programmatically add data entries (records) to your Attio workspace, such as adding new people, companies, or any custom objects you have defined.

Typical use cases include:

• Automatically adding new contacts or leads from other systems.
• Creating records based on form submissions or webhook triggers.
• Populating your Attio database with structured data from external sources.

For example, you could create a new "person" record with attributes like name, email, and tags by specifying the object as "people" and providing the attribute values in JSON format.

Properties

Example of the Data property value:

{
  "values": {
    "41252299-f8c7-4b5e-99c9-4ff8321d2f96": "Text value",
    "multiselect_attribute": [
      "Select option 1",
      "Select option 2"
    ]
  }
}

Output

The node outputs the response from the Attio API after creating the record. The output is a JSON object representing the newly created record, including its unique identifiers and stored attribute values.

The output structure typically contains:

• The record's ID and metadata.
• The attribute values as stored in Attio.
• Any additional information returned by the API about the created record.

No binary data is produced by this node.

Dependencies

• Requires an API authentication token credential configured in n8n to access the Attio API.
• The node sends HTTP requests to the Attio API endpoint https://api.attio.com/v2/objects/{object}/records using the POST method.
• Proper permissions on the API token are necessary to create records in the specified object.

Troubleshooting

• Invalid Object Identifier: If the provided object UUID or slug is incorrect or does not exist, the API will return an error. Verify the object identifier before running the node.
• Malformed JSON in Data: The Data property expects valid JSON. Invalid JSON syntax will cause parsing errors. Use the built-in JSON editor or validate your JSON before input.
• Insufficient Permissions: If the API token lacks permission to create records, the request will fail with an authorization error. Ensure the token has the required scopes.
• Empty Required Fields: Some objects may require certain attributes to be set. Omitting these may cause the API to reject the creation request.
• API Rate Limits: Excessive requests may trigger rate limiting. Implement retry logic or reduce request frequency if needed.

Links and References

• Attio API Documentation
• n8n HTTP Request Node Documentation
• JSON Validator – Useful for validating the JSON input in the Data property.