Provider compatibility matrix
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, andDEFAULT_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
supportedImageVersionsexported 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 for entry points and behavior boundaries.