late-sdk 0.0.122 → 0.0.123

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5b5b0c7ab0c5800b52a30336a6611f64e0355379e16cabaf6a679db87ef504ca
-  data.tar.gz: 71ac1c98480ec88a4234ed15b6a6ba11b278ab41c7a6eff45d361162d8aa526f
+  metadata.gz: 71793f075aa79c8502aecc6e20853c8b6e572d3808a7d9043ff73cab84bd4603
+  data.tar.gz: 7a904e33e411bdba92d0c4d302738aa3e5967918dd5256f8f4c7736a111d0f4b
 SHA512:
-  metadata.gz: d1911d73bc66be34758df9ecfa7cd9cd41a2544fa898b15e85be7e1c17a93ccd10fcc6be8c9ef0f2b4eb593393e0f2832f9fb7d84453b847abd3a84f05bfa8c0
-  data.tar.gz: a4d85148d0992b689768ae7f8e2dd6ced2efaa83897790083bae0dcfee1f3608d3c76bccbbe7f0c8c1d48b4a0c538329bce9e301f682e5723c626dfce619a16b
+  metadata.gz: 2a53768a93972ac2a1b2a833fb2ab706339e8018607ba8efee6a2d37b69c64ea4bfe1e8dd727d67385786c4d7b0a1703390f34c1a03f0fc175a3249838a63924
+  data.tar.gz: d20e3eaf2a41c6f23b770efbede5434841ca5acb9d0a7dcb25c59bee1e3bd98777fa51272280bce548696d95861943de8e7a9cad062f2a680ad3f4e7840ef54d

data/docs/AccountWithFollowerStats.md

@@ -13,7 +13,9 @@
 | **is_active** | **Boolean** |  | [optional] |
 | **followers_count** | **Float** | Follower count (only included if user has analytics add-on) | [optional] |
 | **followers_last_updated** | **Time** | Last time follower count was updated (only included if user has analytics add-on) | [optional] |
