Asana

This connector captures data from Asana's REST API.

Supported data resources

The following data resources are supported through the Asana APIs:

Default Streams

• Attachments
• Attachments (Compact)
• Custom Fields
• Events
• Portfolios
• Portfolios (Compact)
• Portfolios Memberships
• Projects
• Sections
• Sections (Compact)
• Stories
• Stories (Compact)
• Tags
• Tasks
• Team Memberships
• Teams
• Users
• Workspaces

Streams Available for Enterprise+ Organizations

• Organization Exports (available for service accounts)

By default, each resource is mapped to an Estuary collection through a separate binding.

Prerequisites

You will need an Asana account.

You can authenticate your account with Estuary either via OAuth or using an Asana personal access token.

Configuration

You configure connectors either in the Estuary web app, or by directly editing the catalog specification file. See connectors to learn more about using connectors. The values and specification sample below provide configuration details specific to the Asana source connector.

Properties

Endpoint

Property	Title	Description	Type	Required/Default
/credentials	Credentials		object	Required
/credentials/option_title	Credentials Title	Denotes the authentication type. Can either be OAuth Credentials or PAT Credentials.	string
/credentials/client_id	Client ID	The client ID for Asana OAuth.	string	Required when using the OAuth Credentials option
/credentials/client_secret	Client Secret	The client secret for Asana OAuth.	string	Required when using the OAuth Credentials option
/credentials/refresh_token	Refresh Token	The refresh token for Asana OAuth.	string	Required when using the OAuth Credentials option
/credentials/personal_access_token	Personal Access Token	The access token to authenticate with the Asana API.	string	Required when using the PAT Credentials option

Bindings

Property	Title	Description	Type	Required/Default
/stream	Stream	Asana resource from which collections are captured.	string	Required
/syncMode	Sync Mode	Connection method.	string	Required

Sample

captures:
  ${PREFIX}/${CAPTURE_NAME}:
    endpoint:
      connector:
        image: ghcr.io/estuary/source-asana:v1
        config:
          credentials:
            option_title: PAT Credentials
            personal_access_token: <secret>
    bindings:
      - resource:
          stream: attachments
          syncMode: full_refresh
        target: ${PREFIX}/attachments
      {...}