You can now view KYC documents on file via GET /v1/phone-numbers/kyc/document/{documentId}.

This streams the stored verification document inline as application/pdf, so users can confirm what’s on file before reusing a verification. Access is auth-scoped (returns 404 if the documentId isn’t referenced by one of your numbers).

KYC spec responses now include documentId on document rows:
• GET /v1/phone-numbers/kyc → reusable.options[].details[].documentId
• GET /v1/whatsapp/phone-numbers/kyc → reusable.options[].details[].documentId

Use that documentId as the {documentId} path parameter when fetching the PDF.

View documentation

New endpoint: POST /v1/phone-numbers/{id}/remediate/reply lets you reply to a regulatory reviewer on a phone number awaiting remediation, including optional file attachments.

Use it when the reviewer asks for info the structured remediation form can’t express; posting a reply can move the number back to in review (comment-style asks). Requires text or at least one attachments item.

Request body:
• text (string, max 2000)
• attachments (array, max 5) items: { filename, base64 } (PDF/JPG/PNG/WEBP, max 10MB each)

Response 200:
• posted (boolean)
• attachments (integer uploaded)

Errors: 400, 401, 404, 502 (retry).

View documentation

GET /v1/profiles now supports exact-name filtering and pagination, and the default sort order is now default-first (then creation date).

Use name (exact match) to find a profile by name, and limit/skip to paginate. When limit or skip is provided, the response may include total, skip, and limit.

New query params: name, limit (1..1000), skip (>=0)

POST /v1/profiles now supports idempotent retries via Idempotency-Key (header).

With Idempotency-Key: same key + same body replays the original 201; same key + different body returns 422; key still processing returns 409. Duplicate name conflicts (409) now include details.existingProfileId.

View documentation

New endpoint: POST /v1/phone-numbers/{id}/remediate/respond lets you respond to a regulatory reviewer for a phone number awaiting remediation.

You can send a reviewer message and/or submit corrected requirement data in a single call; submitting corrections re-submits the number back to review, while message-only posts to the reviewer thread.

Request body supports:
• message (max 2000)
• documents[] keyed by requirementId (use base64 or documentId)
• address (corrected address record)
• entityType: individual | business | null
• attachments[] (max 5; each filename + base64)

Response includes status: resubmitted | replied, plus posted, phoneNumber, and siblingsResubmitted.

View documentation

message.sent webhook payload now includes message.source for WhatsApp.

This lets you tell whether a sent message came from the WhatsApp Business phone app on a Coexistence number vs being sent through Zernio (dashboard/API/broadcasts).

New field: message.source = whatsapp_business_app | cloud_api

Only present for WhatsApp; absent on non-WhatsApp platforms.

View documentation

WhatsApp template endpoints can now return 502 when Meta rejects the request or is unreachable.

This makes Meta-side failures explicit so you can distinguish platform outages/rejections from Zernio validation/auth errors.

Applies to:
• GET /v1/whatsapp/templates/{templateName}
• PATCH /v1/whatsapp/templates/{templateName}
• DELETE /v1/whatsapp/templates/{templateName}

Also added ad review state support via reviewStatus (schema AdReviewStatus: in_review, approved, rejected, with_issues) and Meta-only configuredStatus on Ad to separate delivery status from the ad’s on/off toggle.

View documentation

New endpoint GET /v1/ads/keywords is available to list Google Search keyword criteria (positive and negative) synced from connected Google Ads accounts (one row per ad-group keyword).

Keywords are populated by the periodic ads discovery sweep (~every 3 hours per account). Campaign-level negative keywords aren’t included (ad-group-level only).

Filter with:
• accountId, adAccountId (Google customer ID), profileId
• campaignId, adSetId (Google ad group)
• status: active | paused
• matchType: exact | phrase | broad | unknown
• negative: true (negative only) | false (positive only)
• search (substring match), plus pagination via page/limit (1–500)

Response returns keywords with fields like keyword, matchType, status, negative, and syncedAt, plus pagination.

View documentation

POST /v1/tools/validate/post now accepts accountId per platform to validate against account-specific limits.

For platform=twitter, providing platforms[].accountId lets validation apply the correct character limit (280 vs 25000 for X Premium). Missing/invalid/foreign IDs fall back to 280 and won’t error.

Use:
• platforms[].platform (enum: twitter, instagram, tiktok, youtube, facebook, linkedin, bluesky, threads, reddit, pinterest, telegram, snapchat, googlebusiness, discord)
• platforms[].accountId

View documentation

GET /v1/accounts now enforces stricter pagination and query validation.

If you use server-side pagination, you must send page and limit together; sending only one now returns 400. Out-of-range page/limit values are also rejected with 400 (instead of being silently clamped).

Key params:
• page (1-based) + limit (1–100) must be supplied together
• profileId must be a valid ObjectId

View documentation

KYC submission now enforces stricter validation when requesting multiple numbers with an areaCode.

If you pass areaCode and request quantity above that area’s live inventory, the request is rejected with 400 (instead of best-effort skipping).

Applies to:
• POST /v1/phone-numbers/kyc
• POST /v1/whatsapp/phone-numbers/kyc

Key params: areaCode, quantity (1–5).

View documentation

New endpoint GET /v1/twitter/search lets you search public tweets from the last 7 days using an X query (passed through unchanged) to discover tweets to reply to.

Use it with:
• accountId (required)
• query (required, 1–512 chars)
• limit (10–100, default 10)
• cursor (pagination)
• sinceId / untilId (numeric tweet IDs)
• startTime / endTime (ISO 8601 UTC, within last 7 days)
• sortOrder: recency | relevancy (default recency)

To reply to a found tweet, set platformSpecificData.replyToTweetId to the returned tweets[].id when creating a post.

Rate limit: 300 requests per 15 minutes per connected account.

