External Instagram posts and analytics responses now include additional Instagram-specific metadata fields.

This helps you distinguish content types like Reels vs Feed, detect AI-generated labels, and see whether a Reel was shared to the main feed.

New optional fields:
• mediaProductType (Instagram only; e.g. FEED, REELS, STORY, AD)
• isAiGenerated (Instagram only)
• isSharedToFeed (Instagram Reels only)
• mediaAudioType (Instagram only; MUSIC or ORIGINAL_SOUND)

Also, GET /v1/whatsapp/account-events events now include accountId in each event item.

View documentation

POST /v1/posts/{postId}/edit now supports editing published posts on more platforms and can target a specific account’s copy of a post.

You can now edit on platform: twitter, discord, facebook, reddit, linkedin, telegram, pinterest, googlebusiness, youtube, slack.

When a post was published to multiple accounts on the same platform, pass accountId to choose which one to edit (defaults to the first).

Request body: platform, content, optional accountId.

View documentation

POST /v1/inbox/conversations now returns more specific Reddit error details.

This improves client-side handling when creating a Reddit DM thread fails (missing user, DM not allowed, or rate limiting).

Key response changes:
• 404 now includes code: PARTICIPANT_NOT_FOUND when the u/username doesn’t exist
• 422 now also applies to Reddit when the recipient doesn’t accept private messages (still code: DM_NOT_ALLOWED)
• 429 may now be returned for Reddit rate limits with code: rate_limited

View documentation

New endpoint GET /v1/ads/videos is available.

It lists a Meta ad account’s existing ad video library so you can reuse an already-uploaded video when creating ads (avoid duplicate uploads and share one upload across multiple ads).

Call with:
• accountId (required)
• adAccountId (required, act_<n>)
• fields (optional Graph field override)
• limit (optional, default 25, max 100)
• after (optional cursor)

Use returned data[].id as video.id on POST /v1/ads/create. A video is only usable once status.video_status is ready.

Note: this endpoint is Meta-only; other platforms return 501.

View documentation

LinkedIn company_list audiences can now be updated after creation via POST /v1/ads/audiences/{audienceId}/companies.

This uploads a new full company list and replaces the existing list (not appended/merged). Matching is asynchronous and the audience stays processing while LinkedIn processes the update.

Send:
• audienceId (path)
• companies (array, 1..300000) — each row must include at least one of name, domain, website, linkedinPageUrl

Notes:
• company_list is filled at creation from companies on POST /v1/ads/audiences; use the new endpoint for later changes
• POST /v1/ads/audiences/{audienceId}/users is customer_list-only and returns 422 for company_list (use /companies instead)

View documentation

SIP trunking is now available for Voice: you can create SIP trunks and attach Zernio numbers to route inbound/outbound calls through an external SIP platform.

New endpoints:
• GET /v1/phone-numbers/sip-trunks (returns trunks, plus enabled)
• POST /v1/phone-numbers/sip-trunks (create; returns digestPassword only once)
• GET /v1/phone-numbers/sip-trunks/{id}
• DELETE /v1/phone-numbers/sip-trunks/{id}
• POST /v1/phone-numbers/sip-trunks/{id}/rotate-credentials (returns new digestPassword only once)
• POST /v1/phone-numbers/{id}/sip-trunk (attach with trunkId)
• DELETE /v1/phone-numbers/{id}/sip-trunk (detach)

Create trunk request fields: label, sipHost, optional sipPort, transport (tls/tcp/udp).

Phone number responses now include sipTrunkId (null when not trunked) on GET /v1/phone-numbers and GET /v1/phone-numbers/{id} (and the deprecated WhatsApp aliases).

Behavior change: when a number is attached to a trunk, these endpoints can return 409 (invalid_resource_state) and require detaching first:
• DELETE /v1/phone-numbers/{id}
• POST /v1/phone-numbers/{id}/voice
• POST /v1/phone-numbers/{id}/whatsapp/calling

View documentation

LinkedIn reshare behavior is now explicitly defined for platformSpecificData.reshareUrl on POST /v1/posts.

