Link represents a connection to a user's account.
Each Link has an ID and access_token which can be used to retrieve data from a user's account. Both Link ID and the access token can be retrieved by exchanging the public_token received from the callbacks in the Truv Bridge.
An access token is used to perform the most sensitive operations, like report generation.
Link Attributes
The attributes of the Link:
Attribute | Type | Description |
---|---|---|
id | string | Unique ID of the Link |
created_at | string | Timestamp when the Link was created (ISO 8601) |
updated_at | string | Timestamp when the Link was last updated (ISO 8601) |
tracking_info | string | Optional tracking information provided by a partner |
status | string | Status of the last Task related to the account Link |
user_external_id | bool | The external ID of the user provided by a partner |
provider_id | string | Data provider ID |
link_hash | string | Unique hash for the user credentials used to create the link |
Endpoints
Available endpoint list for Orders:
Endpoint |
---|
Get Link - GET /links/{id} |
List Links- GET /links/ |
Get Link Token - POST /link-access-tokens/ |
Delete Link - DELETE /link/{id}/ |
Sample Object
Example object returned by the Get Link
Endpoint:
{
"id": "48427a36d43c4d5aa6324bc06c692456",
"created_at": "2022-06-07T15:00:00Z",
"updated_at": "2022-06-31T15:00:00Z",
"tracking_info": "user123456",
"status": "new",
"user_external_id": "user123456",
"provider_id": "adp",
"link_hash": "bc917458a3da4b2c8cc8282aa1707aaa"
}