-| **ads_status** | **String** | Ads connection status for this account. - `connected`: Ads are ready to use (same-token platforms like Meta/LinkedIn, or separate ads token is present). - `not_connected`: Platform supports ads but requires a separate ads OAuth. Use `GET /v1/connect/{platform}/ads` to connect. - `not_available`: Platform does not support ads (e.g., YouTube, Reddit, Bluesky).  | [optional] |
+| **parent_account_id** | **String** | Reference to the parent posting SocialAccount. Set for ads accounts that share or derive from a posting account's OAuth token. null for standalone ads (Google Ads) and all posting accounts.  | [optional] |
+| **enabled** | **Boolean** | Whether the user explicitly activated this account. false means the account was created as a side effect (e.g., posting account auto-created when user connected ads first). Posting UI and scheduler ignore accounts with enabled: false.  | [optional] |
+| **ads_status** | **String** | **Deprecated.** With the new ads account model, ads accounts are separate SocialAccount documents. Check for accounts with ads platform values (metaads, linkedinads, pinterestads, tiktokads, xads, googleads) instead.  Legacy behavior: - `connected`: Ads are ready to use (same-token platforms like Meta/LinkedIn, or separate ads token is present). - `not_connected`: Platform supports ads but requires a separate ads OAuth. Use `GET /v1/connect/{platform}/ads` to connect. - `not_available`: Platform does not support ads (e.g., YouTube, Reddit, Bluesky).  | [optional] |
 | **metadata** | **Object** | Platform-specific metadata. Fields vary by platform. For WhatsApp accounts, includes: - `qualityRating`: Phone number quality rating from Meta (`GREEN`, `YELLOW`, `RED`, or `UNKNOWN`) - `nameStatus`: Display name review status (`APPROVED`, `PENDING_REVIEW`, `DECLINED`, or `NONE`). Messages cannot be sent until the display name is approved by Meta. - `messagingLimitTier`: Maximum unique business-initiated conversations per 24h rolling window (`TIER_250`, `TIER_1K`, `TIER_10K`, `TIER_100K`, or `TIER_UNLIMITED`). Scales automatically as quality rating improves. - `verifiedName`: Meta-verified business display name - `displayPhoneNumber`: Formatted phone number (e.g., \"+1 555-123-4567\") - `wabaId`: WhatsApp Business Account ID - `phoneNumberId`: Meta phone number ID  | [optional] |
 | **profile_picture** | **String** |  | [optional] |
 | **current_followers** | **Float** | Current follower count | [optional] |
@@ -38,6 +40,8 @@ instance = Late::AccountWithFollowerStats.new(
   is_active: null,
   followers_count: null,
   followers_last_updated: null,
+  parent_account_id: null,
+  enabled: null,
   ads_status: null,
   metadata: null,
   profile_picture: null,

data/docs/AccountsApi.md

@@ -85,11 +85,11 @@ end
 
 ## disconnect_ads
 
-> <DeleteAccountGroup200Response> disconnect_ads(account_id, disconnect_ads_request)
+> <DeleteAccountGroup200Response> disconnect_ads(account_id, opts)
 
 Disconnect ads from an account
 
-Disconnects ads from a social account without removing the posting connection.  **Same-token platforms** (metaads, linkedinads, pinterestads): Sets an `adsOptOut` flag. The posting account and OAuth token are preserved. Reconnecting ads clears the flag.  **Separate-token platforms** (tiktokads, xads): Clears the ads-specific metadata (marketing API tokens). The posting account stays intact.  **Standalone platforms** (googleads): Do not use this endpoint. Use `DELETE /v1/accounts/{accountId}` instead, since Google Ads accounts are standalone. 
+**Deprecated.** Ads accounts are now standalone SocialAccount documents. Use `DELETE /v1/accounts/{accountId}` instead, passing the ads account's own ID.  This endpoint is kept for backward compatibility. It soft-deletes the ads SocialAccount identified by `accountId` (which must be an ads account, not a posting account). The parent posting account is left untouched. 
 
 ### Examples
 
@@ -103,12 +103,14 @@ Late.configure do |config|
 end
 
 api_instance = Late::AccountsApi.new
-account_id = 'account_id_example' # String | The SocialAccount ID (parent posting account for same-token/separate-token platforms)
-disconnect_ads_request = Late::DisconnectAdsRequest.new({ads_platform: 'metaads'}) # DisconnectAdsRequest | 
+account_id = 'account_id_example' # String | The ads SocialAccount ID to disconnect
+opts = {
+  disconnect_ads_request: Late::DisconnectAdsRequest.new # DisconnectAdsRequest | 
+}
 
 begin
   # Disconnect ads from an account
-  result = api_instance.disconnect_ads(account_id, disconnect_ads_request)
+  result = api_instance.disconnect_ads(account_id, opts)
   p result
 rescue Late::ApiError => e
   puts "Error when calling AccountsApi->disconnect_ads: #{e}"
@@ -119,12 +121,12 @@ end
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<DeleteAccountGroup200Response>, Integer, Hash)> disconnect_ads_with_http_info(account_id, disconnect_ads_request)
+> <Array(<DeleteAccountGroup200Response>, Integer, Hash)> disconnect_ads_with_http_info(account_id, opts)
 
 ```ruby
 begin
   # Disconnect ads from an account
-  data, status_code, headers = api_instance.disconnect_ads_with_http_info(account_id, disconnect_ads_request)
+  data, status_code, headers = api_instance.disconnect_ads_with_http_info(account_id, opts)
   p status_code # => 2xx
   p headers # => { ... }
   p data # => <DeleteAccountGroup200Response>
@@ -137,8 +139,8 @@ end
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **account_id** | **String** | The SocialAccount ID (parent posting account for same-token/separate-token platforms) |  |
-| **disconnect_ads_request** | [**DisconnectAdsRequest**](DisconnectAdsRequest.md) |  |  |
+| **account_id** | **String** | The ads SocialAccount ID to disconnect |  |
+| **disconnect_ads_request** | [**DisconnectAdsRequest**](DisconnectAdsRequest.md) |  | [optional] |
 
 ### Return type
 

data/docs/ConnectApi.md

@@ -113,7 +113,7 @@ end
 
 Connect ads for a platform
 
-Unified ads connection endpoint. Handles all platforms through a single route:  **Same-token platforms** (facebook, instagram, linkedin, pinterest): If a posting account already exists, returns `alreadyConnected: true` immediately (no extra OAuth needed). If not, starts the normal OAuth flow, and the resulting account supports both posting and ads.  **Separate-token platforms** (tiktok, twitter): Requires an existing posting account (`accountId` param). If ads are already connected, returns `alreadyConnected: true`. Otherwise, starts the platform-specific marketing API OAuth flow.  **Ads-only platforms** (googleads): If a Google Ads account exists, returns `alreadyConnected: true`. Otherwise, starts the Google Ads OAuth flow.  Use the `adsStatus` field from `GET /v1/accounts` to check which accounts need ads connection. 
+Unified ads connection endpoint. Creates a dedicated ads SocialAccount for the specified platform.  **Same-token platforms** (facebook, instagram, linkedin, pinterest): Creates an ads SocialAccount (`metaads`, `linkedinads`, `pinterestads`) with a copied OAuth token from the parent posting account. If the ads account already exists, returns `alreadyConnected: true`. No extra OAuth needed.  **Separate-token platforms** (tiktok, twitter): Starts the platform-specific marketing API OAuth flow and creates an ads SocialAccount (`tiktokads`, `xads`) with its own token. Requires an existing posting account (`accountId` param). If the ads account already exists, returns `alreadyConnected: true`.  **Standalone platforms** (googleads): Starts the Google Ads OAuth flow and creates a standalone ads SocialAccount (`googleads`) with no parent. If the account already exists, returns `alreadyConnected: true`.  Ads accounts appear as regular SocialAccount documents with ads platform values (e.g., `metaads`, `tiktokads`) in `GET /v1/accounts`. 
 
 ### Examples
 
@@ -130,7 +130,7 @@ api_instance = Late::ConnectApi.new
 platform = 'facebook' # String | Platform to connect ads for. Only platforms with ads support are accepted.
 profile_id = 'profile_id_example' # String | Your Zernio profile ID
 opts = {
-  account_id: 'account_id_example', # String | Existing SocialAccount ID. Required for separate-token platforms (tiktok, twitter). Ignored for same-token and ads-only platforms.
+  account_id: 'account_id_example', # String | Existing SocialAccount ID. Required for separate-token platforms (tiktok, twitter). Ignored for same-token and standalone platforms.
   redirect_url: 'redirect_url_example', # String | Custom redirect URL after OAuth completes (same-token platforms only)
   headless: true # Boolean | Enable headless mode (same-token platforms only)
 }
@@ -168,7 +168,7 @@ end
 | ---- | ---- | ----------- | ----- |
 | **platform** | **String** | Platform to connect ads for. Only platforms with ads support are accepted. |  |
 | **profile_id** | **String** | Your Zernio profile ID |  |
-| **account_id** | **String** | Existing SocialAccount ID. Required for separate-token platforms (tiktok, twitter). Ignored for same-token and ads-only platforms. | [optional] |
+| **account_id** | **String** | Existing SocialAccount ID. Required for separate-token platforms (tiktok, twitter). Ignored for same-token and standalone platforms. | [optional] |
 | **redirect_url** | **String** | Custom redirect URL after OAuth completes (same-token platforms only) | [optional] |
 | **headless** | **Boolean** | Enable headless mode (same-token platforms only) | [optional][default to false] |
 

data/docs/DisconnectAdsRequest.md

@@ -4,7 +4,7 @@
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **ads_platform** | **String** | The ads platform to disconnect |  |
+| **ads_platform** | **String** | The ads platform (optional, used for logging only) | [optional] |
 
 ## Example
 

data/docs/SocialAccount.md

@@ -13,7 +13,9 @@
 | **is_active** | **Boolean** |  | [optional] |
 | **followers_count** | **Float** | Follower count (only included if user has analytics add-on) | [optional] |
 | **followers_last_updated** | **Time** | Last time follower count was updated (only included if user has analytics add-on) | [optional] |
-| **ads_status** | **String** | Ads connection status for this account. - `connected`: Ads are ready to use (same-token platforms like Meta/LinkedIn, or separate ads token is present). - `not_connected`: Platform supports ads but requires a separate ads OAuth. Use `GET /v1/connect/{platform}/ads` to connect. - `not_available`: Platform does not support ads (e.g., YouTube, Reddit, Bluesky).  | [optional] |
+| **parent_account_id** | **String** | Reference to the parent posting SocialAccount. Set for ads accounts that share or derive from a posting account's OAuth token. null for standalone ads (Google Ads) and all posting accounts.  | [optional] |
+| **enabled** | **Boolean** | Whether the user explicitly activated this account. false means the account was created as a side effect (e.g., posting account auto-created when user connected ads first). Posting UI and scheduler ignore accounts with enabled: false.  | [optional] |
+| **ads_status** | **String** | **Deprecated.** With the new ads account model, ads accounts are separate SocialAccount documents. Check for accounts with ads platform values (metaads, linkedinads, pinterestads, tiktokads, xads, googleads) instead.  Legacy behavior: - `connected`: Ads are ready to use (same-token platforms like Meta/LinkedIn, or separate ads token is present). - `not_connected`: Platform supports ads but requires a separate ads OAuth. Use `GET /v1/connect/{platform}/ads` to connect. - `not_available`: Platform does not support ads (e.g., YouTube, Reddit, Bluesky).  | [optional] |
 | **metadata** | **Object** | Platform-specific metadata. Fields vary by platform. For WhatsApp accounts, includes: - `qualityRating`: Phone number quality rating from Meta (`GREEN`, `YELLOW`, `RED`, or `UNKNOWN`) - `nameStatus`: Display name review status (`APPROVED`, `PENDING_REVIEW`, `DECLINED`, or `NONE`). Messages cannot be sent until the display name is approved by Meta. - `messagingLimitTier`: Maximum unique business-initiated conversations per 24h rolling window (`TIER_250`, `TIER_1K`, `TIER_10K`, `TIER_100K`, or `TIER_UNLIMITED`). Scales automatically as quality rating improves. - `verifiedName`: Meta-verified business display name - `displayPhoneNumber`: Formatted phone number (e.g., \"+1 555-123-4567\") - `wabaId`: WhatsApp Business Account ID - `phoneNumberId`: Meta phone number ID  | [optional] |
 
 ## Example
@@ -31,6 +33,8 @@ instance = Late::SocialAccount.new(
   is_active: null,
   followers_count: null,
   followers_last_updated: null,
+  parent_account_id: null,
+  enabled: null,
   ads_status: null,
   metadata: null
 )

data/docs/TikTokPlatformData.md

@@ -4,7 +4,7 @@
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **draft** | **Boolean** | When true, sends the post to the TikTok Creator Inbox as a draft instead of publishing immediately. | [optional] |
+| **draft** | **Boolean** | When true, sends the post to the TikTok Creator Inbox as a draft instead of publishing immediately. The creator receives an inbox notification to complete posting via TikTok's editing flow. Maps to TikTok API `post_mode: \"MEDIA_UPLOAD\"` (photos) or the dedicated inbox endpoint (videos). When false or omitted, publishes directly via `post_mode: \"DIRECT_POST\"`. Note: `publish_type` is not a supported field. Use this field instead.  | [optional] |
 | **privacy_level** | **String** | One of the values returned by the TikTok creator info API for the account | [optional] |
 | **allow_comment** | **Boolean** | Allow comments on the post | [optional] |
 | **allow_duet** | **Boolean** | Allow duets (required for video posts) | [optional] |

data/lib/late-sdk/api/accounts_api.rb

@@ -83,23 +83,23 @@ module Late
     end
 
     # Disconnect ads from an account
-    # Disconnects ads from a social account without removing the posting connection.  **Same-token platforms** (metaads, linkedinads, pinterestads): Sets an `adsOptOut` flag. The posting account and OAuth token are preserved. Reconnecting ads clears the flag.  **Separate-token platforms** (tiktokads, xads): Clears the ads-specific metadata (marketing API tokens). The posting account stays intact.  **Standalone platforms** (googleads): Do not use this endpoint. Use `DELETE /v1/accounts/{accountId}` instead, since Google Ads accounts are standalone. 
-    # @param account_id [String] The SocialAccount ID (parent posting account for same-token/separate-token platforms)
-    # @param disconnect_ads_request [DisconnectAdsRequest] 
+    # **Deprecated.** Ads accounts are now standalone SocialAccount documents. Use `DELETE /v1/accounts/{accountId}` instead, passing the ads account's own ID.  This endpoint is kept for backward compatibility. It soft-deletes the ads SocialAccount identified by `accountId` (which must be an ads account, not a posting account). The parent posting account is left untouched. 
+    # @param account_id [String] The ads SocialAccount ID to disconnect
     # @param [Hash] opts the optional parameters
+    # @option opts [DisconnectAdsRequest] :disconnect_ads_request 
     # @return [DeleteAccountGroup200Response]
-    def disconnect_ads(account_id, disconnect_ads_request, opts = {})
-      data, _status_code, _headers = disconnect_ads_with_http_info(account_id, disconnect_ads_request, opts)
+    def disconnect_ads(account_id, opts = {})
+      data, _status_code, _headers = disconnect_ads_with_http_info(account_id, opts)
       data
     end
 
     # Disconnect ads from an account
-    # Disconnects ads from a social account without removing the posting connection.  **Same-token platforms** (metaads, linkedinads, pinterestads): Sets an `adsOptOut` flag. The posting account and OAuth token are preserved. Reconnecting ads clears the flag.  **Separate-token platforms** (tiktokads, xads): Clears the ads-specific metadata (marketing API tokens). The posting account stays intact.  **Standalone platforms** (googleads): Do not use this endpoint. Use `DELETE /v1/accounts/{accountId}` instead, since Google Ads accounts are standalone. 
-    # @param account_id [String] The SocialAccount ID (parent posting account for same-token/separate-token platforms)
-    # @param disconnect_ads_request [DisconnectAdsRequest] 
+    # **Deprecated.** Ads accounts are now standalone SocialAccount documents. Use `DELETE /v1/accounts/{accountId}` instead, passing the ads account's own ID.  This endpoint is kept for backward compatibility. It soft-deletes the ads SocialAccount identified by `accountId` (which must be an ads account, not a posting account). The parent posting account is left untouched. 
+    # @param account_id [String] The ads SocialAccount ID to disconnect
     # @param [Hash] opts the optional parameters
+    # @option opts [DisconnectAdsRequest] :disconnect_ads_request 
     # @return [Array<(DeleteAccountGroup200Response, Integer, Hash)>] DeleteAccountGroup200Response data, response status code and response headers
-    def disconnect_ads_with_http_info(account_id, disconnect_ads_request, opts = {})
+    def disconnect_ads_with_http_info(account_id, opts = {})
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: AccountsApi.disconnect_ads ...'
       end
@@ -107,10 +107,6 @@ module Late
       if @api_client.config.client_side_validation && account_id.nil?
         fail ArgumentError, "Missing the required parameter 'account_id' when calling AccountsApi.disconnect_ads"
       end
-      # verify the required parameter 'disconnect_ads_request' is set
-      if @api_client.config.client_side_validation && disconnect_ads_request.nil?
-        fail ArgumentError, "Missing the required parameter 'disconnect_ads_request' when calling AccountsApi.disconnect_ads"
-      end
       # resource path
       local_var_path = '/v1/accounts/{accountId}/disconnect-ads'.sub('{' + 'accountId' + '}', CGI.escape(account_id.to_s))
 
@@ -131,7 +127,7 @@ module Late
       form_params = opts[:form_params] || {}
 
       # http body (model)
-      post_body = opts[:debug_body] || @api_client.object_to_http_body(disconnect_ads_request)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(opts[:'disconnect_ads_request'])
 
       # return_type
       return_type = opts[:debug_return_type] || 'DeleteAccountGroup200Response'

data/lib/late-sdk/api/connect_api.rb

@@ -84,11 +84,11 @@ module Late
     end
 
     # Connect ads for a platform
-    # Unified ads connection endpoint. Handles all platforms through a single route:  **Same-token platforms** (facebook, instagram, linkedin, pinterest): If a posting account already exists, returns `alreadyConnected: true` immediately (no extra OAuth needed). If not, starts the normal OAuth flow, and the resulting account supports both posting and ads.  **Separate-token platforms** (tiktok, twitter): Requires an existing posting account (`accountId` param). If ads are already connected, returns `alreadyConnected: true`. Otherwise, starts the platform-specific marketing API OAuth flow.  **Ads-only platforms** (googleads): If a Google Ads account exists, returns `alreadyConnected: true`. Otherwise, starts the Google Ads OAuth flow.  Use the `adsStatus` field from `GET /v1/accounts` to check which accounts need ads connection. 
+    # Unified ads connection endpoint. Creates a dedicated ads SocialAccount for the specified platform.  **Same-token platforms** (facebook, instagram, linkedin, pinterest): Creates an ads SocialAccount (`metaads`, `linkedinads`, `pinterestads`) with a copied OAuth token from the parent posting account. If the ads account already exists, returns `alreadyConnected: true`. No extra OAuth needed.  **Separate-token platforms** (tiktok, twitter): Starts the platform-specific marketing API OAuth flow and creates an ads SocialAccount (`tiktokads`, `xads`) with its own token. Requires an existing posting account (`accountId` param). If the ads account already exists, returns `alreadyConnected: true`.  **Standalone platforms** (googleads): Starts the Google Ads OAuth flow and creates a standalone ads SocialAccount (`googleads`) with no parent. If the account already exists, returns `alreadyConnected: true`.  Ads accounts appear as regular SocialAccount documents with ads platform values (e.g., `metaads`, `tiktokads`) in `GET /v1/accounts`. 
     # @param platform [String] Platform to connect ads for. Only platforms with ads support are accepted.
     # @param profile_id [String] Your Zernio profile ID
     # @param [Hash] opts the optional parameters
-    # @option opts [String] :account_id Existing SocialAccount ID. Required for separate-token platforms (tiktok, twitter). Ignored for same-token and ads-only platforms.
+    # @option opts [String] :account_id Existing SocialAccount ID. Required for separate-token platforms (tiktok, twitter). Ignored for same-token and standalone platforms.
     # @option opts [String] :redirect_url Custom redirect URL after OAuth completes (same-token platforms only)
     # @option opts [Boolean] :headless Enable headless mode (same-token platforms only) (default to false)
     # @return [ConnectAds200Response]
@@ -98,11 +98,11 @@ module Late
     end
 
     # Connect ads for a platform
-    # Unified ads connection endpoint. Handles all platforms through a single route:  **Same-token platforms** (facebook, instagram, linkedin, pinterest): If a posting account already exists, returns `alreadyConnected: true` immediately (no extra OAuth needed). If not, starts the normal OAuth flow, and the resulting account supports both posting and ads.  **Separate-token platforms** (tiktok, twitter): Requires an existing posting account (`accountId` param). If ads are already connected, returns `alreadyConnected: true`. Otherwise, starts the platform-specific marketing API OAuth flow.  **Ads-only platforms** (googleads): If a Google Ads account exists, returns `alreadyConnected: true`. Otherwise, starts the Google Ads OAuth flow.  Use the `adsStatus` field from `GET /v1/accounts` to check which accounts need ads connection. 
+    # Unified ads connection endpoint. Creates a dedicated ads SocialAccount for the specified platform.  **Same-token platforms** (facebook, instagram, linkedin, pinterest): Creates an ads SocialAccount (`metaads`, `linkedinads`, `pinterestads`) with a copied OAuth token from the parent posting account. If the ads account already exists, returns `alreadyConnected: true`. No extra OAuth needed.  **Separate-token platforms** (tiktok, twitter): Starts the platform-specific marketing API OAuth flow and creates an ads SocialAccount (`tiktokads`, `xads`) with its own token. Requires an existing posting account (`accountId` param). If the ads account already exists, returns `alreadyConnected: true`.  **Standalone platforms** (googleads): Starts the Google Ads OAuth flow and creates a standalone ads SocialAccount (`googleads`) with no parent. If the account already exists, returns `alreadyConnected: true`.  Ads accounts appear as regular SocialAccount documents with ads platform values (e.g., `metaads`, `tiktokads`) in `GET /v1/accounts`. 
     # @param platform [String] Platform to connect ads for. Only platforms with ads support are accepted.
     # @param profile_id [String] Your Zernio profile ID
     # @param [Hash] opts the optional parameters
-    # @option opts [String] :account_id Existing SocialAccount ID. Required for separate-token platforms (tiktok, twitter). Ignored for same-token and ads-only platforms.
+    # @option opts [String] :account_id Existing SocialAccount ID. Required for separate-token platforms (tiktok, twitter). Ignored for same-token and standalone platforms.
     # @option opts [String] :redirect_url Custom redirect URL after OAuth completes (same-token platforms only)
     # @option opts [Boolean] :headless Enable headless mode (same-token platforms only) (default to false)
     # @return [Array<(ConnectAds200Response, Integer, Hash)>] ConnectAds200Response data, response status code and response headers

data/lib/late-sdk/models/account_with_follower_stats.rb

@@ -36,7 +36,13 @@ module Late
     # Last time follower count was updated (only included if user has analytics add-on)
     attr_accessor :followers_last_updated
 
-    # Ads connection status for this account. - `connected`: Ads are ready to use (same-token platforms like Meta/LinkedIn, or separate ads token is present). - `not_connected`: Platform supports ads but requires a separate ads OAuth. Use `GET /v1/connect/{platform}/ads` to connect. - `not_available`: Platform does not support ads (e.g., YouTube, Reddit, Bluesky). 
+    # Reference to the parent posting SocialAccount. Set for ads accounts that share or derive from a posting account's OAuth token. null for standalone ads (Google Ads) and all posting accounts. 
+    attr_accessor :parent_account_id
+
+    # Whether the user explicitly activated this account. false means the account was created as a side effect (e.g., posting account auto-created when user connected ads first). Posting UI and scheduler ignore accounts with enabled: false. 
+    attr_accessor :enabled
+
+    # **Deprecated.** With the new ads account model, ads accounts are separate SocialAccount documents. Check for accounts with ads platform values (metaads, linkedinads, pinterestads, tiktokads, xads, googleads) instead.  Legacy behavior: - `connected`: Ads are ready to use (same-token platforms like Meta/LinkedIn, or separate ads token is present). - `not_connected`: Platform supports ads but requires a separate ads OAuth. Use `GET /v1/connect/{platform}/ads` to connect. - `not_available`: Platform does not support ads (e.g., YouTube, Reddit, Bluesky). 
     attr_accessor :ads_status
 
     # Platform-specific metadata. Fields vary by platform. For WhatsApp accounts, includes: - `qualityRating`: Phone number quality rating from Meta (`GREEN`, `YELLOW`, `RED`, or `UNKNOWN`) - `nameStatus`: Display name review status (`APPROVED`, `PENDING_REVIEW`, `DECLINED`, or `NONE`). Messages cannot be sent until the display name is approved by Meta. - `messagingLimitTier`: Maximum unique business-initiated conversations per 24h rolling window (`TIER_250`, `TIER_1K`, `TIER_10K`, `TIER_100K`, or `TIER_UNLIMITED`). Scales automatically as quality rating improves. - `verifiedName`: Meta-verified business display name - `displayPhoneNumber`: Formatted phone number (e.g., \"+1 555-123-4567\") - `wabaId`: WhatsApp Business Account ID - `phoneNumberId`: Meta phone number ID 
@@ -94,6 +100,8 @@ module Late
         :'is_active' => :'isActive',
         :'followers_count' => :'followersCount',
         :'followers_last_updated' => :'followersLastUpdated',
+        :'parent_account_id' => :'parentAccountId',
+        :'enabled' => :'enabled',
         :'ads_status' => :'adsStatus',
         :'metadata' => :'metadata',
         :'profile_picture' => :'profilePicture',
@@ -128,6 +136,8 @@ module Late
         :'is_active' => :'Boolean',
         :'followers_count' => :'Float',
         :'followers_last_updated' => :'Time',
+        :'parent_account_id' => :'String',
+        :'enabled' => :'Boolean',
         :'ads_status' => :'String',
         :'metadata' => :'Object',
         :'profile_picture' => :'String',
@@ -205,6 +215,14 @@ module Late
         self.followers_last_updated = attributes[:'followers_last_updated']
       end
 
+      if attributes.key?(:'parent_account_id')
+        self.parent_account_id = attributes[:'parent_account_id']
+      end
+
+      if attributes.key?(:'enabled')
+        self.enabled = attributes[:'enabled']
+      end
+
       if attributes.key?(:'ads_status')
         self.ads_status = attributes[:'ads_status']
       end
@@ -254,11 +272,23 @@ module Late
     # @return true if the model is valid
     def valid?
       warn '[DEPRECATED] the `valid?` method is obsolete'
+      platform_validator = EnumAttributeValidator.new('String', ["tiktok", "instagram", "facebook", "youtube", "linkedin", "twitter", "threads", "pinterest", "reddit", "bluesky", "googlebusiness", "telegram", "snapchat", "whatsapp", "linkedinads", "metaads", "pinterestads", "tiktokads", "xads", "googleads"])
+      return false unless platform_validator.valid?(@platform)
       ads_status_validator = EnumAttributeValidator.new('String', ["connected", "not_connected", "not_available"])
       return false unless ads_status_validator.valid?(@ads_status)
       true
     end
 
+    # Custom attribute writer method checking allowed values (enum).
+    # @param [Object] platform Object to be assigned
+    def platform=(platform)
+      validator = EnumAttributeValidator.new('String', ["tiktok", "instagram", "facebook", "youtube", "linkedin", "twitter", "threads", "pinterest", "reddit", "bluesky", "googlebusiness", "telegram", "snapchat", "whatsapp", "linkedinads", "metaads", "pinterestads", "tiktokads", "xads", "googleads"])
+      unless validator.valid?(platform)
+        fail ArgumentError, "invalid value for \"platform\", must be one of #{validator.allowable_values}."
+      end
+      @platform = platform
+    end
+
     # Custom attribute writer method checking allowed values (enum).
     # @param [Object] ads_status Object to be assigned
     def ads_status=(ads_status)
@@ -283,6 +313,8 @@ module Late
           is_active == o.is_active &&
           followers_count == o.followers_count &&
           followers_last_updated == o.followers_last_updated &&
+          parent_account_id == o.parent_account_id &&
+          enabled == o.enabled &&
           ads_status == o.ads_status &&
           metadata == o.metadata &&
           profile_picture == o.profile_picture &&
@@ -303,7 +335,7 @@ module Late
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [_id, platform, profile_id, username, display_name, profile_url, is_active, followers_count, followers_last_updated, ads_status, metadata, profile_picture, current_followers, last_updated, growth, growth_percentage, data_points, account_stats].hash
+      [_id, platform, profile_id, username, display_name, profile_url, is_active, followers_count, followers_last_updated, parent_account_id, enabled, ads_status, metadata, profile_picture, current_followers, last_updated, growth, growth_percentage, data_points, account_stats].hash
     end
 
     # Builds the object from hash

data/lib/late-sdk/models/disconnect_ads_request.rb

@@ -15,7 +15,7 @@ require 'time'
 
 module Late
   class DisconnectAdsRequest < ApiModelBase
-    # The ads platform to disconnect
+    # The ads platform (optional, used for logging only)
     attr_accessor :ads_platform
 
     class EnumAttributeValidator
@@ -88,8 +88,6 @@ module Late
 
       if attributes.key?(:'ads_platform')
         self.ads_platform = attributes[:'ads_platform']
-      else
-        self.ads_platform = nil
       end
     end
 
@@ -98,10 +96,6 @@ module Late
     def list_invalid_properties
       warn '[DEPRECATED] the `list_invalid_properties` method is obsolete'
       invalid_properties = Array.new
-      if @ads_platform.nil?
-        invalid_properties.push('invalid value for "ads_platform", ads_platform cannot be nil.')
-      end
-
       invalid_properties
     end
 
@@ -109,7 +103,6 @@ module Late
     # @return true if the model is valid
     def valid?
       warn '[DEPRECATED] the `valid?` method is obsolete'
-      return false if @ads_platform.nil?
       ads_platform_validator = EnumAttributeValidator.new('String', ["metaads", "linkedinads", "pinterestads", "tiktokads", "xads"])
       return false unless ads_platform_validator.valid?(@ads_platform)
       true

data/lib/late-sdk/models/social_account.rb

@@ -36,7 +36,13 @@ module Late
     # Last time follower count was updated (only included if user has analytics add-on)
     attr_accessor :followers_last_updated
 
-    # Ads connection status for this account. - `connected`: Ads are ready to use (same-token platforms like Meta/LinkedIn, or separate ads token is present). - `not_connected`: Platform supports ads but requires a separate ads OAuth. Use `GET /v1/connect/{platform}/ads` to connect. - `not_available`: Platform does not support ads (e.g., YouTube, Reddit, Bluesky). 
+    # Reference to the parent posting SocialAccount. Set for ads accounts that share or derive from a posting account's OAuth token. null for standalone ads (Google Ads) and all posting accounts. 
+    attr_accessor :parent_account_id
+
+    # Whether the user explicitly activated this account. false means the account was created as a side effect (e.g., posting account auto-created when user connected ads first). Posting UI and scheduler ignore accounts with enabled: false. 
+    attr_accessor :enabled
+
+    # **Deprecated.** With the new ads account model, ads accounts are separate SocialAccount documents. Check for accounts with ads platform values (metaads, linkedinads, pinterestads, tiktokads, xads, googleads) instead.  Legacy behavior: - `connected`: Ads are ready to use (same-token platforms like Meta/LinkedIn, or separate ads token is present). - `not_connected`: Platform supports ads but requires a separate ads OAuth. Use `GET /v1/connect/{platform}/ads` to connect. - `not_available`: Platform does not support ads (e.g., YouTube, Reddit, Bluesky). 
     attr_accessor :ads_status
 
     # Platform-specific metadata. Fields vary by platform. For WhatsApp accounts, includes: - `qualityRating`: Phone number quality rating from Meta (`GREEN`, `YELLOW`, `RED`, or `UNKNOWN`) - `nameStatus`: Display name review status (`APPROVED`, `PENDING_REVIEW`, `DECLINED`, or `NONE`). Messages cannot be sent until the display name is approved by Meta. - `messagingLimitTier`: Maximum unique business-initiated conversations per 24h rolling window (`TIER_250`, `TIER_1K`, `TIER_10K`, `TIER_100K`, or `TIER_UNLIMITED`). Scales automatically as quality rating improves. - `verifiedName`: Meta-verified business display name - `displayPhoneNumber`: Formatted phone number (e.g., \"+1 555-123-4567\") - `wabaId`: WhatsApp Business Account ID - `phoneNumberId`: Meta phone number ID 
@@ -76,6 +82,8 @@ module Late
         :'is_active' => :'isActive',
         :'followers_count' => :'followersCount',
         :'followers_last_updated' => :'followersLastUpdated',
+        :'parent_account_id' => :'parentAccountId',
+        :'enabled' => :'enabled',
         :'ads_status' => :'adsStatus',
         :'metadata' => :'metadata'
       }
