Google Business Platform posts now support EVENT and OFFER types via topicType in GoogleBusinessPlatformData.

This lets you publish event and offer posts (in addition to standard updates) to Google Search/Maps/GBP.

Set topicType to: STANDARD | EVENT | OFFER (default: STANDARD)

When topicType is EVENT, include event (required): event.title, event.schedule.startDate, event.schedule.endDate (optional: startTime, endTime).

When topicType is OFFER, include offer (recommended): offer.offerType (OFFER | BUY_ONE_GET_ONE), offer.redeemOnlineUrl, offer.termsConditions, offer.couponCode.

View documentation

New Google Business Profile (GBP) capabilities are available: manage Services, update Place Action links, and fetch Reviews across multiple locations in one call.

Manage location services:
• GET /v1/accounts/{accountId}/gmb-services (optional locationId)
• PUT /v1/accounts/{accountId}/gmb-services replaces the full list via serviceItems (structured or free-form, optional price)

Update a Place Action link:
• PATCH /v1/accounts/{accountId}/gmb-place-actions with name (required), and optionally uri and/or placeActionType
• placeActionType: APPOINTMENT, ONLINE_APPOINTMENT, DINING_RESERVATION, FOOD_ORDERING, FOOD_DELIVERY, FOOD_TAKEOUT, SHOP_ONLINE

Batch fetch reviews for multi-location accounts:
• POST /v1/accounts/{accountId}/gmb-reviews/batch with locationNames, optional pageSize (max 50) and pageToken

View documentation

Webhooks now support review events via events: review.new, review.updated (in POST /v1/webhooks/settings and PUT /v1/webhooks/settings).

Sending inbox messages now supports WhatsApp rich interactive messages via interactive in POST /v1/inbox/conversations/{conversationId}/messages.

Set interactive.type to: list, cta_url, or flow (WhatsApp only). When interactive is set, it takes priority over buttons and quickReplies.

Interactive taps/submissions are delivered in the message.received webhook under metadata: interactiveType (button_reply | list_reply | nfm_reply), interactiveId, flowResponseJson, flowResponseData.

View documentation

Reddit posting now supports native video submissions via new fields in RedditPlatformData.

You can upload videos to Reddit’s CDN for an embedded player (with automatic fallback to a link post if video posts aren’t allowed), or submit silent looping clips.

New fields:
• nativeVideo (boolean, default true) - use Reddit native video flow; set false to fall back to a legacy link post
• videogif (boolean) - submit as silent videogif when nativeVideo is active
• videoPosterUrl (uri) - optional thumbnail/poster image for native video posts

View documentation

PUT /v1/inbox/conversations/{conversationId} can now return 404.

This happens when the conversation isn’t found on WhatsApp (other platforms upsert instead of returning not found).

Handle the new response: 404 Conversation not found.

View documentation

Meta ads now support Advantage Audience controls when creating/boosting ads and when updating Meta targeting.

This lets you explicitly enable/disable Meta’s targeting automation during ad set creation, and optionally preserve the current setting on updates.

Use:
• POST /v1/ads/boost: targeting.advantage_audience = 0 | 1
• PUT /v1/ads/{adId}: targeting.advantage_audience = 0 | 1 (omit to keep existing)
• POST /v1/ads/create: advantageAudience = 0 | 1

View documentation

Ad metrics now include conversion reporting and raw action breakdowns via new fields on AdMetrics.

This lets you read conversion counts/cost directly and also extract any Meta action/conversion type from Insights without relying only on derived metrics.

New fields:
• conversions (integer) — conversion events matching the campaign’s promoted event type (Meta-only for now; others return 0)
• costPerConversion (number) — spend / conversions (0 when conversions is 0)
• actions (object<string, integer>) — per action_type counts (e.g. link_click, offsite_conversion.fb_pixel_purchase)

View documentation

New Ads API write endpoints are available for managing campaigns and ad sets (budget updates, pause/resume, duplication, deletion). This adds first-class support for CBO vs ABO budget routing and bulk status changes.

Campaign budget updates (CBO): PUT /v1/ads/campaigns/{campaignId}
• Body: platform (facebook|instagram), budget.amount, budget.type (daily|lifetime)
• If the campaign is ABO, returns 409 (BUDGET_LEVEL_MISMATCH) — update the ad set instead

Ad set updates (ABO budget and/or status): PUT /v1/ads/ad-sets/{adSetId}
• Body: platform, optional budget, optional status (active|paused)
• If parent campaign is CBO and you try to update budget here, returns 409 (BUDGET_LEVEL_MISMATCH)

Convenience ad set status toggle: PUT /v1/ads/ad-sets/{adSetId}/status
• Body: platform, status (active|paused)

Bulk pause/resume campaigns (up to 50): POST /v1/ads/campaigns/bulk-status
• Body: status (active|paused), campaigns[] with platformCampaignId + platform
• Returns per-campaign results so one failure doesn’t fail the whole batch

