---
title: "Create a data refresh task"
method: POST
path: "/v1/refresh/tasks/"
tags: ["Data Refresh"]
---

# Create a data refresh task

`POST /v1/refresh/tasks/`

The endpoint creates a link data refresh task.

## Request body

- RefreshTaskCreateRequest — Refresh Link data task
  - `access_token` string, required — Access token for a Link to payroll provider
  - `account` object — Bank account info. Used for [Paycheck Linked Loans](#paycheck-linked-loans)
    - `account_number` string — Account number
    - `account_type` 'checking' | 'savings' — Account type: * `checking` - Checking account, * `savings` - Savings account
    - `routing_number` string — Routing number
    - `bank_name` string — Bank name
    - `deposit_type` 'entire' | 'percent' | 'amount' — Deposit type: * `entire` - Entire paycheck, * `percent` - Percentage of the paycheck, * `amount` - Fixed amount from the paycheck
    - `deposit_value` string — Deposit value
  - `product_type` 'income' | 'employment' | 'deposit_switch' | 'pll' | 'insurance' | 'transactions' | 'assets', required — Indicates the type of product to use: * `employment` - Employment verification, * `income` - Income and Employment verification, * `deposit_switch` - Direct deposit switch, * `pll` - Paycheck linked lending, * `insurance` - Insurance verification, * `transactions` - Financial account aggregation, * `assets` - Assets verification,
  - `request_extended_history` boolean — When `true`, this refresh pulls the full transaction-history window (730 days) instead of the 90-day default. Applies only to refreshes of connected financial accounts. By default every refresh uses the shallow 90-day window, regardless of how much history the original connection pulled — set this flag on each refresh that needs the full window.

## Response `201`

- RefreshTaskCreateResponse — Response for refresh task creation endpoint.
  - `task_id` string, required — Unique ID for the `Link` data refresh task

## Other responses

- `400` — HTTP 400 Bad Request
- `401` — HTTP 401 Unauthorized
- `403` — HTTP 403 Forbidden
- `429` — HTTP 429 Too Many Requests

---

[API](https://skmtc.net/truv/apis/truv-api.md) · [All operations](https://skmtc.net/truv/apis/truv-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/truv/truv-api/versions/6542a8962887/schema)