@@ -103,6 +111,8 @@ module Late
         :'is_active' => :'Boolean',
         :'followers_count' => :'Float',
         :'followers_last_updated' => :'Time',
+        :'parent_account_id' => :'String',
+        :'enabled' => :'Boolean',
         :'ads_status' => :'String',
         :'metadata' => :'Object'
       }
@@ -166,6 +176,14 @@ module Late
         self.followers_last_updated = attributes[:'followers_last_updated']
       end
 
+      if attributes.key?(:'parent_account_id')
+        self.parent_account_id = attributes[:'parent_account_id']
+      end
+
+      if attributes.key?(:'enabled')
+        self.enabled = attributes[:'enabled']
+      end
+
       if attributes.key?(:'ads_status')
         self.ads_status = attributes[:'ads_status']
       end
@@ -187,11 +205,23 @@ module Late
     # @return true if the model is valid
     def valid?
       warn '[DEPRECATED] the `valid?` method is obsolete'
+      platform_validator = EnumAttributeValidator.new('String', ["tiktok", "instagram", "facebook", "youtube", "linkedin", "twitter", "threads", "pinterest", "reddit", "bluesky", "googlebusiness", "telegram", "snapchat", "whatsapp", "linkedinads", "metaads", "pinterestads", "tiktokads", "xads", "googleads"])
+      return false unless platform_validator.valid?(@platform)
       ads_status_validator = EnumAttributeValidator.new('String', ["connected", "not_connected", "not_available"])
       return false unless ads_status_validator.valid?(@ads_status)
       true
     end
 