When you set reshareUrl, the published post is always a reshare authored by your account with the original embedded underneath: with content it’s a quote-style reshare, and with no content it’s a text-free reshare.

Note: a text-free reshare is not LinkedIn’s one-click “Repost” feed treatment (LinkedIn’s API doesn’t support creating that), so it will still appear authored by you.

Use: platformSpecificData.reshareUrl (mutually exclusive with media).

View documentation

WhatsApp Flows now let you set a data exchange endpoint via endpointUri when creating or updating a flow.

This enables configuring the HTTPS callback endpoint directly on DRAFT flows (and it will be used only if your uploaded Flow JSON declares data_api_version "3.0").

New field:
• POST /v1/whatsapp/flows: endpointUri
• PATCH /v1/whatsapp/flows/{flowId}: endpointUri

Notes:
• endpointUri is uri format and HTTPS-only
• Settable only while the flow is in DRAFT

View documentation

Connecting WhatsApp via POST /v1/connect/whatsapp/credentials now explicitly subscribes your Meta app to the WABA with a Zernio override callback, cutting over webhook delivery immediately (no overlap). Unsubscribing the app from the WABA afterward will also stop Zernio delivery and requires calling this endpoint again.

Response updates:
• webhookNotice may be returned on success with cutover/unsubscribe guidance
• account.phoneNumber replaces account.selectedPhoneNumber
• account.verifiedName and account.qualityRating are now included when available

View documentation

CTWA ad creation request (CtwaAdRequestBody) now supports reusing existing videos and more control over activation.

You can now pass video.id to reuse a video already uploaded to the ad account (instead of uploading via video.url). video.thumbnailUrl is now optional (Meta may auto-pick a thumbnail).

Video fields:
• video.url or video.id (either; id wins)
• video.thumbnailUrl (optional)

New status controls:
• status: ACTIVE | PAUSED (ad-level; default ACTIVE)
• campaignStatus: ACTIVE | PAUSED (campaign-level; default ACTIVE; rejected when using adSetId)

View documentation

Meta ad videos can now be managed directly via the API: upload standalone videos and delete them from an ad account’s video library.

Use POST /v1/ads/videos to upload before an ad exists (for reuse in POST /v1/ads/create via video.id or in POST /v1/ads/preview).

Upload params:
• accountId, adAccountId
• Exactly one of videoUrl (https) or videoBase64
• Optional filename (only for videoBase64)
Returns video.id and optional video.thumbnailUrl.

Use DELETE /v1/ads/videos/{videoId} with accountId + adAccountId to remove a video; returns { success: true } on success.

Breaking change (CTWA): when using multi-creative creatives[], setting any top-level headline/body/imageUrl/video now returns 400 (previously those fields could be silently ignored).

Also added for sorting: createdTime on AdTreeCampaign and AdTreeAdSet (proxy based on earliest ad creation time).

View documentation

Meta ads now support standalone ad video upload and ad video delete.

You can upload a video before an ad exists, then reuse the returned video.id in POST /v1/ads/create (via video.id) or in POST /v1/ads/preview creative specs.

New endpoints:
• POST /v1/ads/videos with accountId, adAccountId, and exactly one of videoUrl or videoBase64 (optional filename for base64 uploads). Returns video.id and video.thumbnailUrl.
• DELETE /v1/ads/videos/{videoId} with query accountId, adAccountId. Returns { success: true } on delete.

Related changes:
• GET /v1/ads/videos docs now reference uploading via POST /v1/ads/videos (in addition to inline video.url on POST /v1/ads/create).
• CTWA multi-creative requests (creatives[]) now explicitly reject setting top-level headline/body/imageUrl/video with a 400 (previously described as being ignored in POST /v1/ads/create).
• GET /v1/ads/tree campaign/ad set nodes now include createdTime (date-time) for sorting by earliest ad creation time.

View documentation

GET /v1/inbox/comments and GET /v1/inbox/comments/{postId} responses are now cached for up to 10 minutes.

