> ## Documentation Index
> Fetch the complete documentation index at: https://docs.catenatelematics.com/llms.txt
> Use this file to discover all available pages before exploring further.

# v2.76.0 - Zubie Credential Schema Update

> Zubie credentials now require client_id and client_secret instead of redirect_uri across all connections and TMS-connections endpoints

**Released 23rd September 2026**

<Warning>
  **This release includes a breaking change:** `redirect_uri` has been removed from the Zubie credentials schema and replaced by the required fields `client_id` and `client_secret`. See [Zubie credential changes](#zubie-credential-changes) below.
</Warning>

## Zubie credential changes

The `ZubieCreds` schema has been updated to reflect how Zubie's token exchange actually works. Zubie's own API does not use a `redirect_uri` in its token exchange flow, so that field has been removed. In its place, `client_id` and `client_secret` are now required fields.

### Schema changes

| Field | Before | After |
| - | - | - |
| `redirect_uri` | Required string | Removed |
| `client_id` | Not present | Required string |
| `client_secret` | Not present | Required string |

### Affected endpoints

All connections and TMS-connections endpoints that accept or return Zubie credentials are affected:

* `GET /v2/integrations/connections`
* `POST /v2/integrations/connections`
* `GET /v2/integrations/connections/{connection_id}`
* `PATCH /v2/integrations/connections/{connection_id}`
* `GET /v2/integrations/tms-connections`
* `POST /v2/integrations/tms-connections`
* `GET /v2/integrations/tms-connections/{tms_connection_id}`
* `PATCH /v2/integrations/tms-connections/{tms_connection_id}`

### Migration

**Before:**

```json theme={null}
{
  "credentials": {
    "provider": "zubie",
    "redirect_uri": "https://your-app.example.com/callback",
    "api_key": "your-api-key"
  }
}
```

**After:**

```json theme={null}
{
  "credentials": {
    "provider": "zubie",
    "client_id": "your-client-id",
    "client_secret": "your-client-secret",
    "api_key": "your-api-key"
  }
}
```

### Migration checklist

<Steps>
  <Step title="Remove redirect_uri from Zubie credential payloads">
    Search your codebase for any request bodies that include `redirect_uri` alongside a Zubie provider credential and remove that field.
  </Step>

  <Step title="Add client_id and client_secret to Zubie credential payloads">
    Update your Zubie credential objects to include the required `client_id` and `client_secret` fields.
  </Step>

  <Step title="Update response parsing">
    If your code reads or stores `redirect_uri` from Zubie credential responses, remove that logic. Update any code that reads credentials to handle `client_id` and `client_secret` instead.
  </Step>

  <Step title="Update stored schemas or validation">
    If you validate Zubie credential objects against a local schema or type definition, remove `redirect_uri` and add `client_id` and `client_secret` as required fields.
  </Step>
</Steps>

***

## Need help?

<CardGroup cols={2}>
  <Card title="API reference" icon="book" href="/api-reference/integrations-api">
    View complete endpoint documentation for the Integrations API
  </Card>

  <Card title="Contact support" icon="life-ring" href="mailto:support@catenaclearing.io">
    Questions about this release? Our team is here to help
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.