+    # Custom attribute writer method checking allowed values (enum).
+    # @param [Object] platform Object to be assigned
+    def platform=(platform)
+      validator = EnumAttributeValidator.new('String', ["tiktok", "instagram", "facebook", "youtube", "linkedin", "twitter", "threads", "pinterest", "reddit", "bluesky", "googlebusiness", "telegram", "snapchat", "whatsapp", "linkedinads", "metaads", "pinterestads", "tiktokads", "xads", "googleads"])
+      unless validator.valid?(platform)
+        fail ArgumentError, "invalid value for \"platform\", must be one of #{validator.allowable_values}."
+      end
+      @platform = platform
+    end
+
     # Custom attribute writer method checking allowed values (enum).
     # @param [Object] ads_status Object to be assigned
     def ads_status=(ads_status)
@@ -216,6 +246,8 @@ module Late
           is_active == o.is_active &&
           followers_count == o.followers_count &&
           followers_last_updated == o.followers_last_updated &&
+          parent_account_id == o.parent_account_id &&
+          enabled == o.enabled &&
           ads_status == o.ads_status &&
           metadata == o.metadata
     end
@@ -229,7 +261,7 @@ module Late
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [_id, platform, profile_id, username, display_name, profile_url, is_active, followers_count, followers_last_updated, ads_status, metadata].hash
+      [_id, platform, profile_id, username, display_name, profile_url, is_active, followers_count, followers_last_updated, parent_account_id, enabled, ads_status, metadata].hash
     end
 
     # Builds the object from hash

