Skip to main content
POST
/
v6
/
integrations
/
{id}
Save integration
curl --request POST \
  --url https://sandbox.tight.com/v6/integrations/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "status": "ACTIVE",
  "apiName": "BOX",
  "apiAccessToken": "<string>",
  "customData": {
    "internal_key": "some_internal_key",
    "some_other_field": 23434
  }
}
'
{
  "result": "SUCCESS",
  "data": {
    "id": "int_12345",
    "status": "ACTIVE",
    "apiName": "PLAID",
    "iconUrl": "https://cdn.sandbox.tight.com/icons/banks/56.png",
    "apiAccessToken": "<string>",
    "apiUsername": "<string>",
    "lastSyncedDate": "2023-12-25",
    "apiInstitutionId": "<string>",
    "apiInstitutionName": "<string>",
    "apiErrorType": "<string>",
    "apiErrorCode": "<string>"
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, see Authentication for more detail.

Path Parameters

​
id
string
required

The id of the integration

Body

application/json
​
status
enum<string>

Status of the integration

Available options:
ACTIVE,
INACTIVE,
REMOVED
Example:

"ACTIVE"

​
apiName
enum<string>

Name of the OAuth Provider

Available options:
BOX,
CLOVER,
STRIPE,
PLAID,
KNOX,
UBER,
FRESHBOOKS,
HARVEST,
KW,
FRESHBOOKS2,
CAPITAL_ONE,
SQUARE,
DOTLOOP,
REALOGY,
UPWORK,
SHOPIFY,
DEDUCTR,
ENTERPRISE,
MOXIWORKS,
APPDIRECT,
LONEWOLF,
LONEWOLF_TRANSACTIONDESK,
SAMPLE_BANK,
TAXBOT,
GUSTO,
XERO,
UNIT,
MOOV,
QBO,
QUALPAY,
BENCH,
PARTNER_IMPLEMENTATION,
CHECK,
RUTTER,
WAVE,
MANUAL_ENTRY,
CSV_IMPORT,
ADYEN
​
apiAccessToken
string

Access token of the integration

​
customData
object

Custom JSON in which you can store any data with max length of 2000 characters

Example:
{
  "internal_key": "some_internal_key",
  "some_other_field": 23434
}

Response

Success

​
result
enum<string>

The result of the action performed.

Available options:
SUCCESS,
FAILURE
​
data
object

The data generated by the action performed.