upload-post 2.4.0 → 2.5.0

package/README.md

@@ -321,6 +321,38 @@ These options work across all upload methods:
 | `autogenerateLanguage` | Force the AI output language (ISO code); omit to auto-detect from the media |
 | `idempotencyKey` | Collapses duplicate uploads within 24h. Reuse the same value when retrying. Alias: `requestId` |
 
+## Google Business Profile
+
+Pass the target location on the upload itself. There is no separate "select a location" call — the API resolves the location per post.
+
+```javascript
+const { locations } = await client.getGoogleBusinessLocations('myprofile');
+
+await client.upload('video.mp4', {
+  user: 'myprofile',
+  platforms: ['google_business'],
+  title: 'Now open on Sundays',
+  gbpLocationId: locations[0].name,   // "accounts/123/locations/456"
+});
+```
+
+`gbpLocationId` is **required when the account has more than one location** — the API only auto-selects when exactly one exists. Beyond a standard post you can publish an event or an offer:
+
+```javascript
+await client.uploadText({
+  user: 'myprofile',
+  platforms: ['google_business'],
+  title: 'Summer sale',
+  gbpLocationId: locations[0].name,
+  gbpTopicType: 'OFFER',
+  gbpOfferCoupon: 'SUMMER25',
+  gbpOfferRedeemUrl: 'https://example.com/redeem',
+  gbpOfferTerms: 'One per customer',
+});
+```
+
+Also available: `gbpTopicType: 'EVENT'` with `gbpEventTitle` / `gbpEventStartDate` / `gbpEventStartTime` / `gbpEventEndDate` / `gbpEventEndTime`, a call-to-action via `gbpCtaType` + `gbpCtaUrl`, and `gbpMediaUrl` / `gbpMediaFormat`.
+
 ## Retrying an upload safely
 
 An upload that times out may still have been accepted by the API. Retrying it without an idempotency key publishes the post a second time.

package/index.d.ts