data/lib/late-sdk/models/tik_tok_platform_data.rb

@@ -14,9 +14,9 @@ require 'date'
 require 'time'
 
 module Late
-  # Photo carousels up to 35 images. Video titles up to 2200 chars, photo titles truncated to 90 chars. privacyLevel must match creator_info options. Both camelCase and snake_case accepted.
+  # Photo carousels up to 35 images. Video titles up to 2200 chars, photo titles truncated to 90 chars. privacyLevel must match creator_info options. Both camelCase and snake_case accepted.  **Creator Inbox (draft mode):** Set `draft: true` to send content to the TikTok Creator Inbox instead of publishing immediately. The creator receives an inbox notification and completes the post using TikTok's editing flow. This maps to TikTok's `post_mode: \"MEDIA_UPLOAD\"` internally.  **Important:** The field `publish_type` is NOT supported. Use `draft: true` for Creator Inbox flow.  **Photo drafts** use the `/v2/post/publish/content/init/` endpoint with `post_mode: \"MEDIA_UPLOAD\"`. **Video drafts** use the dedicated `/v2/post/publish/inbox/video/init/` endpoint.  When `draft: true`, the `video.upload` scope is required. When `draft` is false or omitted (direct post), the `video.publish` scope is required. For Creator Inbox, TikTok app version must be 31.8 or higher. 
   class TikTokPlatformData < ApiModelBase
-    # When true, sends the post to the TikTok Creator Inbox as a draft instead of publishing immediately.
+    # When true, sends the post to the TikTok Creator Inbox as a draft instead of publishing immediately. The creator receives an inbox notification to complete posting via TikTok's editing flow. Maps to TikTok API `post_mode: \"MEDIA_UPLOAD\"` (photos) or the dedicated inbox endpoint (videos). When false or omitted, publishes directly via `post_mode: \"DIRECT_POST\"`. Note: `publish_type` is not a supported field. Use this field instead. 
     attr_accessor :draft
 
     # One of the values returned by the TikTok creator info API for the account

data/lib/late-sdk/version.rb

@@ -11,5 +11,5 @@ Generator version: 7.19.0
 =end
 
 module Late
-  VERSION = '0.0.122'
+  VERSION = '0.0.123'
 end