Skip to main content
POST
/
v0
/
business
/
{business_id}
/
task
Create a Task for a Business
curl --request POST \
  --url https://api.sandbox.getasset.com/v0/business/{business_id}/task \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "description": "<string>",
  "task_type": "reconnect_account",
  "transaction_id": "txn_WQMDNUHpBThYSNh4AprDBo",
  "external_account_id": "eac_WQMDNUHpBThYSNh4AprDBo",
  "month": "2025-01",
  "metadata": {
    "date_from": "2024-12-31",
    "date_to": "2025-01-13"
  }
}
'
{
  "data": {
    "business_id": "<string>",
    "status": "pending",
    "task_type": "reconnect_account",
    "id": "<string>",
    "description": "ABC Business Checking",
    "first_requested_at": "2023-11-07T05:31:56Z",
    "last_requested_at": "2023-11-07T05:31:56Z",
    "month": "2025-01"
  }
}

Authorizations

​
Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

​
business_id
string<biz_string>
required

The id of the business

Example:

"biz_GA6EG2qFxA97NZHtxeLPUy"

Body

application/json
​
description
string
required

The task description

Example:

"Please upload the bank statement for January"

​
task_type
enum<string>
required

The task type to use when creating the task

Available options:
reconnect_account,
categorize_transaction,
review_personal_transaction,
other,
request_receipt,
request_statement,
request_other_document,
request_payroll,
review_transactions
Example:

"request_statement"

​
transaction_id
string<txn_string> | null

The id of the transaction for which a receipt is requested

Example:

"txn_WQMDNUHpBThYSNh4AprDBo"

​
external_account_id
string<eac_string> | null

The id of the External Account for which a statement is requested

Example:

"eac_WQMDNUHpBThYSNh4AprDBo"

​
month
string | null

The month associated with the task in YYYY-MM format.

Maximum string length: 7
Example:

"2025-01"

​
metadata
Metadata · object

Task-specific metadata

Example:
{
  "date_from": "2024-12-31",
  "date_to": "2025-01-13"
}

Response

Successful Response

​
data
TaskPublic · object
required