Duplicate a campaign (Meta async copy + optional discovery): POST /v1/ads/campaigns/{campaignId}/duplicate
• Key options: deepCopy (default true), statusOption (ACTIVE|PAUSED|INHERITED_FROM_SOURCE), syncAfter (default true)

Delete a campaign (cascades to ad sets/ads): DELETE /v1/ads/campaigns/{campaignId}
• Body: platform (facebook|instagram)

Also added to campaign responses (GET /v1/ads/campaigns and GET /v1/ads/tree):
• reviewStatus (in_review|approved|rejected|with_issues)
• budgetLevel (campaign|adset), campaignBudget, and currency to disambiguate CBO vs ABO budgets

Meta-only for now where noted; other platforms may return 501 for unsupported operations.

View documentation

Ad metrics now include revenue and ROAS fields for Meta insights.

You can read monetary action totals via actionValues (mirrors actions, values in ad-account currency), plus convenience rollups:
• purchaseValue — summed purchase-type action values
• roas — purchaseValue / spend

Meta-only; other platforms return {} for actionValues and 0 for purchaseValue/roas.

View documentation

POST /v1/ads/create now supports 3 mutually-exclusive request shapes (and has updated required fields).

You can now (Meta-only) create multiple ads in one call via creatives[], or attach a new ad to an existing ad set via adSetId.

Key request options:
• Legacy single-creative: use top-level goal, budgetAmount, budgetType, headline, body, imageUrl, linkUrl, callToAction
• Multi-creative (Meta only): set creatives[] (min 1). Each item requires headline, body, imageUrl, linkUrl, callToAction
• Attach (Meta only): set adSetId + a single creative at top-level; goal/budgetAmount/budgetType are inherited

creatives[] and adSetId are mutually exclusive (400 if both). Non-Meta platforms with creatives[]/adSetId return 400.

Response change: 201 may return either ad (legacy/attach) or ads[] + platformCampaignId + platformAdSetId (multi-creative).

View documentation

New analytics endpoints are available for YouTube, LinkedIn org pages, TikTok, Facebook Pages, and Instagram follower history. All new endpoints reuse the same response envelope as /v1/analytics/instagram/account-insights for consistent client handling.

YouTube channel totals (no per-video looping): GET /v1/analytics/youtube/channel-insights
Key params: accountId, metrics, since, until, metricType (total_value|time_series)
Notes: requires yt-analytics.readonly (412 if missing) + Analytics add-on; data is delayed 2–3 days (range clamped).

LinkedIn organization page aggregate analytics: GET /v1/analytics/linkedin/org-aggregate-analytics
Key params: accountId, metrics, since, until, metricType (total_value|time_series)
Notes: requires scopes r_organization_social + r_organization_followers + r_organization_admin (412 if missing) + Analytics add-on; page-view metrics are total_value only.

TikTok account-level insights: GET /v1/analytics/tiktok/account-insights
Key params: accountId, metrics, since, until, metricType (total_value|time_series)
Notes: requires user.info.stats (412 if missing) + Analytics add-on.

Facebook Page insights (post-Nov-2025 Meta metric names): GET /v1/analytics/facebook/page-insights
Key params: accountId, metrics, since, until, metricType (total_value|time_series)
Notes: deprecated Meta metrics (page_impressions, page_fans, page_fan_adds, page_fan_removes) are rejected; use page_media_view, page_follows, etc. followers_gained/followers_lost are synthesized.

Instagram follower history (daily follower count time series): GET /v1/analytics/instagram/follower-history
Key params: accountId, metrics (default follower_count,followers_gained,followers_lost), since, until, metricType (total_value|time_series)

Also added for LinkedIn personal analytics:
• GET /v1/accounts/{accountId}/linkedin-aggregate-analytics now supports POST_SAVE and POST_SEND in metrics
• GET /v1/accounts/{accountId}/linkedin-post-analytics now returns saves and sends (personal only; org returns 0)

View documentation

Comment automation logs now include separate results for the DM and the optional public comment reply in GET /v1/comment-automations/{automationId} and GET /v1/comment-automations/{automationId}/logs.

You can now track whether the DM was sent and whether the public reply was attempted/sent, with separate error messages.

New log fields:
• status (sent | failed | skipped) — DM outcome
• error — DM error if status is failed
• commentReplyStatus (sent | failed | skipped) — public reply outcome
• commentReplyError — public-reply error if commentReplyStatus is failed

View documentation

Webhooks now support the new event account.ads.initial_sync_completed.

This fires once per ads-enabled account when the initial discovery + 90-day ads backfill finishes (including partial success or failure), so you can trigger downstream processing when the initial ads dataset is ready.

Subscribe via events on:
• POST /v1/webhooks/settings
• PUT /v1/webhooks/settings