View documentation

Webhook limits have increased: you can now configure up to 50 webhooks per user (was 10).

This lets you split event subscriptions across more endpoints/environments without hitting the previous cap.

Applies to:
• GET /v1/webhooks/settings (list up to 50)
• POST /v1/webhooks/settings (create up to 50; 400 if max reached)

View documentation

SMS carrier registrations now support a preflight dry-run and change-request replies.

Use POST /v1/sms/registrations/preflight to validate and preview the exact 10DLC brand/campaign payloads that would be stored, without creating a registration. It returns compliance findings (including AI review when available) so you can fix issues before submitting.

Request: registrationType (standard_10dlc | sole_prop_10dlc), brand, campaign, optional phoneNumbers, optional messagingBrandName
Response: composed, advisories (severity block | warn), verdict (pass | warn | fail | unreviewed), aiUnavailable

Use POST /v1/sms/registrations/{id}/respond to reply to a reviewer change request (when a registration is in changes_requested) with a note, files (hosted URLs), or both—without resubmitting the full registration. On success, status returns to requested.

Also added to POST /v1/sms/registrations: messagingBrandName (2–60 chars) to brand samples/auto-replies when it differs from the legal brand.displayName.

View documentation

Meta conversion goals on POST /v1/ads/create now support optimizing against a Custom Conversion.

This lets you run goal conversions or lead_conversion without providing a standard event type, by pointing the ad set at an existing Custom Conversion.

Use promotedObject.customConversionId (instead of promotedObject.customEventType) for:
• goal=conversions
• goal=lead_conversion

View documentation

Instagram is now supported for typing indicators via POST /v1/inbox/conversations/{conversationId}/typing.

Calling this endpoint can now show typing... to the Instagram recipient (works for both Instagram Login and Facebook Login accounts; recipient must be signed in to Instagram to see it).

Request: { "accountId": "..." }
Response: { "success": true|false } where success indicates whether the typing indicator was actually sent (false on unsupported platforms or if the platform call failed).

The endpoint may now also return 400 (BadRequest) in addition to existing responses.

View documentation

Webhooks now support post.platform.deleted in events for POST /v1/webhooks/settings and PUT /v1/webhooks/settings.

This event fires when Zernio’s background sync detects a platform post (published via Zernio) was later deleted on the platform (poll-driven ~hourly, not real-time).

Subscribe by including post.platform.deleted in events.

In WebhookPayloadPostPlatform:
• event: post.platform.published | post.platform.failed | post.platform.deleted | post.tiktok.url_resolved
• platform.status: published | failed | deleted
• New field on delete events: platform.deletedAt (ISO 8601)

View documentation

POST /v1/sms/registrations no longer requires phoneNumbers in the request body.

For 10DLC registrations, if phoneNumbers is omitted or an empty array, it now defaults to your active SMS-enabled US local numbers that aren’t already covered by another registration.

Key request fields:
• registrationType: standard_10dlc | sole_prop_10dlc | toll_free
• phoneNumbers: optional (new defaulting behavior for 10DLC)

View documentation

Instagram and Facebook Inbox now include pre-connect DM history replay in GET /v1/inbox/conversations and GET /v1/inbox/conversations/{conversationId}/messages.

When an IG/FB account is connected, Zernio replays existing Meta DM history in the background so older threads can appear in listings; if you sync into your own store, you should re-sweep rather than relying on a single pass at connect time.

Key behavior:
• GET /v1/inbox/conversations: up to 500 conversations per account are replayed; replayed threads keep their original lastMessageAt/updatedTime so they sort into date order (not bumped to the top)
• Replayed history emits no webhooks and is stored as read (does not affect unreadCount)
• GET /v1/inbox/conversations/{conversationId}/messages: replay includes the 500 most recent messages per conversation; older messages beyond that are not retrievable

View documentation

New Google Ads keyword research endpoints are available, and GET /v1/ads/insights now supports Google Ads queries.

You can now pull Keyword Planner data via:
• POST /v1/ads/keywords/ideas (generate ideas from seedKeywords and/or seedUrl)
• POST /v1/ads/keywords/historical-metrics (metrics for up to keywords = 1000)

Key request fields:
• accountId (required)
• customerId (optional; needed if the connection has several Google Ads accounts)
• countries (optional; omitted = worldwide)
• languageConstantId (default 1000)
• network: GOOGLE_SEARCH | GOOGLE_SEARCH_AND_PARTNERS

GET /v1/ads/insights now routes by platform:
• Meta: use objectId (+ fields/breakdowns/filtering as before)
• Google Ads: use query (GAQL SELECT), with paging via pageToken and paging.nextPageToken (fixed 10,000 rows/page)

Note: Google responses return raw rows (camelCase) with int64 counters encoded as strings; bid/CPC values are in micros.

View documentation

POST /v1/inbox/conversations/{conversationId}/messages now returns more detailed send failures in 400 responses.

You can distinguish missing-recipient cases and, for Instagram/Facebook, get Meta’s diagnostic fields to debug rejected sends.

New 400 fields:
• code: PLATFORM_LIMITATION | MISSING_PARTICIPANT
• platformError (Instagram/Facebook only): code, subcode, fbtraceId, type

View documentation

POST /v1/posts/sync-external now supports LinkedIn personal profiles.

Because LinkedIn personal profiles don’t have a listing API, you must provide url to import a single post authored by the connected member (works even for posts published before the account was connected).

Use accountId + url (required for LinkedIn personal), where url can be:
• linkedin.com/posts/…
• linkedin.com/feed/update/urn:li:activity:…
• urn:li:share:… / urn:li:ugcPost:…

Imported LinkedIn personal posts return analytics (impressions, reach, reactions, comments, reshares, saves) but no content/media.

View documentation