---
title: Provider compatibility matrix
description: Generated from package manifests, exported provider-version policies, and Ads Sync image pins.
---

Each row is one independently executable surface. A direct connector talks to the provider with the package's own adapter, so its default API target comes from the package's exported provider-version policy. An Ads Sync surface runs a pinned Airbyte image, so its provider API is whatever that image implements. The two never imply each other: upgrading a direct connector does not move an Ads Sync row, and an image upgrade does not move a direct row.

Column meanings:

- **Patronage package** is the package name and current manifest version.
- **Upstream implementation** is the direct adapter or the exact image reference.
- **Default API target** is the provider endpoint or version selected when a caller passes nothing. For an image it is the effective provider API established from an upstream primary source, recorded as compatibility metadata rather than an operator option.
- **Tested target** is the version string or immutable image digest that repository tests exercise.
- **Override behavior** says whether a caller can pick another provider version and what that does and does not promise.
- **Upstream sunset/review deadline** and **Last verified** are time-sensitive metadata. They record the upstream lifecycle facts as checked on the stated date and go stale on their own; regenerate this page after re-checking the linked sources.

`not applicable` marks a column that has no meaning for that surface. It is never omitted silently.

| Surface | Patronage package | Upstream implementation | Default API target | Tested target | Override behavior | Upstream sunset/review deadline | Last verified |
| --- | --- | --- | --- | --- | --- | --- | --- |
| Google Ads (direct) | `@patronage/google-ads` 0.1.0 | Direct adapter over `fetch` | Google Ads API `v24` | `v24` in 5 package test files | Callers may set `apiVersion`. Overrides are sent unchanged so the provider rejects unsupported versions; an accepted override is not a support claim. | Google's published sunset schedule lists `v24` for May 2027. Review before each public release. Source: https://developers.google.com/google-ads/api/docs/sunset-dates | 2026-09-16 |
| Google Ads through Ads Sync | `@patronage/ads-sync` 0.3.0 | Airbyte image `airbyte/source-google-ads:6.1.0` | Google Ads API `v23`, per the upstream changelog entry for 5.0.0 (upgrade from `v20` to `v23`) with no later API bump through 6.1.0. Compatibility metadata, not an operator option. Source: https://github.com/airbytehq/airbyte/blob/master/docs/integrations/sources/google-ads.md#changelog | Image digest `sha256:dea39deedba0a095f60159d808dfb47fa778e304846396d2ab2f04c951b480ed` in 3 package test files | not applicable: the image pin is the only selector, and the run adapter rejects any other image | Google's published sunset schedule lists `v23` for February 2027. | 2026-09-16 |
| Meta Ads (direct) | `@patronage/meta-ads` 0.1.0 | Direct adapter over `fetch` | Marketing API (Graph API endpoint) `v25.0` | `v25.0` in 3 package test files | Callers may set `apiVersion`. Overrides are sent unchanged so the provider rejects unsupported versions; an accepted override is not a support claim. | Meta has not published a Marketing API `v25.0` sunset date. Review before each public release. Source: https://developers.facebook.com/docs/graph-api/changelog/ | 2026-09-16 |
| Meta Ads through Ads Sync | `@patronage/ads-sync` 0.3.0 | Airbyte image `airbyte/source-facebook-marketing:5.2.11` | Marketing API `v23.0`, derived from the bundled `facebook-business` SDK 23.0.3 in the upstream changelog for 5.2.11; upstream bumped that SDK in 5.2.12 ahead of the `v23.0` sunset. Compatibility metadata, not an operator option. Source: https://github.com/airbytehq/airbyte/blob/master/docs/integrations/sources/facebook-marketing.md#changelog | Image digest `sha256:4d6c916b29862ded4b5b94feea0b8ef75899f34c364e4884312e50414b6d447c` in 2 package test files | not applicable: the image pin is the only selector, and the run adapter rejects any other image | Meta sunset Marketing API `v23.0` on 2026-06-09, which has passed. The pin stays unchanged until requalified. | 2026-09-16 |
| Google Search Console through Ads Sync | `@patronage/ads-sync` 0.3.0 | Airbyte image `airbyte/source-google-search-console:2.1.9` | Search Console API `webmasters/v3`, per the upstream stream documentation. Compatibility metadata, not an operator option. Source: https://github.com/airbytehq/airbyte/blob/master/docs/integrations/sources/google-search-console.md | Image digest `sha256:3ee78d227a25ec01a31b9f131b1b8d80afd6e3aaf0c0c2f1b09c7973190465b3` in 1 package test file | not applicable: the image pin is the only selector, and the run adapter rejects any other image | Google has not published a Search Console API `v3` sunset. Review with the image pin. | 2026-09-16 |
| Ads Sync warehouse destination | `@patronage/ads-sync` 0.3.0 | Airbyte image `airbyte/destination-postgres:3.0.13` | not applicable: writes to operator-owned Postgres, not to a marketing provider. Compatibility metadata, not an operator option. Source: https://github.com/airbytehq/airbyte/blob/master/docs/integrations/destinations/postgres.md | Image digest `sha256:0b310bd46ba0e006757ea3dc1d3b8ef8e3bcf51c3a96f5460a836653b5ac4f4c` in 2 package test files | not applicable: the image pin is the only selector, and the run adapter rejects any other image | not applicable | 2026-09-16 |
| LinkedIn Ads (direct) | `@patronage/linkedin-ads` 0.1.0 | Direct adapter over `fetch` | Marketing API `LinkedIn-Version` `202608` | `202608` in 5 package test files | Callers may set `apiVersion`. Overrides are sent unchanged so LinkedIn rejects sunset versions; an accepted override is not a support claim. | LinkedIn supports each monthly Marketing API version for at least one year, so `202608` is supported until at least August 2027. Review before each public release. Source: https://learn.microsoft.com/en-us/linkedin/marketing/versioning | 2026-09-16 |
| Meta Social (direct) | `@patronage/meta-social` 0.0.0 | Direct adapter over `fetch` | Graph API `v25.0` | `v25.0` in 1 package test file | Callers may set `apiVersion`. Overrides are sent unchanged so the provider rejects unsupported versions; an accepted override is not a support claim. | Meta's changelog lists Graph API `v25.0` as available until 2028-07-29. Review before each public release. Source: https://developers.facebook.com/docs/graph-api/changelog/ | 2026-09-16 |
| Reddit Ads (direct) | `@patronage/reddit-ads` 0.1.0 | Direct adapter over `fetch` | Reddit Ads API path `v3` | `v3` in 1 package test file | Callers may set `apiBaseUrl`, which replaces the whole base URL and is not a provider-version policy; an accepted override is not a support claim. | No published sunset. Review before each public release. Source: https://ads-api.reddit.com/docs/v3/ | 2026-09-16 |
| TikTok Ads (direct) | `@patronage/tiktok-ads` 0.1.0 | Direct adapter over `fetch` | TikTok Business API `v1.3` | `v1.3` in 1 package test file | Callers may set `apiVersion`. Overrides are sent unchanged so TikTok rejects unsupported versions; an accepted override is not a support claim. | No published sunset. Review before each public release. Source: https://business-api.tiktok.com/portal/docs | 2026-09-16 |
| X posts (direct) | `@patronage/x-posts` 0.0.0 | Direct adapter over `fetch` | X API path `v2` | `v2` in 5 package test files | not applicable: no version option; requests address the versioned path directly | No published sunset. Review before each public release. Source: https://docs.x.com/x-api/introduction | 2026-09-16 |
| X posts through xAI Grok (direct) | `@patronage/x-posts` 0.0.0 | Direct adapter over `fetch` | xAI API path `v1` | `v1` in 1 package test file | not applicable: no version option; requests address the versioned path directly | No published sunset. Review before each public release. Source: https://docs.x.ai/docs/api-reference | 2026-09-16 |
| DataForSEO (direct) | `@paitronage/dataforseo` 0.1.0 (private) | Direct adapter over `fetch` | DataForSEO API path `v3` | `v3` in 5 package test files | not applicable: no version option; requests address the versioned path directly | No published sunset. Review before each public release. Source: https://docs.dataforseo.com/v3/ | 2026-09-16 |
| Connector lifecycle | `@patronage/connector-lifecycle` 0.1.0 | not applicable | not applicable: no provider API | not applicable: receipt and resume contracts are provider-neutral | not applicable | not applicable | 2026-09-16 |

## How this page is generated

- Package versions come from each package manifest.
- Direct defaults come from the exported provider-version policies and constants on each package's declared entry point: `GOOGLE_ADS_API_VERSION_POLICY`, `META_GRAPH_API_VERSION_POLICY` (Meta Ads and Meta Social), `DEFAULT_LINKEDIN_MARKETING_API_VERSION`, `DEFAULT_TIKTOK_API_VERSION`, and `DEFAULT_REDDIT_ADS_API_BASE_URL`. X, xAI, and DataForSEO path versions are scanned from each package's source because those packages pin a versioned URL rather than exporting a version policy.
- Ads Sync image pins come from `supportedImageVersions` exported by `@patronage/ads-sync`, digest included.
- Tested targets are checked by scanning each package's test files for the exact default target string.
- Lifecycle facts and each image's effective provider API are keyed by the exact default version or image pin they describe. Changing a default or a pin without re-verifying the upstream source fails `reference:check`.

Google REST targets use the major endpoint form (`v24`, `v25`). Google applies compatible minor releases such as `v25.1` to the existing major endpoint, so a minor release never appears here as a separate target.

See the [supported connector surface](/reference/supported-surface) for entry points and behavior boundaries.