Skip to main content
POST
Complete inbox item

Authorizations

Authorization
string
header
required

API key prefixed with finta_

Path Parameters

id
string
required

The inbox item's id from GET /inbox.

Response

The completed item.

id
string
required

Unique identifier, prefixed inb_.

Example:

"inb_3f2a9c1e7b4d4e0f9a6c2b8d1e5f7a90"

object
enum<string>
required
Available options:
inbox_item
type
enum<string>
required

What Finta is asking for. connect_integration: connect a provider Finta found the company uses. reconnect_integration: a connection's data stopped updating until someone signs in to the provider again. grant_access: invite Finta as a user in the provider's own app, for data its sign-in connection doesn't include. categorize_transactions: approved transactions have no category. upload_tax_return: Finta needs to know whether a tax year is filed. sign_tax_draft: a draft tax return is ready to review and sign. provide_delaware_ach: Finta needs ACH details to pay the Delaware franchise tax. start_tax_onboarding: a tax year is open for Finta to file. New values may be added.

Available options:
connect_integration,
reconnect_integration,
grant_access,
categorize_transactions,
upload_tax_return,
sign_tax_draft,
provide_delaware_ach,
start_tax_onboarding
status
enum<string>
required

open in the list; completed once the item is done.

Available options:
open,
completed
title
string
required

The item's title as the Finta inbox shows it, with its specifics, such as the bank's name or the tax year. An open categorize_transactions item's count is recounted on every request.

Example:

"Grant access for Mercury Treasury"

instructions
string
required

What to do about the item. When a Finta skill covers it, the skill to run. Otherwise the inbox's own text, and that the user does it in the Finta web app, at url.

Example:

"Get the grant-access-mercury skill and run it, then mark this item complete."

url
string<uri>
required

Where the user does it in the Finta web app.

created
integer
required

When Finta added the item, in Unix seconds.