Event: account.ads.initial_sync_completed
Payload highlights: account.accountId, account.profileId, account.platform, sync.status (success | failure), sync.totalAds, sync.synced, sync.failed, timestamp.

View documentation

GET /v1/posts now supports filtering by social account via the optional query param accountId.

Use it to return only posts published via a specific connected account (useful when multiple accounts exist per platform/profile).

New parameter:
• accountId (string, 24-char hex ObjectId) — filter posts to those published via a specific social account

View documentation

New endpoints added for Click-to-WhatsApp ads and WhatsApp conversion attribution.

Create CTWA ads on Meta in one call via POST /v1/ads/ctwa (creates campaign → ad set → creative → ad).
Key fields: accountId, adAccountId, name, headline, body, budgetAmount, budgetType (daily | lifetime), and exactly one of imageUrl or video (url, thumbnailUrl). Optional: objective (OUTCOME_ENGAGEMENT | OUTCOME_SALES | OUTCOME_LEADS).

Send WhatsApp conversation conversion events to Meta CAPI (business messaging) via POST /v1/whatsapp/conversions.
Key fields: accountId, eventName (LeadSubmitted | Purchase | AddToCart | InitiateCheckout | ViewContent), eventId, optional eventTime, and at least one of conversationId or phoneE164. Note: returns 422 if no captured ctwa_clid (no attribution possible); on 200 check eventsFailed and failures[] for Meta rejections.

View documentation

POST /v1/ads/create now supports Meta-only gender targeting via gender.

Use this to restrict the audience by gender when creating Meta (facebook/instagram) ads; non-Meta platforms ignore it.

Set gender to: • all (default) • male • female

View documentation

GET /v1/inbox/conversations/{conversationId}/messages now supports cursor-based pagination and sort order control.

You can page through long conversations using an opaque cursor, and request oldest-first or newest-first results (with platform-specific limitations).

New query params:
• limit (1–100, default 100)
• cursor (pass prior pagination.nextCursor)
• sortOrder: asc | desc (default asc)

New response fields:
• pagination.hasMore
• pagination.nextCursor
• sortOrderApplied: asc | desc

Also: WebhookPayloadMessage.metadata adds referral (WhatsApp only) for Click-to-WhatsApp ad attribution on the first inbound message after a CTWA ad click (e.g. ctwa_clid, source_url, image_url/video_url).

View documentation

Meta ads now support DSA (EU) advertiser disclosures via two new optional fields on ad creation endpoints.

When your targeting intersects EU member states, Meta may require these values (enforced server-side) to comply with DSA Article 26.

Set:
• dsaBeneficiary — legal entity benefiting from the ad
• dsaPayor — legal entity paying for the ad (Meta spelling: dsa_payor)

Available on:
• POST /v1/ads/boost
• POST /v1/ads/create
• POST /v1/ads/ctwa

View documentation

GET /v1/ads/accounts now returns Meta ad account timezone details: timezoneName and timezoneOffsetHoursUtc.

Use these fields to align daily budget reset timing and Insights day boundaries with the ad account’s local timezone.

New fields in each item of accounts[]:
• timezoneName (IANA timezone, Meta only)
• timezoneOffsetHoursUtc (signed UTC offset in hours, reflects current DST, Meta only)

View documentation

GET /v1/accounts/{accountId}/gmb-location-details now returns a new location summary object in the 200 response.

This provides a compact, public-facing view derived from GBP metadata, making it easy to surface “leave a review” and Maps URLs without parsing the raw metadata block.

New fields under location:
• name
• placeId
• reviewUrl
• mapsUri
• isVerified

Populated when readMask includes metadata (default). For unverified/new locations, placeId/reviewUrl/mapsUri may be null.

View documentation

Ads API now supports setting bid strategy on campaigns, ad sets, and boosted posts.

You can update campaign-level defaults via PUT /v1/ads/campaigns/{campaignId} using bidStrategy (optionally alongside budget). Ad sets can now be updated via PUT /v1/ads/ad-sets/{adSetId} with bidStrategy plus bidAmount or roasAverageFloor when required.

Set bidStrategy to:
• LOWEST_COST_WITHOUT_CAP
• LOWEST_COST_WITH_BID_CAP (requires bidAmount)
• COST_CAP (requires bidAmount)
• LOWEST_COST_WITH_MIN_ROAS (requires roasAverageFloor)

Boosting posts via POST /v1/ads/boost now accepts bidStrategy, bidAmount, and roasAverageFloor. TikTok boosts also add linkUrl and callToAction.

Ad read models now include bidStrategy (normalized for Meta + TikTok) and may include bidAmount / roasAverageFloor on Ad, AdCampaign, and AdTree* responses.

GBP location details (GET /v1/accounts/{accountId}/gmb-location-details) now always includes title + metadata and always populates the derived location summary; passing location in readMask returns 400.

View documentation