# Integrations

Section: Team settings. Part of the [API reference](https://developer.yoprint.com/reference.md). Web page: https://developer.yoprint.com/reference/integrations/

This page and all 16 operation pages, in 3 files: https://developer.yoprint.com/llms/integrations.txt (operations 1 to 6), https://developer.yoprint.com/llms/integrations-2.txt (operations 7 to 9), https://developer.yoprint.com/llms/integrations-3.txt (operations 10 to 16)

Connections to suppliers, Twilio, GoShippo, QuickBooks Online, Square and Shopify.

## Operations (11)

- [List integrations](https://developer.yoprint.com/reference/integrations/v1-external-integration-index.md): `GET /v1/api/store/{team_slug}/setting/external_integration`. Returns the team's integrations: suppliers, Twilio, GoShippo, QuickBooks Online, Square and Shopify.
- [List an integration's error log](https://developer.yoprint.com/reference/integrations/v1-external-integration-logs.md): `GET /v1/api/store/{team_slug}/setting/external_integration/{id}/logs`. Returns the sync errors an integration recorded, newest first, a page at a time (the team's page size).
- [Search integrations](https://developer.yoprint.com/reference/integrations/v1-external-integration-filter.md): `POST /v1/api/store/{team_slug}/setting/external_integration/filter`. Returns the team's integrations that match `filters`, a page at a time (the team's page size, 50 by default).
- [Get an integration](https://developer.yoprint.com/reference/integrations/v1-external-integration-show.md): `GET /v1/api/store/{team_slug}/setting/external_integration/{external_integration_reference}`. Returns one integration with its settings.
- [Read data from an integration's provider](https://developer.yoprint.com/reference/integrations/v1-external-integration-data.md): `PUT /v1/api/store/{team_slug}/setting/external_integration/{id}/data`. Reads live data from the provider through the integration.
- [Connect an integration](https://developer.yoprint.com/reference/integrations/v1-external-integration-store.md): `POST /v1/api/store/{team_slug}/setting/external_integration/{external_integration_reference}`. Connects an integration.
- [Update an integration](https://developer.yoprint.com/reference/integrations/v1-external-integration-update-put.md): `PUT /v1/api/store/{team_slug}/setting/external_integration/{external_integration_reference}`. Changes an integration's settings or credentials.
- [Update an integration (same as PUT)](https://developer.yoprint.com/reference/integrations/v1-external-integration-update-patch.md): `PATCH /v1/api/store/{team_slug}/setting/external_integration/{external_integration_reference}`. Changes an integration's settings or credentials.
- [Disconnect an integration](https://developer.yoprint.com/reference/integrations/v1-external-integration-destroy.md): `DELETE /v1/api/store/{team_slug}/setting/external_integration/{external_integration_reference}`. Disconnects an integration.
- [Run an integration action](https://developer.yoprint.com/reference/integrations/v1-external-integration-action.md): `PUT /v1/api/store/{team_slug}/setting/external_integration/{id}/action`. Runs a one-off action on an integration.
- [Restore a removed Shopify store](https://developer.yoprint.com/reference/integrations/v1-external-integration-restore.md): `PATCH /v1/api/store/{team_slug}/setting/external_integration/{id}/restore`. Brings back a removed Shopify store connection and turns it on again.

## Legacy and internal operations (5)

Prefer the operations above. Legacy ones name their replacement; internal ones are built for YoPrint's own apps.

- [Search QuickBooks, or sync records to it](https://developer.yoprint.com/reference/integrations/v1-external-integration-public-action.md): `PUT /v1/api/store/{team_slug}/setting/external_integration/{id}/public_action` (internal: built for YoPrint's own apps, don't build on it). Built for YoPrint's web app, which uses it to link YoPrint records to QuickBooks Online and to push them there.
- [Read Shopify orders through the integration](https://developer.yoprint.com/reference/integrations/v1-external-integration-proxy-request.md): `PUT /v1/api/store/{team_slug}/setting/external_integration/{id}/proxy_request` (internal: built for YoPrint's own apps, don't build on it). Built for YoPrint's web app, to browse orders in a connected Shopify store before importing them.
- [Check a Shopify install signature](https://developer.yoprint.com/reference/integrations/v1-external-integration-shopify-verify-signature.md): `POST /v1/api/store/{team_slug}/setting/external_integration/shopify/verify-signature` (internal: built for YoPrint's own apps, don't build on it). Built for YoPrint's web app, during a Shopify install that starts from the Shopify admin.
- [Retry a logged integration error](https://developer.yoprint.com/reference/integrations/v1-external-integration-retry-action.md): `PATCH /v1/api/store/{team_slug}/setting/external_integration/retry_action/{id}` (internal: built for YoPrint's own apps, don't build on it). Asks YoPrint to retry the step behind one error log entry.
- [Finish a Shopify install](https://developer.yoprint.com/reference/integrations/v1-external-integration-shopify-finalize-install.md): `POST /v1/api/store/{team_slug}/setting/external_integration/shopify/finalize-install` (internal: built for YoPrint's own apps, don't build on it). Built for YoPrint's web app.
