Skip to main content
POST
Create tag

Authorizations

Authorization
string
header
required

API key prefixed with finta_

Body

application/json
name
string
required

Up to 32 characters using letters, numbers, spaces and hyphens, with at least one letter or number. Leading and trailing spaces are removed and repeated spaces are collapsed. Names are unique ignoring case; "Other" is reserved in any letter case.

Required string length: 1 - 32

Response

The created tag with counts

id
string
required
Pattern: ^tag_
object
enum<string>
required
Available options:
tag
name
string
required
transaction_count
integer | null
required

Visible transactions carrying this tag. Null without Transactions View.

vendor_count
integer | null
required

Distinct vendors on visible transactions. Null without Transactions View.

vendor_names
string[] | null
required

Top five vendors by transaction count. Null without Transactions View.

Maximum array length: 5