@@ -349,6 +349,37 @@ declare module 'upload-post' {
 
   // ==================== Combined Upload Options ====================
 
+  export interface GoogleBusinessOptions {
+    /** Google Business location id, e.g. "accounts/123/locations/456". Required when the account has more than one location; the API auto-selects only for single-location accounts. List them with getGoogleBusinessLocations(). */
+    gbpLocationId?: string;
+    /** Post type. Defaults to STANDARD. */
+    gbpTopicType?: 'STANDARD' | 'EVENT' | 'OFFER';
+    /** Media URL attached to the post */
+    gbpMediaUrl?: string;
+    /** Media format */
+    gbpMediaFormat?: 'PHOTO' | 'VIDEO';
+    /** Call-to-action button */
+    gbpCtaType?: 'BOOK' | 'ORDER' | 'SHOP' | 'LEARN_MORE' | 'SIGN_UP' | 'CALL';
+    /** URL the call-to-action button opens */
+    gbpCtaUrl?: string;
+    /** Event title. Used when gbpTopicType is EVENT. */
+    gbpEventTitle?: string;
+    /** Event start date, YYYY-MM-DD */
+    gbpEventStartDate?: string;
+    /** Event start time, HH:MM */
+    gbpEventStartTime?: string;
+    /** Event end date, YYYY-MM-DD */
+    gbpEventEndDate?: string;
+    /** Event end time, HH:MM */
+    gbpEventEndTime?: string;
+    /** Offer coupon code. Used when gbpTopicType is OFFER. */
+    gbpOfferCoupon?: string;
+    /** URL to redeem the offer */
+    gbpOfferRedeemUrl?: string;
+    /** Offer terms and conditions */
+    gbpOfferTerms?: string;
+  }
+
   export interface UploadVideoOptions extends CommonUploadOptions,
     TikTokVideoOptions,
     InstagramVideoOptions,
@@ -357,7 +388,9 @@ declare module 'upload-post' {
     FacebookVideoOptions,
     PinterestVideoOptions,
     XMediaOptions,
-    ThreadsOptions {
+    ThreadsOptions,
+    RedditOptions,
+    GoogleBusinessOptions {
     /** Target platforms */
     platforms: VideoPlatform[];
   }
@@ -370,7 +403,8 @@ declare module 'upload-post' {
     PinterestPhotoOptions,
     XMediaOptions,
     ThreadsOptions,
-    RedditOptions {
+    RedditOptions,
+    GoogleBusinessOptions {
     /** Target platforms */
     platforms: PhotoPlatform[];
   }
@@ -390,7 +424,8 @@ declare module 'upload-post' {
     XTextOptions,
     ThreadsOptions,
     RedditOptions,
-    LinkPreviewOptions {
+    LinkPreviewOptions,
+    GoogleBusinessOptions {
     /** Target platforms */
     platforms: TextPlatform[];
   }
@@ -721,7 +756,19 @@ declare module 'upload-post' {
      * Update notification configuration (including webhook settings)
      * @param options - Notification config options
      */
-    updateNotificationConfig(options?: { webhookEvents?: string[]; webhookUrl?: string }): Promise<{ success: boolean; config?: { webhook_events?: string[]; webhook_url?: string; [key: string]: any } }>;
+    updateNotificationConfig(options?: {
+      webhookEvents?: string[];
+      webhookUrl?: string;
+      channels?: string[];
+      telegramChatId?: string;
+      slackWebhookUrl?: string;
+      whatsappToPhone?: string;
+    }): Promise<{ success: boolean; config?: { webhook_events?: string[]; webhook_url?: string; [key: string]: any } }>;
+
+    /**
+     * Send a test notification through the configured channels
+     */
+    testNotifications(): Promise<{ success: boolean; [key: string]: any }>;
 
     // Instagram Comments
 

package/index.js

@@ -333,6 +333,30 @@ export class UploadPost {
     if (options.threadsTopicTag) form.append('threads_topic_tag', options.threadsTopicTag);
   }
 
+  /**
+   * Add Google Business Profile parameters
+   *
+   * gbpLocationId is required for accounts with more than one location; the API
+   * only auto-selects when exactly one location exists.
+   * @private
+   */
+  _addGoogleBusinessParams(form, options) {
+    if (options.gbpLocationId) form.append('gbp_location_id', options.gbpLocationId);
+    if (options.gbpTopicType) form.append('gbp_topic_type', String(options.gbpTopicType).toUpperCase());
+    if (options.gbpMediaUrl) form.append('gbp_media_url', options.gbpMediaUrl);
+    if (options.gbpMediaFormat) form.append('gbp_media_format', String(options.gbpMediaFormat).toUpperCase());
+    if (options.gbpCtaType) form.append('gbp_cta_type', String(options.gbpCtaType).toUpperCase());
+    if (options.gbpCtaUrl) form.append('gbp_cta_url', options.gbpCtaUrl);
+    if (options.gbpEventTitle) form.append('gbp_event_title', options.gbpEventTitle);
+    if (options.gbpEventStartDate) form.append('gbp_event_start_date', options.gbpEventStartDate);
+    if (options.gbpEventStartTime) form.append('gbp_event_start_time', options.gbpEventStartTime);
+    if (options.gbpEventEndDate) form.append('gbp_event_end_date', options.gbpEventEndDate);
+    if (options.gbpEventEndTime) form.append('gbp_event_end_time', options.gbpEventEndTime);
+    if (options.gbpOfferCoupon) form.append('gbp_offer_coupon', options.gbpOfferCoupon);
+    if (options.gbpOfferRedeemUrl) form.append('gbp_offer_redeem_url', options.gbpOfferRedeemUrl);
+    if (options.gbpOfferTerms) form.append('gbp_offer_terms', options.gbpOfferTerms);
+  }
+
   /**
    * Add Reddit-specific parameters
    * @private
@@ -457,6 +481,7 @@ export class UploadPost {
     if (platforms.includes('x')) this._addXParams(form, options, false);
     if (platforms.includes('threads')) this._addThreadsParams(form, options);
     if (platforms.includes('reddit')) this._addRedditParams(form, options);
+    if (platforms.includes('google_business')) this._addGoogleBusinessParams(form, options);
 
     return this._request('/upload', 'POST', form, true, this._idempotencyHeaders(options));
   }
@@ -545,6 +570,7 @@ export class UploadPost {
     if (platforms.includes('x')) this._addXParams(form, options, false);
     if (platforms.includes('threads')) this._addThreadsParams(form, options);
     if (platforms.includes('reddit')) this._addRedditParams(form, options);
+    if (platforms.includes('google_business')) this._addGoogleBusinessParams(form, options);
 
     return this._request('/upload_photos', 'POST', form, true, this._idempotencyHeaders(options));
   }
@@ -612,6 +638,7 @@ export class UploadPost {
     if (platforms.includes('bluesky') && (options.blueskyLinkUrl || options.linkUrl)) {
       form.append('bluesky_link_url', options.blueskyLinkUrl || options.linkUrl);
     }
+    if (platforms.includes('google_business')) this._addGoogleBusinessParams(form, options);
 
     return this._request('/upload_text', 'POST', form, true, this._idempotencyHeaders(options));
   }
@@ -967,9 +994,22 @@ export class UploadPost {
     const body = {};
     if (options.webhookEvents) body.webhook_events = options.webhookEvents;
     if (options.webhookUrl) body.webhook_url = options.webhookUrl;
+    if (options.channels) body.channels = options.channels;
+    if (options.telegramChatId) body.telegram_chat_id = options.telegramChatId;
+    if (options.slackWebhookUrl) body.slack_webhook_url = options.slackWebhookUrl;
+    if (options.whatsappToPhone) body.whatsapp_to_phone = options.whatsappToPhone;
     return this._request('/uploadposts/users/notifications', 'POST', body);
   }
 
+  /**
+   * Send a test notification through the configured channels
+   *
+   * @returns {Promise<Object>} Test result
+   */
+  async testNotifications() {
+    return this._request('/uploadposts/users/notifications/test', 'POST', {});
+  }
+
   // ==================== Instagram Comments ====================
 
   /**
@@ -1077,10 +1117,11 @@ export class UploadPost {
    * @param {string} [profile] - Profile username
    * @returns {Promise<Object>} Selection result with google_business_id and display_name
    */
-  async selectGoogleBusinessLocation(locationId, profile) {
-    const data = { location_id: locationId };
-    if (profile) data.profile = profile;
-    return this._request('/uploadposts/google-business/locations/select', 'POST', data);
+  async selectGoogleBusinessLocation() {
+    throw new Error(
+      'selectGoogleBusinessLocation is not supported: the API has no persistent location selection. ' +
+      'Pass gbpLocationId on the upload instead (list ids with getGoogleBusinessLocations).'
+    );
   }
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "upload-post",
-  "version": "2.4.0",
+  "version": "2.5.0",
   "description": "Official client library for Upload-Post API - Cross-platform social media upload for TikTok, Instagram, YouTube, LinkedIn, Facebook, Pinterest, Threads, Reddit, Bluesky, and X (Twitter)",
   "main": "index.js",
   "types": "index.d.ts",