Reconnecting Marketplace Apps Using the Reconnect API

If a connection to a Marketplace App becomes broken, for example due to a lost or expired access token, you can use the Reconnect API to restore the authorization. This process generates a new authorization code that can be used with the standard OAuth flow to obtain fresh access and refresh tokens, allowing you to re-establish the connection without requiring action from your end users.

Making the Reconnect API Request

The API endpoint for reconnection is . You must send a POST request with a JSON payload in the body. The required headers and data differ depending on whether you are reconnecting an app for a sub-account (location) or an agency-level installation.

For Sub-Account (Location) App Connections

Use the following structure for your request. Replace the placeholder values with your actual application credentials and the specific location ID where the app was originally installed.

• URL:
• Header: Content-Type: application/json
• Data Payload:
  {
    "clientKey": "<client_id>",
    "clientSecret": "<client_secret>",
    "locationId": "<locationID where the app was installed>"
  }

For Agency-Level App Connections

For apps installed at the agency level, use this structure. Provide your client credentials and the company ID for the agency.

• URL:
• Header: Content-Type: application/json
• Data Payload:
  {
    "clientKey": "<client_id>",
    "clientSecret": "<client_secret>",
    "companyId": "<company where the app was installed>"
  }

API Response

A successful API call will return a JSON response containing the new authorization code and its expiration time.

• authorizationCode: The new code to be used in the OAuth token exchange.
• expiresAt: The date and time when this authorization code will expire.
• traceId: A unique identifier for the request, useful for troubleshooting.

Important: For official support regarding API-related issues or broken Marketplace Apps, please visit the developer documentation site at