Attio icon

Attio

Interact with Attio API
Join our community

Actions52

Overview

This node interacts with the Attio API to list tasks based on various filtering and sorting criteria. It is useful for workflows that need to retrieve task data from Attio, such as project management automation, reporting on task statuses, or syncing tasks with other systems.

Typical use cases include:

  • Fetching a paginated list of tasks assigned to specific workspace members.
  • Filtering tasks linked to particular records (e.g., people or companies).
  • Sorting tasks by creation date to get the newest or oldest tasks first.
  • Retrieving only completed or only incomplete tasks for status tracking.

For example, you could use this node to get the 10 most recent incomplete tasks assigned to a certain user or to list all tasks linked to a specific contact record.

Properties

Name Meaning
Limit The maximum number of task results to return. Defaults to 10 in this node but can be set up to 500. Controls pagination size.
Offset The number of task results to skip before starting to return results. Useful for paginating through large result sets. Defaults to 5 here.
Sort How to sort the returned tasks by creation date. Options are "Created At Asc" (oldest first) or "Created At Desc" (newest first). Defaults to "Created At Desc".
Linked Object Filter tasks to only those linked to a specific object type in their linked records property. For example, "people" to filter tasks linked to person records. Must be used together with Linked Record Id.
Linked Record Id Filter tasks to only those linked to a specific record ID in their linked records property. Must be used together with Linked Object.
Assignee Filter tasks by assignee, specified by workspace member email or ID. Passing an empty value or "null" returns tasks with no assignee.
Is Completed Filter tasks by completion status. Set to true to return only completed tasks, false for only incomplete tasks, or leave unset to return both. Defaults to true.

Output

The node outputs an array of JSON objects representing tasks retrieved from the Attio API. Each item corresponds to one task and contains all task properties as returned by the API, including metadata like creation date, linked records, assignee information, and completion status.

No binary data output is produced by this node.

Example output structure snippet (simplified):

[
  {
    "id": "task-id-123",
    "title": "Follow up with client",
    "created_at": "2024-01-01T12:00:00Z",
    "is_completed": false,
    "assignee": {
      "id": "user-id-456",
      "email": "user@example.com"
    },
    "linked_records": [
      {
        "object": "people",
        "record_id": "person-id-789"
      }
    ],
    ...
  }
]

Dependencies

  • Requires an API key credential for authenticating with the Attio API.
  • The node makes HTTP requests to the Attio REST API endpoint https://api.attio.com/v2/tasks.
  • No additional external dependencies beyond the n8n core and the configured API credential.

Troubleshooting

  • Common issues:

    • Missing or invalid API credentials will cause authentication errors.
    • Providing only one of linked_object or linked_record_id without the other will likely result in an API error or no results.
    • Pagination parameters (limit and offset) must be used carefully to avoid missing or duplicating tasks when iterating through pages.
    • Filtering by assignee requires correct email or ID; incorrect values may return empty results.

  • Error messages:

    • Authentication errors: Check that the API key credential is correctly configured and has necessary permissions.
    • Operation not found errors: Ensure the selected resource is "Tasks" and operation is "List Tasks".
    • Parameter validation errors: Verify that required paired parameters like linked_object and linked_record_id are both provided if filtering by linked records.

Links and References

Discussion