---
title: "Import a partner-supplied OAuth connection"
method: POST
path: "/integrations/{integration}/connection"
tags: ["Integrations"]
---

# Import a partner-supplied OAuth connection

`POST /integrations/{integration}/connection`

Register a QuickBooks or Xero connection using OAuth tokens the partner obtained directly from the provider. Pair with the partner integration credentials configured by support.

## Path parameters

- `integration` string, required

## Request body

- object
  - `business_entity_id` string, required
  - `access_token` string, required — OAuth access token issued by the partner's QBO/Xero app for the customer.
  - `access_token_expires_in` number, required — Lifetime of the access token, in seconds.
  - `refresh_token` string, required — Long-lived refresh token paired with the access token.
  - `refresh_token_expires_in` number, required — Lifetime of the refresh token, in seconds.
  - `realm_id` string — QuickBooks company id (QBO `realmId`). Required for QuickBooks, ignored for Xero.

## Response `200`

OK

- object
  - `id` string — The unique identifier of the object in Nmbr.
  - `object` string — The type of the object in Nmbr (`"integration"`).
  - `data` Integration
    - `label` string, nullable
    - `is_enabled` boolean
    - `type` string, nullable

---

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