iotoms Docs

Disconnect an accounting connector

POST
/api/v1/integrations/accounting/connectors/{provider}/disconnect

Disconnects the accounting system for your account: the stored access is revoked where the provider allows it and then deleted.

How to use it

  1. Disconnect the connector by its provider slug.
  2. Stored access is revoked with the provider where possible and deleted; status becomes NOT_CONNECTED and settings are removed.
  3. To reconnect, start again with Start connecting an accounting system.

Authorization

BearerAuth
headerAuthorizationBearer <JWT>

Path Parameters

provider*string

Accounting connector slug, for example zoho-books (from List accounting connectors).

Header Parameters

Response Body

OK

*/*
  1. response
status*string

Outcome of the request: SUCCESS when it worked; errors return an error status with the reason in message.

message*string

Short human-readable message describing the outcome.

data?

Confirmation that the connector is now disconnected.

Example Request
curl -X POST 'https://beta.iotoms.com/api/v1/integrations/accounting/connectors/string/disconnect'
Example Response
{  "status": "string",  "message": "string",  "data": {    "provider": "string",    "connectionStatus": "NOT_CONNECTED",    "disconnectedAt": "2019-08-24T14:15:22Z"  }}