---
title: "Integrations - Asana"
url: "https://docs.unified.to/integrations/asana"
description: "Unified.to documentation"
---
##  Integration: Asana ![Asana](https://api.unified.to/docs/images/asana.png)

[Back to integrations](/integrations)

#### Overview

Company website:

<https://asana.com>

Integration launch date:

June 7, 2024

API Categories:

[Tasks](/task/overview)[Authentication](/auth/overview)[HR & Directory](/hris/overview)[Metadata](/metadata/overview)[File Storage](/storage/overview)[Passthrough](/passthrough/overview)

API Authorization:

 OAuth2 flow

#### STORAGE FILE

End-API object:

 file

Unified API Methods:

[Get](/storage/file/Retrieve%5Fa%5Ffile)[Remove](/storage/file/Remove%5Fa%5Ffile)

List options:

\-none-

Readable fields:

[download\_url](/storage/file/model)[id](/storage/file/model)[name](/storage/file/model)[type](/storage/file/model)

Writable fields:

[\-none-](/storage/file/model)

#### TASK COMMENT

End-API object:

 task\_story

Unified API Methods:

[List](/task/comment/List%5Fall%5Fcomments)[Get](/task/comment/Retrieve%5Fa%5Fcomment)[Create](/task/comment/Create%5Fa%5Fcomment)[Update](/task/comment/Update%5Fa%5Fcomment)[Remove](/task/comment/Remove%5Fa%5Fcomment)

Webhooks:

 Native

List options:

task\_idlimitoffset

 required filter 

Readable fields:

[created\_at](/task/comment/model)[id](/task/comment/model)[task\_id](/task/comment/model)[text](/task/comment/model)[user\_id](/task/comment/model)[user\_name](/task/comment/model)

Writable fields:

[task\_id](/task/comment/model)[text](/task/comment/model)

 required fields 

#### METADATA METADATA

End-API object:

 custom\_fields

Unified API Methods:

[List](/metadata/metadata/List%5Fall%5Fmetadatas)[Get](/metadata/metadata/Retrieve%5Fa%5Fmetadata)

List options:

\-none-

Readable fields:

[format](/metadata/metadata/model)[id](/metadata/metadata/model)[name](/metadata/metadata/model)[object\_type](/metadata/metadata/model)[original\_format](/metadata/metadata/model)[slug](/metadata/metadata/model)

Writable fields:

[\-none-](/metadata/metadata/model)

#### HRIS EMPLOYEE

End-API object:

 user

Unified API Methods:

[List](/hris/employee/List%5Fall%5Femployees)[Get](/hris/employee/Retrieve%5Fan%5Femployee)

List options:

query

Readable fields:

[emails](/hris/employee/model)[employee\_roles](/hris/employee/model)[first\_name](/hris/employee/model)[id](/hris/employee/model)[image\_url](/hris/employee/model)[last\_name](/hris/employee/model)[name](/hris/employee/model)

Writable fields:

[\-none-](/hris/employee/model)

#### HRIS GROUP

End-API object:

 team

Unified API Methods:

[List](/hris/group/List%5Fall%5Fgroups)[Get](/hris/group/Retrieve%5Fa%5Fgroup)[Create](/hris/group/Create%5Fa%5Fgroup)[Update](/hris/group/Update%5Fa%5Fgroup)

List options:

\-none-

Readable fields:

[description](/hris/group/model)[id](/hris/group/model)[name](/hris/group/model)[user\_ids](/hris/group/model)

Slow fields:

[user\_ids](/hris/group/model)

Writable fields:

[description](/hris/group/model)[name](/hris/group/model)[parent\_id](/hris/group/model)

#### TASK PROJECT

End-API object:

 workspace project section

Unified API Methods:

[List](/task/project/List%5Fall%5Fprojects)[Get](/task/project/Retrieve%5Fa%5Fproject)[Create](/task/project/Create%5Fa%5Fproject)[Update](/task/project/Update%5Fa%5Fproject)[Remove](/task/project/Remove%5Fa%5Fproject)

Webhooks:

 Virtual Native

List options:

limitoffsetparent\_id

Readable fields:

[created\_at](/task/project/model)[description](/task/project/model)[group\_ids](/task/project/model)[has\_children](/task/project/model)[has\_tasks](/task/project/model)[id](/task/project/model)[name](/task/project/model)[parent\_id](/task/project/model)[updated\_at](/task/project/model)[user\_ids](/task/project/model)

Slow fields:

[has\_tasks](/task/project/model)[has\_children](/task/project/model)

Writable fields:

[group\_ids](/task/project/model)[parent\_id](/task/project/model)[description](/task/project/model)[name](/task/project/model)[user\_ids](/task/project/model)

 required fields 

#### TASK TASK

End-API object:

 task

Unified API Methods:

[Get](/task/task/Retrieve%5Fa%5Ftask)[Create](/task/task/Create%5Fa%5Ftask)[Update](/task/task/Update%5Fa%5Ftask)[Remove](/task/task/Remove%5Fa%5Ftask)[List](/task/task/List%5Fall%5Ftasks)

Webhooks:

 Virtual Native

List options:

project\_idassigned\_user\_idlimitoffsetparent\_idupdated\_gteuser\_id

 required filter 

Readable fields:

[assigned\_user\_ids](/task/task/model)[attachment\_ids](/task/task/model)[completed\_at](/task/task/model)[created\_at](/task/task/model)[creator\_user\_id](/task/task/model)[due\_at](/task/task/model)[follower\_user\_ids](/task/task/model)[group\_ids](/task/task/model)[has\_children](/task/task/model)[id](/task/task/model)[name](/task/task/model)[notes](/task/task/model)[parent\_id](/task/task/model)[priority](/task/task/model)[project\_id](/task/task/model)[start\_at](/task/task/model)[status](/task/task/model)[story\_points](/task/task/model)[tags](/task/task/model)[time\_spent](/task/task/model)[time\_spent\_unit](/task/task/model)[type](/task/task/model)[updated\_at](/task/task/model)[url](/task/task/model)

Slow fields:

[group\_ids](/task/task/model)[attachment\_ids](/task/task/model)[has\_children](/task/task/model)

Writable fields:

[name](/task/task/model)[assigned\_user\_ids](/task/task/model)[completed\_at](/task/task/model)[due\_at](/task/task/model)[follower\_user\_ids](/task/task/model)[notes](/task/task/model)[parent\_id](/task/task/model)[project\_id](/task/task/model)[status](/task/task/model)[tags](/task/task/model)

 required fields 

#### PASSTHROUGH

Unified API Methods:

[POST](/passthrough/overview)[GET](/passthrough/overview)[PUT](/passthrough/overview)[DELETE](/passthrough/overview)

List options:

\-none-

Readable fields:

[\-none-](/passthrough/undefined/model)

Writable fields:

[\-none-](/passthrough/undefined/model)