This means comment counts/threads may lag new comments within that window; for real-time updates, use the comment.received webhook instead of polling.

Notes:
• Cache window: up to 10 minutes
• Recommended real-time mechanism: comment.received
• On GET /v1/inbox/comments/{postId}, your own writes (create/reply/delete) refresh the cache immediately.

View documentation

CTWA ad creation now supports a custom chat welcome message via welcomeMessage.

This lets you override Meta’s default greeting and prefilled user text when the WhatsApp chat opens, so ads can steer the first message toward what they promote.

Set welcomeMessage (single-creative) or creatives[].welcomeMessage (multi-creative) with:
• text
• prefillText

View documentation

New endpoint GET /v1/ads/{adId}/media returns direct signed URLs for every image/video asset used by an ad’s live creative (normalized across single, carousel, Reels/Story, and dynamic creative).

Use it to fetch short-lived asset URLs on demand (don’t cache long-term; re-fetch before serving/downloading).

Key details:
• Path param: adId (Zernio 24-char hex or platform ad id)
• Response: platform (facebook | instagram), media[] items with type (image | video), url, and for videos: thumbnailUrl, videoId, length, index
• Errors: 422 (no active Meta connection), 501 (only supported on Meta)

View documentation

WhatsApp interactive messages now support native address capture via interactive.type = address_message on POST /v1/inbox/conversations/{conversationId}/messages.

This lets you prompt users with Meta’s structured shipping-address form in-chat; submissions arrive as metadata.interactiveType = nfm_reply on the message.received webhook.

To send, set:
• interactive.type: address_message
• interactive.action.name: address_message
• interactive.action.parameters.country: ISO 3166-1 alpha-2 (required)

Webhook parsing update: WebhookPayloadMessage.metadata now includes nfmReplyName (e.g. flow vs address_message) to distinguish address submissions from Flow submissions; address fields are included in flowResponseData.

View documentation

GET /v1/ads/videos now returns a playable video URL via source in the default response.

This lets you preview a video before selecting it (useful when multiple videos share the same first frame).

Key field:
• data[].source — signed CDN MP4 URL (expires; use for preview only and re-list to refresh)

View documentation

GET /v1/ads/tree now supports scoping the tree to multiple ad accounts via adAccountId.

You can pass a comma-separated list to limit results to a subset of connected accounts (useful for agency profiles).

Use adAccountId=act_1,act_2,act_3 (max 50 per request). Single values keep the old behavior.

Note: the plural aliases adAccountIds and platformAdAccountIds are now rejected with 400 (to avoid silently returning unfiltered results).

View documentation

Inbox list endpoints now return which connected accounts were skipped during aggregation via meta.accountsSkipped.

This helps you distinguish between accounts that failed (meta.failedAccounts) vs accounts that were intentionally not queried because the platform/account doesn’t support the feature or isn’t enabled.

New response field:
• meta.accountsSkipped: array of { accountId, platform }

Applies to:
• GET /v1/inbox/conversations
• GET /v1/inbox/comments
• GET /v1/inbox/reviews

View documentation

Meta ads now support the Page Likes objective via goal = page_likes.

This lets you create campaigns/ads optimized for Page Likes (Meta maps this to Engagement/Page Likes) using the same create flows.

Use goal with:
• POST /v1/ads/campaigns: goal now includes page_likes
• POST /v1/ads/create: goal now includes page_likes

Notes for page_likes (Meta): promotedObject.pageId is optional (auto-filled from the connected Page). Creative fields like headline, body, linkUrl, callToAction, imageUrl/video are optional (Meta derives the Like button + destination from the Page).

View documentation

Google Search ads created via POST /v1/ads/create now support campaign-level sitelinks.

You can create and attach sitelink assets during ad creation (Google reviews them asynchronously; approval is not immediate).

Use sitelinks (Google Search only):
• 2–20 items
• each item: text (max 25) + linkUrl (URI)
• optional: description1, description2 (each max 35)

Applies when campaignType is search.

View documentation