@graph8/sdk 0.251.0 → 0.262.0

package/docs/api/integrations.d.ts

@@ -0,0 +1,2327 @@
+/* Generated by sdk/js/scripts/generate-agent-docs.ts from developer-contract/openapi.json. Regenerated on every build. */
+
+/**
+ * Types for `g8.api.integrations` (Integrations): 83 operations.
+ *
+ * For reading. In code, import from the package instead:
+ *   import type { ApiInput, ApiOutput, G8Contract } from "@graph8/sdk";
+ *   type In = ApiInput<"batch_create_crm_contacts_integrations_crm_connections__connection_id__batch_contacts_post">;
+ *
+ * Reference with examples: integrations.md
+ */
+/* eslint-disable */
+
+/** `g8.api.integrations.<member>` -> the operationId it calls. */
+export interface IntegrationsMembers {
+  batchCreateCrmContacts: "batch_create_crm_contacts_integrations_crm_connections__connection_id__batch_contacts_post";
+  batchUpdateCrmContacts: "batch_update_crm_contacts_integrations_crm_connections__connection_id__batch_contacts_put";
+  cancelMigration: "cancel_migration_integrations_migrations__migration_id__cancel_post";
+  confirmMigration: "confirm_migration_integrations_migrations__migration_id__confirm_post";
+  connectSugarcrm: "connect_sugarcrm_integrations_sugarcrm_connect_post";
+  createConnectionSessionToken: "create_connection_session_token_integrations_connections_session_token_post";
+  createCrmCompany: "create_crm_company_integrations_crm_connections__connection_id__companies_post";
+  createCrmContact: "create_crm_contact_integrations_crm_connections__connection_id__contacts_post";
+  createCrmDeal: "create_crm_deal_integrations_crm_connections__connection_id__deals_post";
+  createCrmLead: "create_crm_lead_integrations_crm_connections__connection_id__leads_post";
+  createCrmMeeting: "create_crm_meeting_integrations_crm_meetings_post";
+  createGoogleConversionAction: "create_google_conversion_action_audience_syncs_google_conversion_actions_post";
+  createVideoUploadUrl: "create_video_upload_url_audience_syncs_google_video_assets_upload_urls_post";
+  deleteConnection: "delete_connection_integrations_connections__connection_id__delete";
+  deleteCrmContact: "delete_crm_contact_integrations_crm_connections__connection_id__contacts__contact_id__delete";
+  discardDraftSyncConfig: "discard_draft_sync_config_audience_syncs__config_id__draft_delete";
+  disconnectSugarcrm: "disconnect_sugarcrm_integrations_sugarcrm_delete";
+  discoverCrmFields: "discover_crm_fields_integrations_crm_fields_get";
+  findCrmUserByEmail: "find_crm_user_by_email_integrations_crm_users_by_email_get";
+  getAdAnalyticsSummary: "get_ad_analytics_summary_audience_syncs_analytics_summary_get";
+  getAdDailyTrend: "get_ad_daily_trend_audience_syncs_analytics_daily_trend_get";
+  getCrmCompany: "get_crm_company_integrations_crm_connections__connection_id__companies__company_id__get";
+  getCrmConnection: "get_crm_connection_integrations_crm_connections__connection_id__get";
+  getCrmConnectionMetadata: "get_crm_connection_metadata_integrations_crm_connections__connection_id__metadata_get";
+  getCrmConnectionStatus: "get_crm_connection_status_integrations_crm_connections__connection_id__status_get";
+  getCrmContact: "get_crm_contact_integrations_crm_connections__connection_id__contacts__contact_id__get";
+  getCrmDeal: "get_crm_deal_integrations_crm_connections__connection_id__deals__deal_id__get";
+  getCrmLead: "get_crm_lead_integrations_crm_connections__connection_id__leads__lead_id__get";
+  getGoogleConversionTracking: "get_google_conversion_tracking_audience_syncs_google_conversion_tracking_get";
+  getLastCompletedMigration: "get_last_completed_migration_integrations_connections__connection_id__last_migration_get";
+  getMigrationStatus: "get_migration_status_integrations_migrations__migration_id__get";
+  getOrCreateCrmAudience: "get_or_create_crm_audience_integrations_crm_sync_audiences_post";
+  getOrCreateCrmList: "get_or_create_crm_list_integrations_crm_lists_post";
+  getSyncConfigAnalytics: "get_sync_config_analytics_audience_syncs__config_id__analytics_get";
+  getSyncJob: "get_sync_job_integrations_crm_sync_jobs__job_id__get";
+  getSyncSegmentStatus: "get_sync_segment_status_audience_syncs__config_id__segment_status_get";
+  getVideoAsset: "get_video_asset_audience_syncs_google_video_assets__asset_id__get";
+  listAdAccountHealth: "list_ad_account_health_audience_syncs_account_health_get";
+  listAdAccounts: "list_ad_accounts_audience_syncs_accounts_get";
+  listAdPlatforms: "list_ad_platforms_audience_syncs_platforms_get";
+  listCompanyActivitiesByGraph8Id: "list_company_activities_by_graph8_id_integrations_crm_company_activities_get";
+  listConnections: "list_connections_integrations_connections_get";
+  listContactActivitiesByGraph8Id: "list_contact_activities_by_graph8_id_integrations_crm_contact_activities_get";
+  listCrmActivities: "list_crm_activities_integrations_crm_activities_get";
+  listCrmCompanies: "list_crm_companies_integrations_crm_connections__connection_id__companies_get";
+  listCrmContactActivities: "list_crm_contact_activities_integrations_crm_connections__connection_id__contacts__contact_id__activities_get";
+  listCrmContacts: "list_crm_contacts_integrations_crm_connections__connection_id__contacts_get";
+  listCrmDeals: "list_crm_deals_integrations_crm_connections__connection_id__deals_get";
+  listCrmLeads: "list_crm_leads_integrations_crm_connections__connection_id__leads_get";
+  listCrmLists: "list_crm_lists_integrations_crm_lists_get";
+  listCrmMeetings: "list_crm_meetings_integrations_crm_meetings_get";
+  listCrmUsers: "list_crm_users_integrations_crm_users_get";
+  listLeadStatuses: "list_lead_statuses_integrations_crm_sync_leads_statuses_get";
+  listMappableGraph8Fields: "list_mappable_graph8_fields_integrations_crm_fields_mappable_get";
+  listVideoAssets: "list_video_assets_audience_syncs_google_video_assets_get";
+  lookupCrmContactsByEmail: "lookup_crm_contacts_by_email_integrations_crm_connections__connection_id__batch_contacts_lookup_by_email_post";
+  modifyCrmListMemberships: "modify_crm_list_memberships_integrations_crm_lists_memberships_post";
+  previewLeadPush: "preview_lead_push_integrations_crm_sync_leads_push_preview_get";
+  pullAllContacts: "pull_all_contacts_integrations_crm_sync_contacts_pull_post";
+  pullAllDeals: "pull_all_deals_integrations_crm_sync_deals_pull_post";
+  pullAllLeads: "pull_all_leads_integrations_crm_sync_leads_pull_post";
+  pullCrmList: "pull_crm_list_integrations_crm_sync_pull_post";
+  pushAllContacts: "push_all_contacts_integrations_crm_sync_contacts_push_post";
+  pushAllDeals: "push_all_deals_integrations_crm_sync_deals_push_post";
+  pushAllLeads: "push_all_leads_integrations_crm_sync_leads_push_post";
+  pushAudience: "push_audience_integrations_crm_sync_push_post";
+  reconnectSugarcrm: "reconnect_sugarcrm_integrations_sugarcrm_reconnect_post";
+  registerUploadedVideoAsset: "register_uploaded_video_asset_audience_syncs_google_video_assets_uploads_post";
+  registerVideoAssetFromLibrary: "register_video_asset_from_library_audience_syncs_google_video_assets_library_post";
+  registerVideoAssetFromLink: "register_video_asset_from_link_audience_syncs_google_video_assets_links_post";
+  saveConnection: "save_connection_integrations_connections_post";
+  setPullSyncEnabled: "set_pull_sync_enabled_integrations_crm_sync_pull_enabled_put";
+  setPushSyncEnabled: "set_push_sync_enabled_integrations_crm_sync_push_enabled_put";
+  startDeltaSync: "start_delta_sync_integrations_migrations_delta_sync_post";
+  startLeadPreview: "start_lead_preview_integrations_crm_sync_leads_previews_post";
+  startMigrationDiscovery: "start_migration_discovery_integrations_migrations_discovery_post";
+  updateCrmCompany: "update_crm_company_integrations_crm_connections__connection_id__companies__company_id__put";
+  updateCrmContact: "update_crm_contact_integrations_crm_connections__connection_id__contacts__contact_id__put";
+  updateCrmDeal: "update_crm_deal_integrations_crm_connections__connection_id__deals__deal_id__put";
+  updateCrmLead: "update_crm_lead_integrations_crm_connections__connection_id__leads__lead_id__put";
+  updateCrmMeeting: "update_crm_meeting_integrations_crm_meetings__event_id__patch";
+  uploadGoogleConversions: "upload_google_conversions_audience_syncs_google_conversions_post";
+  validateSugarcrm: "validate_sugarcrm_integrations_sugarcrm_validate_post";
+}
+
+/** Input and output of every `g8.api.integrations` operation, keyed by operationId. */
+export interface IntegrationsOperations {
+  /**
+   * POST /integrations/crm/connections/{connection_id}/batch/contacts
+   * Batch Create Crm Contacts
+   * tier: external · scope: integrations:run
+   */
+  batch_create_crm_contacts_integrations_crm_connections__connection_id__batch_contacts_post: {
+    input: {
+    path: {
+      /** The CRM connection to act through. */
+      connection_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: BatchContactsRequest;
+  };
+    output: ApiResponse_CrmPayload_;
+  };
+  /**
+   * PUT /integrations/crm/connections/{connection_id}/batch/contacts
+   * Batch Update Crm Contacts
+   * tier: external · scope: integrations:run
+   */
+  batch_update_crm_contacts_integrations_crm_connections__connection_id__batch_contacts_put: {
+    input: {
+    path: {
+      /** The CRM connection to act through. */
+      connection_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: BatchContactsRequest;
+  };
+    output: ApiResponse_CrmPayload_;
+  };
+  /**
+   * POST /integrations/migrations/{migration_id}/cancel
+   * Cancel Migration
+   * tier: destructive · scope: integrations:delete
+   */
+  cancel_migration_integrations_migrations__migration_id__cancel_post: {
+    input: {
+    path: {
+      /** Migration id. */
+      migration_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_ConnectionPayload_;
+  };
+  /**
+   * POST /integrations/migrations/{migration_id}/confirm
+   * Confirm Migration
+   * tier: external · scope: integrations:run
+   */
+  confirm_migration_integrations_migrations__migration_id__confirm_post: {
+    input: {
+    path: {
+      /** Migration id from discovery. */
+      migration_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body?: ConfirmMigrationRequest;
+  };
+    output: ApiResponse_ConnectionPayload_;
+  };
+  /**
+   * POST /integrations/sugarcrm/connect
+   * Connect Sugarcrm
+   * tier: external · scope: integrations:run
+   */
+  connect_sugarcrm_integrations_sugarcrm_connect_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: SugarCrmConnectRequest;
+  };
+    output: ApiResponse_IntegrationOpPayload_;
+  };
+  /**
+   * POST /integrations/connections/session-token
+   * Create Connection Session Token
+   * tier: external · scope: integrations:run
+   */
+  create_connection_session_token_integrations_connections_session_token_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body?: SessionTokenRequest | null;
+  };
+    output: ApiResponse_ConnectionPayload_;
+  };
+  /**
+   * POST /integrations/crm/connections/{connection_id}/companies
+   * Create Crm Company
+   * tier: external · scope: integrations:run
+   */
+  create_crm_company_integrations_crm_connections__connection_id__companies_post: {
+    input: {
+    path: {
+      /** The CRM connection to act through. */
+      connection_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: CrmCompanyCreateRequest;
+  };
+    output: ApiResponse_CrmPayload_;
+  };
+  /**
+   * POST /integrations/crm/connections/{connection_id}/contacts
+   * Create Crm Contact
+   * tier: external · scope: integrations:run
+   */
+  create_crm_contact_integrations_crm_connections__connection_id__contacts_post: {
+    input: {
+    path: {
+      /** The CRM connection to act through. */
+      connection_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: CrmContactCreateRequest;
+  };
+    output: ApiResponse_CrmPayload_;
+  };
+  /**
+   * POST /integrations/crm/connections/{connection_id}/deals
+   * Create Crm Deal
+   * tier: external · scope: integrations:run
+   */
+  create_crm_deal_integrations_crm_connections__connection_id__deals_post: {
+    input: {
+    path: {
+      /** The CRM connection to act through. */
+      connection_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: CrmDealCreateRequest;
+  };
+    output: ApiResponse_CrmPayload_;
+  };
+  /**
+   * POST /integrations/crm/connections/{connection_id}/leads
+   * Create Crm Lead
+   * tier: external · scope: integrations:run
+   */
+  create_crm_lead_integrations_crm_connections__connection_id__leads_post: {
+    input: {
+    path: {
+      /** The CRM connection to act through. */
+      connection_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: LeadCreateRequest;
+  };
+    output: ApiResponse_CrmPayload_;
+  };
+  /**
+   * POST /integrations/crm/meetings
+   * Create Crm Meeting
+   * tier: external · scope: integrations:run
+   */
+  create_crm_meeting_integrations_crm_meetings_post: {
+    input: {
+    query: {
+      connection_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: CreateMeetingRequest;
+  };
+    output: ApiResponse_CrmPayload_;
+  };
+  /**
+   * POST /audience-syncs/google/conversion-actions
+   * Create Google Conversion Action
+   * tier: external · scope: integrations:run
+   */
+  create_google_conversion_action_audience_syncs_google_conversion_actions_post: {
+    input: {
+    query?: {
+      ad_account_id?: string | null;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body?: CreateConversionActionRequest | null;
+  };
+    output: ApiResponse_AdPayload_;
+  };
+  /**
+   * POST /audience-syncs/google/video-assets/upload-urls
+   * Create Video Upload Url
+   * tier: external · scope: integrations:run
+   */
+  create_video_upload_url_audience_syncs_google_video_assets_upload_urls_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: CreateVideoUploadUrlRequest;
+  };
+    output: ApiResponse_AdPayload_;
+  };
+  /**
+   * DELETE /integrations/connections/{connection_id}
+   * Delete Connection
+   * tier: destructive · scope: integrations:delete
+   */
+  delete_connection_integrations_connections__connection_id__delete: {
+    input: {
+    path: {
+      /** Connection id. */
+      connection_id: string;
+    };
+    query: {
+      /** Provider config key, e.g. `hubspot` or `salesforce`. REQUIRED: the same connection id can exist under more than one provider config, so the key is what identifies which one to remove. */
+      provider_config_key: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_ConnectionPayload_;
+  };
+  /**
+   * DELETE /integrations/crm/connections/{connection_id}/contacts/{contact_id}
+   * Delete Crm Contact
+   * tier: destructive · scope: integrations:delete
+   */
+  delete_crm_contact_integrations_crm_connections__connection_id__contacts__contact_id__delete: {
+    input: {
+    path: {
+      /** The CRM connection to act through. */
+      connection_id: string;
+      contact_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_CrmPayload_;
+  };
+  /**
+   * DELETE /audience-syncs/{config_id}/draft
+   * Discard Draft Sync Config
+   * tier: destructive · scope: integrations:delete
+   */
+  discard_draft_sync_config_audience_syncs__config_id__draft_delete: {
+    input: {
+    path: {
+      /** The sync config's id. */
+      config_id: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_AdPayload_;
+  };
+  /**
+   * DELETE /integrations/sugarcrm
+   * Disconnect Sugarcrm
+   * tier: destructive · scope: integrations:delete
+   */
+  disconnect_sugarcrm_integrations_sugarcrm_delete: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_IntegrationOpPayload_;
+  };
+  /**
+   * GET /integrations/crm/fields
+   * Discover Crm Fields
+   * tier: read · scope: integrations:read
+   */
+  discover_crm_fields_integrations_crm_fields_get: {
+    input: {
+    query: {
+      connection_id: string;
+      /** Which CRM object to describe. `meetings`/`tasks` are Salesforce's Event/Task and `activities` is Pipedrive's; other providers fall back to contacts for an object they do not model. */
+      entity_type?: "contacts" | "companies" | "deals" | "leads" | "meetings" | "tasks" | "activities";
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_CrmCollection_;
+  };
+  /**
+   * GET /integrations/crm/users/by-email
+   * Find Crm User By Email
+   * tier: read · scope: integrations:read
+   */
+  find_crm_user_by_email_integrations_crm_users_by_email_get: {
+    input: {
+    query: {
+      connection_id: string;
+      /** The user's address in the CRM. */
+      email: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_CrmCollection_;
+  };
+  /**
+   * GET /audience-syncs/analytics/summary
+   * Get Ad Analytics Summary
+   * tier: read · scope: integrations:read
+   */
+  get_ad_analytics_summary_audience_syncs_analytics_summary_get: {
+    input: {
+    query?: {
+      /** Days to look back. */
+      days?: number;
+      /** One platform. Omit for all. */
+      platform?: ("meta" | "linkedin" | "google" | "x") | null;
+      ad_account_id?: string | null;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_AdPayload_;
+  };
+  /**
+   * GET /audience-syncs/analytics/daily-trend
+   * Get Ad Daily Trend
+   * tier: read · scope: integrations:read
+   */
+  get_ad_daily_trend_audience_syncs_analytics_daily_trend_get: {
+    input: {
+    query?: {
+      /** Days to look back. */
+      days?: number;
+      /** One platform. Omit for all. */
+      platform?: ("meta" | "linkedin" | "google" | "x") | null;
+      /** Scope to one sync config. */
+      sync_config_id?: number | null;
+      ad_account_id?: string | null;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_AdPayload_;
+  };
+  /**
+   * GET /integrations/crm/connections/{connection_id}/companies/{company_id}
+   * Get Crm Company
+   * tier: read · scope: integrations:read
+   */
+  get_crm_company_integrations_crm_connections__connection_id__companies__company_id__get: {
+    input: {
+    path: {
+      /** The CRM connection to act through. */
+      connection_id: string;
+      /** The CRM's company id, not graph8's. */
+      company_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_CrmPayload_;
+  };
+  /**
+   * GET /integrations/crm/connections/{connection_id}
+   * Get Crm Connection
+   * tier: read · scope: integrations:read
+   */
+  get_crm_connection_integrations_crm_connections__connection_id__get: {
+    input: {
+    path: {
+      /** The CRM connection to act through. */
+      connection_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_CrmPayload_;
+  };
+  /**
+   * GET /integrations/crm/connections/{connection_id}/metadata
+   * Get Crm Connection Metadata
+   * tier: read · scope: integrations:read
+   */
+  get_crm_connection_metadata_integrations_crm_connections__connection_id__metadata_get: {
+    input: {
+    path: {
+      /** The CRM connection to act through. */
+      connection_id: string;
+    };
+    query: {
+      /** The provider this connection belongs to. A mismatch is a 404. */
+      crm_type: "hubspot" | "salesforce" | "pipedrive" | "sugarcrm" | "stripe" | "zoho-crm" | "freshworks" | "facebook-ads" | "linkedin-ads" | "google-ads" | "x-ads" | "google-search-console";
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_CrmPayload_;
+  };
+  /**
+   * GET /integrations/crm/connections/{connection_id}/status
+   * Get Crm Connection Status
+   * tier: read · scope: integrations:read
+   */
+  get_crm_connection_status_integrations_crm_connections__connection_id__status_get: {
+    input: {
+    path: {
+      /** The CRM connection to act through. */
+      connection_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_CrmPayload_;
+  };
+  /**
+   * GET /integrations/crm/connections/{connection_id}/contacts/{contact_id}
+   * Get Crm Contact
+   * tier: read · scope: integrations:read
+   */
+  get_crm_contact_integrations_crm_connections__connection_id__contacts__contact_id__get: {
+    input: {
+    path: {
+      /** The CRM connection to act through. */
+      connection_id: string;
+      /** The CRM's contact id, not graph8's. */
+      contact_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_CrmPayload_;
+  };
+  /**
+   * GET /integrations/crm/connections/{connection_id}/deals/{deal_id}
+   * Get Crm Deal
+   * tier: read · scope: integrations:read
+   */
+  get_crm_deal_integrations_crm_connections__connection_id__deals__deal_id__get: {
+    input: {
+    path: {
+      /** The CRM connection to act through. */
+      connection_id: string;
+      /** The CRM's deal id, not graph8's. */
+      deal_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_CrmPayload_;
+  };
+  /**
+   * GET /integrations/crm/connections/{connection_id}/leads/{lead_id}
+   * Get Crm Lead
+   * tier: read · scope: integrations:read
+   */
+  get_crm_lead_integrations_crm_connections__connection_id__leads__lead_id__get: {
+    input: {
+    path: {
+      /** The CRM connection to act through. */
+      connection_id: string;
+      /** The CRM's lead id. */
+      lead_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_CrmPayload_;
+  };
+  /**
+   * GET /audience-syncs/google/conversion-tracking
+   * Get Google Conversion Tracking
+   * tier: read · scope: integrations:read
+   */
+  get_google_conversion_tracking_audience_syncs_google_conversion_tracking_get: {
+    input: {
+    query?: {
+      /** A Google Ads customer id. Omit to use the org's own. */
+      ad_account_id?: string | null;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_AdPayload_;
+  };
+  /**
+   * GET /integrations/connections/{connection_id}/last-migration
+   * Get Last Completed Migration
+   * tier: read · scope: integrations:read
+   */
+  get_last_completed_migration_integrations_connections__connection_id__last_migration_get: {
+    input: {
+    path: {
+      /** CRM connection id. */
+      connection_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_IntegrationOpPayload_;
+  };
+  /**
+   * GET /integrations/migrations/{migration_id}
+   * Get Migration Status
+   * tier: read · scope: integrations:read
+   */
+  get_migration_status_integrations_migrations__migration_id__get: {
+    input: {
+    path: {
+      /** Migration id. */
+      migration_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_ConnectionPayload_;
+  };
+  /**
+   * POST /integrations/crm-sync/audiences
+   * Get Or Create Crm Audience
+   * tier: external · scope: integrations:run
+   */
+  get_or_create_crm_audience_integrations_crm_sync_audiences_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: CrmAudienceRequest;
+  };
+    output: ApiResponse_CrmAudienceResponse_;
+  };
+  /**
+   * POST /integrations/crm/lists
+   * Get Or Create Crm List
+   * tier: external · scope: integrations:run
+   */
+  get_or_create_crm_list_integrations_crm_lists_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: GetOrCreateCrmListRequest;
+  };
+    output: ApiResponse_CrmPayload_;
+  };
+  /**
+   * GET /audience-syncs/{config_id}/analytics
+   * Get Sync Config Analytics
+   * tier: read · scope: integrations:read
+   */
+  get_sync_config_analytics_audience_syncs__config_id__analytics_get: {
+    input: {
+    path: {
+      /** The sync config's id. */
+      config_id: number;
+    };
+    query?: {
+      /** Days to look back. */
+      days?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_AdPayload_;
+  };
+  /**
+   * GET /integrations/crm-sync/jobs/{job_id}
+   * Get Sync Job
+   * tier: read · scope: integrations:read
+   */
+  get_sync_job_integrations_crm_sync_jobs__job_id__get: {
+    input: {
+    path: {
+      /** Job id returned by a push or pull. */
+      job_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_SyncJobResponse_;
+  };
+  /**
+   * GET /audience-syncs/{config_id}/segment-status
+   * Get Sync Segment Status
+   * tier: read · scope: integrations:read
+   */
+  get_sync_segment_status_audience_syncs__config_id__segment_status_get: {
+    input: {
+    path: {
+      /** The sync config's id. */
+      config_id: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_AdPayload_;
+  };
+  /**
+   * GET /audience-syncs/google/video-assets/{asset_id}
+   * Get Video Asset
+   * tier: read · scope: integrations:read
+   */
+  get_video_asset_audience_syncs_google_video_assets__asset_id__get: {
+    input: {
+    path: {
+      /** The video asset's id. */
+      asset_id: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_AdPayload_;
+  };
+  /**
+   * GET /audience-syncs/account-health
+   * List Ad Account Health
+   * tier: read · scope: integrations:read
+   */
+  list_ad_account_health_audience_syncs_account_health_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_AdCollection_;
+  };
+  /**
+   * GET /audience-syncs/accounts
+   * List Ad Accounts
+   * tier: read · scope: integrations:read
+   */
+  list_ad_accounts_audience_syncs_accounts_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_AdCollection_;
+  };
+  /**
+   * GET /audience-syncs/platforms
+   * List Ad Platforms
+   * tier: read · scope: integrations:read
+   */
+  list_ad_platforms_audience_syncs_platforms_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_AdCollection_;
+  };
+  /**
+   * GET /integrations/crm/company-activities
+   * List Company Activities By Graph8 Id
+   * tier: read · scope: integrations:read
+   */
+  list_company_activities_by_graph8_id_integrations_crm_company_activities_get: {
+    input: {
+    query: {
+      /** graph8 `mashup_companies.id`. */
+      company_id: number;
+      /** Comma-separated activity types. */
+      activity_types?: string | null;
+      /** `manual` or `crm`. */
+      source?: string | null;
+      limit?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_CrmPayload_;
+  };
+  /**
+   * GET /integrations/connections
+   * List Connections
+   * tier: read · scope: integrations:read
+   */
+  list_connections_integrations_connections_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_ConnectionListPayload_;
+  };
+  /**
+   * GET /integrations/crm/contact-activities
+   * List Contact Activities By Graph8 Id
+   * tier: read · scope: integrations:read
+   */
+  list_contact_activities_by_graph8_id_integrations_crm_contact_activities_get: {
+    input: {
+    query: {
+      /** graph8 `mashup_contacts.id`. */
+      contact_id: number;
+      /** Auto-discovered from the org's connections when omitted. */
+      connection_id?: string | null;
+      limit?: number;
+      /** Comma-separated: `calls,emails,notes,meetings,tasks`. */
+      activity_types?: string | null;
+      /** `manual`, `crm` (any provider), or a provider name. Omit for everything - which is the point of this route: one timeline whether the activity was logged in graph8 or in the CRM. */
+      source?: string | null;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_CrmPayload_;
+  };
+  /**
+   * GET /integrations/crm/activities
+   * List Crm Activities
+   * tier: read · scope: integrations:read
+   */
+  list_crm_activities_integrations_crm_activities_get: {
+    input: {
+    query: {
+      connection_id: string;
+      /** One activity type, e.g. `call`. */
+      type?: string | null;
+      /** Records per page. */
+      limit?: number;
+      /** Records to skip. */
+      offset?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_CrmCollection_;
+  };
+  /**
+   * GET /integrations/crm/connections/{connection_id}/companies
+   * List Crm Companies
+   * tier: read · scope: integrations:read
+   */
+  list_crm_companies_integrations_crm_connections__connection_id__companies_get: {
+    input: {
+    path: {
+      /** The CRM connection to act through. */
+      connection_id: string;
+    };
+    query?: {
+      /** Records per page. */
+      limit?: number;
+      /** Records to skip. */
+      offset?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_CrmCollection_;
+  };
+  /**
+   * GET /integrations/crm/connections/{connection_id}/contacts/{contact_id}/activities
+   * List Crm Contact Activities
+   * tier: read · scope: integrations:read
+   */
+  list_crm_contact_activities_integrations_crm_connections__connection_id__contacts__contact_id__activities_get: {
+    input: {
+    path: {
+      /** The CRM connection to act through. */
+      connection_id: string;
+      /** The CRM's contact id. */
+      contact_id: string;
+    };
+    query?: {
+      limit?: number;
+      /** Comma-separated: `calls,emails,notes,meetings,tasks`. */
+      activity_types?: string | null;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_CrmCollection_;
+  };
+  /**
+   * GET /integrations/crm/connections/{connection_id}/contacts
+   * List Crm Contacts
+   * tier: read · scope: integrations:read
+   */
+  list_crm_contacts_integrations_crm_connections__connection_id__contacts_get: {
+    input: {
+    path: {
+      /** The CRM connection to act through. */
+      connection_id: string;
+    };
+    query?: {
+      /** Records per page. */
+      limit?: number;
+      /** Records to skip. */
+      offset?: number;
+      /** ISO 8601 timestamp. Only contacts modified at or after it - the parameter an incremental reader should page on rather than re-reading the whole CRM. */
+      updated_gte?: string | null;
+      /** Exact-match filter. */
+      email?: string | null;
+      name?: string | null;
+      /** The CRM's company id. */
+      company_id?: string | null;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_CrmCollection_;
+  };
+  /**
+   * GET /integrations/crm/connections/{connection_id}/deals
+   * List Crm Deals
+   * tier: read · scope: integrations:read
+   */
+  list_crm_deals_integrations_crm_connections__connection_id__deals_get: {
+    input: {
+    path: {
+      /** The CRM connection to act through. */
+      connection_id: string;
+    };
+    query?: {
+      /** Records per page. */
+      limit?: number;
+      /** Records to skip. */
+      offset?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_CrmCollection_;
+  };
+  /**
+   * GET /integrations/crm/connections/{connection_id}/leads
+   * List Crm Leads
+   * tier: read · scope: integrations:read
+   */
+  list_crm_leads_integrations_crm_connections__connection_id__leads_get: {
+    input: {
+    path: {
+      /** The CRM connection to act through. */
+      connection_id: string;
+    };
+    query?: {
+      /** Records per page. */
+      limit?: number;
+      /** Records to skip. */
+      offset?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_CrmCollection_;
+  };
+  /**
+   * GET /integrations/crm/lists
+   * List Crm Lists
+   * tier: read · scope: integrations:read
+   */
+  list_crm_lists_integrations_crm_lists_get: {
+    input: {
+    query: {
+      connection_id: string;
+      /** Filter by list name. */
+      query?: string | null;
+      limit?: number;
+      offset?: number;
+      /** Which object the list holds. */
+      entity_type?: "contacts" | "companies" | "deals" | "leads";
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_CrmPayload_;
+  };
+  /**
+   * GET /integrations/crm/meetings
+   * List Crm Meetings
+   * tier: read · scope: integrations:read
+   */
+  list_crm_meetings_integrations_crm_meetings_get: {
+    input: {
+    query: {
+      connection_id: string;
+      /** Records per page. */
+      limit?: number;
+      /** Records to skip. */
+      offset?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_CrmCollection_;
+  };
+  /**
+   * GET /integrations/crm/users
+   * List Crm Users
+   * tier: read · scope: integrations:read
+   */
+  list_crm_users_integrations_crm_users_get: {
+    input: {
+    query: {
+      /** The CRM connection to act through. */
+      connection_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_CrmCollection_;
+  };
+  /**
+   * GET /integrations/crm-sync/leads/statuses
+   * List Lead Statuses
+   * tier: read · scope: integrations:read
+   */
+  list_lead_statuses_integrations_crm_sync_leads_statuses_get: {
+    input: {
+    query: {
+      /** A Salesforce connection. */
+      connection_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_LeadStatusesResponse_;
+  };
+  /**
+   * GET /integrations/crm/fields/mappable
+   * List Mappable Graph8 Fields
+   * tier: read · scope: integrations:read
+   */
+  list_mappable_graph8_fields_integrations_crm_fields_mappable_get: {
+    input: {
+    query?: {
+      /** Which graph8 object. */
+      object_type?: "contacts" | "companies" | "deals" | "leads" | "activities";
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_CrmCollection_;
+  };
+  /**
+   * GET /audience-syncs/google/video-assets
+   * List Video Assets
+   * tier: read · scope: integrations:read
+   */
+  list_video_assets_audience_syncs_google_video_assets_get: {
+    input: {
+    query?: {
+      /** Omit for every source. */
+      source?: ("link" | "upload" | "studio") | null;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_AdCollection_;
+  };
+  /**
+   * POST /integrations/crm/connections/{connection_id}/batch/contacts/lookup-by-email
+   * Lookup Crm Contacts By Email
+   * tier: read · scope: integrations:read
+   */
+  lookup_crm_contacts_by_email_integrations_crm_connections__connection_id__batch_contacts_lookup_by_email_post: {
+    input: {
+    path: {
+      /** The CRM connection to act through. */
+      connection_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: BatchGetByEmailRequest;
+  };
+    output: ApiResponse_CrmPayload_;
+  };
+  /**
+   * POST /integrations/crm/lists/memberships
+   * Modify Crm List Memberships
+   * tier: external · scope: integrations:run
+   */
+  modify_crm_list_memberships_integrations_crm_lists_memberships_post: {
+    input: {
+    query: {
+      connection_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: ModifyListMembershipsRequest;
+  };
+    output: ApiResponse_CrmPayload_;
+  };
+  /**
+   * GET /integrations/crm-sync/leads/push-preview
+   * Preview Lead Push
+   * tier: read · scope: integrations:read
+   */
+  preview_lead_push_integrations_crm_sync_leads_push_preview_get: {
+    input: {
+    query: {
+      /** A Salesforce connection. */
+      connection_id: string;
+      /** Which population to preview. `saved_segment` requires `audience_id`; `segments_union` requires `audience_ids`. */
+      source_mode?: "all_qualified" | "saved_segment" | "segments_union" | "all_contacts";
+      /** Required for `saved_segment`. */
+      audience_id?: number | null;
+      /** Required for `segments_union`. */
+      audience_ids?: Array<number> | null;
+      /** Ceiling on rows inspected. */
+      limit?: number;
+      status_qualified?: string | null;
+      status_unqualified?: string | null;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_LeadPreviewResponse_;
+  };
+  /**
+   * POST /integrations/crm-sync/contacts/pull
+   * Pull All Contacts
+   * tier: external · scope: integrations:run
+   */
+  pull_all_contacts_integrations_crm_sync_contacts_pull_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: PullAllContactsRequest;
+  };
+    output: ApiResponse_SyncJobResponse_;
+  };
+  /**
+   * POST /integrations/crm-sync/deals/pull
+   * Pull All Deals
+   * tier: external · scope: integrations:run
+   */
+  pull_all_deals_integrations_crm_sync_deals_pull_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: PullAllDealsRequest;
+  };
+    output: ApiResponse_SyncJobResponse_;
+  };
+  /**
+   * POST /integrations/crm-sync/leads/pull
+   * Pull All Leads
+   * tier: external · scope: integrations:run
+   */
+  pull_all_leads_integrations_crm_sync_leads_pull_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: PullAllLeadsRequest;
+  };
+    output: ApiResponse_SyncJobResponse_;
+  };
+  /**
+   * POST /integrations/crm-sync/pull
+   * Pull Crm List
+   * tier: external · scope: integrations:run
+   */
+  pull_crm_list_integrations_crm_sync_pull_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: PullCrmListRequest;
+  };
+    output: ApiResponse_SyncJobResponse_;
+  };
+  /**
+   * POST /integrations/crm-sync/contacts/push
+   * Push All Contacts
+   * tier: external · scope: integrations:run
+   */
+  push_all_contacts_integrations_crm_sync_contacts_push_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: PushAllContactsRequest;
+  };
+    output: ApiResponse_SyncJobResponse_;
+  };
+  /**
+   * POST /integrations/crm-sync/deals/push
+   * Push All Deals
+   * tier: external · scope: integrations:run
+   */
+  push_all_deals_integrations_crm_sync_deals_push_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: PushAllDealsRequest;
+  };
+    output: ApiResponse_SyncJobResponse_;
+  };
+  /**
+   * POST /integrations/crm-sync/leads/push
+   * Push All Leads
+   * tier: external · scope: integrations:run
+   */
+  push_all_leads_integrations_crm_sync_leads_push_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: PushAllLeadsRequest;
+  };
+    output: ApiResponse_SyncJobResponse_;
+  };
+  /**
+   * POST /integrations/crm-sync/push
+   * Push Audience
+   * tier: external · scope: integrations:run
+   */
+  push_audience_integrations_crm_sync_push_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: PushAudienceRequest;
+  };
+    output: ApiResponse_SyncJobResponse_;
+  };
+  /**
+   * POST /integrations/sugarcrm/reconnect
+   * Reconnect Sugarcrm
+   * tier: external · scope: integrations:run
+   */
+  reconnect_sugarcrm_integrations_sugarcrm_reconnect_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: SugarCrmConnectRequest;
+  };
+    output: ApiResponse_IntegrationOpPayload_;
+  };
+  /**
+   * POST /audience-syncs/google/video-assets/uploads
+   * Register Uploaded Video Asset
+   * tier: external · scope: integrations:run
+   */
+  register_uploaded_video_asset_audience_syncs_google_video_assets_uploads_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: RegisterVideoAssetRequest;
+  };
+    output: ApiResponse_AdPayload_;
+  };
+  /**
+   * POST /audience-syncs/google/video-assets/library
+   * Register Video Asset From Library
+   * tier: external · scope: integrations:run
+   */
+  register_video_asset_from_library_audience_syncs_google_video_assets_library_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: RegisterLibraryVideoAssetRequest;
+  };
+    output: ApiResponse_AdPayload_;
+  };
+  /**
+   * POST /audience-syncs/google/video-assets/links
+   * Register Video Asset From Link
+   * tier: external · scope: integrations:run
+   */
+  register_video_asset_from_link_audience_syncs_google_video_assets_links_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: CreateVideoAssetFromLinkRequest;
+  };
+    output: ApiResponse_AdPayload_;
+  };
+  /**
+   * POST /integrations/connections
+   * Save Connection
+   * tier: external · scope: integrations:run
+   */
+  save_connection_integrations_connections_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: SaveConnectionRequest;
+  };
+    output: ApiResponse_ConnectionPayload_;
+  };
+  /**
+   * PUT /integrations/crm-sync/pull-enabled
+   * Set Pull Sync Enabled
+   * tier: external · scope: integrations:run
+   */
+  set_pull_sync_enabled_integrations_crm_sync_pull_enabled_put: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: SyncEnabledRequest;
+  };
+    output: ApiResponse_SyncJobResponse_;
+  };
+  /**
+   * PUT /integrations/crm-sync/push-enabled
+   * Set Push Sync Enabled
+   * tier: external · scope: integrations:run
+   */
+  set_push_sync_enabled_integrations_crm_sync_push_enabled_put: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: SyncEnabledRequest;
+  };
+    output: ApiResponse_SyncJobResponse_;
+  };
+  /**
+   * POST /integrations/migrations/delta-sync
+   * Start Delta Sync
+   * tier: external · scope: integrations:run
+   */
+  start_delta_sync_integrations_migrations_delta_sync_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: DeltaSyncRequest;
+  };
+    output: ApiResponse_ConnectionPayload_;
+  };
+  /**
+   * POST /integrations/crm-sync/leads/previews
+   * Start Lead Preview
+   * tier: external · scope: integrations:run
+   */
+  start_lead_preview_integrations_crm_sync_leads_previews_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: LeadPreviewRequest;
+  };
+    output: ApiResponse_SyncJobResponse_;
+  };
+  /**
+   * POST /integrations/migrations/discovery
+   * Start Migration Discovery
+   * tier: external · scope: integrations:run
+   */
+  start_migration_discovery_integrations_migrations_discovery_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: StartDiscoveryRequest;
+  };
+    output: ApiResponse_ConnectionPayload_;
+  };
+  /**
+   * PUT /integrations/crm/connections/{connection_id}/companies/{company_id}
+   * Update Crm Company
+   * tier: external · scope: integrations:run
+   */
+  update_crm_company_integrations_crm_connections__connection_id__companies__company_id__put: {
+    input: {
+    path: {
+      /** The CRM connection to act through. */
+      connection_id: string;
+      company_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: CrmCompanyUpdateRequest;
+  };
+    output: ApiResponse_CrmPayload_;
+  };
+  /**
+   * PUT /integrations/crm/connections/{connection_id}/contacts/{contact_id}
+   * Update Crm Contact
+   * tier: external · scope: integrations:run
+   */
+  update_crm_contact_integrations_crm_connections__connection_id__contacts__contact_id__put: {
+    input: {
+    path: {
+      /** The CRM connection to act through. */
+      connection_id: string;
+      contact_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: CrmContactUpdateRequest;
+  };
+    output: ApiResponse_CrmPayload_;
+  };
+  /**
+   * PUT /integrations/crm/connections/{connection_id}/deals/{deal_id}
+   * Update Crm Deal
+   * tier: external · scope: integrations:run
+   */
+  update_crm_deal_integrations_crm_connections__connection_id__deals__deal_id__put: {
+    input: {
+    path: {
+      /** The CRM connection to act through. */
+      connection_id: string;
+      deal_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: CrmDealUpdateRequest;
+  };
+    output: ApiResponse_CrmPayload_;
+  };
+  /**
+   * PUT /integrations/crm/connections/{connection_id}/leads/{lead_id}
+   * Update Crm Lead
+   * tier: external · scope: integrations:run
+   */
+  update_crm_lead_integrations_crm_connections__connection_id__leads__lead_id__put: {
+    input: {
+    path: {
+      /** The CRM connection to act through. */
+      connection_id: string;
+      lead_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: LeadUpdateRequest;
+  };
+    output: ApiResponse_CrmPayload_;
+  };
+  /**
+   * PATCH /integrations/crm/meetings/{event_id}
+   * Update Crm Meeting
+   * tier: external · scope: integrations:run
+   */
+  update_crm_meeting_integrations_crm_meetings__event_id__patch: {
+    input: {
+    path: {
+      /** The CRM's event id. */
+      event_id: string;
+    };
+    query: {
+      connection_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: UpdateMeetingRequest;
+  };
+    output: ApiResponse_CrmPayload_;
+  };
+  /**
+   * POST /audience-syncs/google/conversions
+   * Upload Google Conversions
+   * tier: external · scope: integrations:run
+   */
+  upload_google_conversions_audience_syncs_google_conversions_post: {
+    input: {
+    query?: {
+      ad_account_id?: string | null;
+      /** TRUE BY DEFAULT, and deliberately. The batch is built and NOTHING is sent to Google. Read the result, then send `false`. */
+      dry_run?: boolean;
+      /** With `dry_run=false`, ask Google to VALIDATE the batch without recording it. The middle step between a local preview and a real upload - it catches what only Google can tell you. */
+      validate_only?: boolean;
+      /** Conversions per call. */
+      limit?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_AdPayload_;
+  };
+  /**
+   * POST /integrations/sugarcrm/validate
+   * Validate Sugarcrm
+   * tier: read · scope: integrations:read
+   */
+  validate_sugarcrm_integrations_sugarcrm_validate_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_IntegrationOpPayload_;
+  };
+}
+
+// 64 schemas referenced above (the same as G8Contract.<Name>).
+
+/**
+ * A list of ad-platform objects.
+ *
+ * A bare list from the app is surfaced as `items`; a named collection keeps
+ * its own key AND gains `items`, so a caller can page either shape without
+ * knowing which handler produced it.
+ */
+export interface AdCollection {
+  items?: Array<unknown>;
+  [key: string]: unknown;
+}
+
+/** One ad-platform object, or one handler response. */
+export type AdPayload = Record<string, unknown>;
+
+export interface ApiResponse_AdCollection_ {
+  data: AdCollection;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_AdPayload_ {
+  data: AdPayload;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_ConnectionListPayload_ {
+  data: ConnectionListPayload;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_ConnectionPayload_ {
+  data: ConnectionPayload;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_CrmAudienceResponse_ {
+  data: CrmAudienceResponse;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_CrmCollection_ {
+  data: CrmCollection;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_CrmPayload_ {
+  data: CrmPayload;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_IntegrationOpPayload_ {
+  data: IntegrationOpPayload;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_LeadPreviewResponse_ {
+  data: LeadPreviewResponse;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_LeadStatusesResponse_ {
+  data: LeadStatusesResponse;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_SyncJobResponse_ {
+  data: SyncJobResponse;
+  pagination?: PaginationMeta | null;
+}
+
+/** One contact in a batch. `crm_id` is only read on the UPDATE path. */
+export interface BatchContactRequest {
+  address?: CrmAddress | null;
+  company_id?: string | null;
+  company_name?: string | null;
+  /** The record's id in the CRM. Required on update, ignored on create. */
+  crm_id?: string | null;
+  custom_fields?: Array<CrmCustomField>;
+  email: string;
+  first_name?: string | null;
+  last_name?: string | null;
+  phone?: string | null;
+  title?: string | null;
+  user_id?: string | null;
+}
+
+/** A batch of contacts to create or update in one provider round trip. */
+export interface BatchContactsRequest {
+  contacts: Array<BatchContactRequest>;
+}
+
+/** Look up existing CRM contacts by email. Reads; writes nothing. */
+export interface BatchGetByEmailRequest {
+  emails: Array<string>;
+}
+
+/**
+ * Accept a discovery and START IMPORTING.
+ *
+ * This is the irreversible half: records begin landing in graph8 and a
+ * migration cannot be un-run, only cancelled part-way.
+ *
+ * Both fields are OPTIONAL and omitting them accepts the discovery as
+ * proposed - which is the point of previewing it first. Send
+ * `field_mappings_override` to change where a CRM field lands, or
+ * `selected_list_ids` to import only some lists.
+ */
+export interface ConfirmMigrationRequest {
+  /** Per entity type, the mappings to use instead of the discovered ones. Omit to accept what discovery proposed. */
+  field_mappings_override?: Record<string, Array<Record<string, unknown>>> | null;
+  /** Import only these CRM lists. Omit to take every discovered list. */
+  selected_list_ids?: Array<string> | null;
+}
+
+/** An open envelope for a LIST result, so a bare list keeps its shape. */
+export interface ConnectionListPayload {
+  items?: Array<unknown>;
+  [key: string]: unknown;
+}
+
+/**
+ * An open envelope for a connection, a token or a migration report.
+ *
+ * Open because the migration STATUS payload carries a per-entity progress
+ * map, a discovered-field map and a pipeline list that all grow with the
+ * providers - and because a dropped warning on a migration report reads as
+ * "nothing went wrong".
+ */
+export type ConnectionPayload = Record<string, unknown>;
+
+/**
+ * Request body for POST /audience-sync/google/conversion-actions.
+ *
+ * All fields optional — an empty body provisions the default primary
+ * "graph8 Landing Page Conversions" action (category DEFAULT), matching what
+ * Demand Gen / PMax launches auto-provision.
+ */
+export interface CreateConversionActionRequest {
+  category?: string;
+  name?: string;
+  primary_for_goal?: boolean;
+}
+
+/** A meeting/event created on the CRM's calendar object. */
+export interface CreateMeetingRequest {
+  company_ids?: Array<string> | null;
+  /** CRM contact ids to associate. */
+  contact_ids?: Array<string> | null;
+  deal_ids?: Array<string> | null;
+  description?: string | null;
+  /** ISO 8601. */
+  end_at?: string | null;
+  location?: string | null;
+  /** ISO 8601. */
+  start_at?: string | null;
+  title?: string | null;
+  user_id?: string | null;
+}
+
+/** Register a YouTube video by URL (Google Video campaigns). */
+export interface CreateVideoAssetFromLinkRequest {
+  url: string;
+}
+
+/** Ask for a presigned R2 PUT for a browser-direct video upload. */
+export interface CreateVideoUploadUrlRequest {
+  /** video/mp4 | video/quicktime | video/webm */
+  content_type: string;
+  /** Exact file size — signed into the PUT; a different body length is refused */
+  size_bytes: number;
+}
+
+export interface CrmAddress {
+  address_type?: string | null;
+  city?: string | null;
+  country?: string | null;
+  postal_code?: string | null;
+  state?: string | null;
+  street?: string | null;
+  street2?: string | null;
+}
+
+/**
+ * Get, or create, the graph8 audience a CRM import lands in.
+ *
+ * Idempotent by TITLE: calling twice with the same `list_name` returns the
+ * same audience with `created: false` rather than making a second one. That is
+ * what makes it safe to call before every import, and it is why this is not
+ * `POST /lists` - that one always creates.
+ */
+export interface CrmAudienceRequest {
+  /** The CRM connection this audience is for. Its provider is recorded on the audience as the source and as a `crm-import` tag, which is what lets a later sync tell CRM-imported rows from graph8-native ones. */
+  connection_id: string;
+  /** `contacts`, `companies`, `deals` or `leads`. Singular forms are accepted and pluralised by the app; anything unrecognised falls back to `contacts`. Omit for `contacts`. */
+  entity_type?: string | null;
+  /** Audience title. Matched exactly; reused when it exists. */
+  list_name: string;
+}
+
+/** The audience, and whether this call is what created it. */
+export interface CrmAudienceResponse {
+  audience_id?: number | null;
+  /** True only when THIS call created the audience; false when it already existed. */
+  created?: boolean | null;
+  source?: string | null;
+  title?: string | null;
+  [key: string]: unknown;
+}
+
+/**
+ * A list of CRM records.
+ *
+ * A bare list from the app is surfaced as `items`; a named collection keeps
+ * its own key AND gains `items`, so a caller can page either shape without
+ * knowing which handler produced it.
+ */
+export interface CrmCollection {
+  items?: Array<unknown>;
+  [key: string]: unknown;
+}
+
+export interface CrmCompanyCreateRequest {
+  address?: CrmAddress | null;
+  annual_revenue?: number | null;
+  custom_fields?: Array<CrmCustomField>;
+  domain?: string | null;
+  employee_count?: number | null;
+  industry?: string | null;
+  name: string;
+  phone?: string | null;
+  website?: string | null;
+}
+
+export interface CrmCompanyUpdateRequest {
+  address?: CrmAddress | null;
+  annual_revenue?: number | null;
+  custom_fields?: Array<CrmCustomField> | null;
+  domain?: string | null;
+  employee_count?: number | null;
+  industry?: string | null;
+  name?: string | null;
+  phone?: string | null;
+  website?: string | null;
+}
+
+/** A new contact, created in the CUSTOMER'S CRM. */
+export interface CrmContactCreateRequest {
+  address?: CrmAddress | null;
+  /** The CRM's company id, not graph8's. */
+  company_id?: string | null;
+  company_name?: string | null;
+  custom_fields?: Array<CrmCustomField>;
+  emails?: Array<CrmEmail>;
+  first_name?: string | null;
+  last_name?: string | null;
+  name?: string | null;
+  phones?: Array<CrmPhone>;
+  source?: string | null;
+  tags?: Array<string>;
+  title?: string | null;
+  /** CRM owner. See `GET /integrations/crm/users`. */
+  user_id?: string | null;
+}
+
+/**
+ * A partial update. Every field is optional; omitted fields are untouched.
+ *
+ * `emails`, `phones`, `custom_fields` and `tags` are optional LISTS rather
+ * than list-with-default here, which is the difference that matters: on the
+ * create model an omitted list means "none", and on this one it means "leave
+ * what is there". Sending `[]` REPLACES with empty.
+ */
+export interface CrmContactUpdateRequest {
+  address?: CrmAddress | null;
+  company_id?: string | null;
+  company_name?: string | null;
+  custom_fields?: Array<CrmCustomField> | null;
+  emails?: Array<CrmEmail> | null;
+  first_name?: string | null;
+  is_active?: boolean | null;
+  last_name?: string | null;
+  name?: string | null;
+  phones?: Array<CrmPhone> | null;
+  tags?: Array<string> | null;
+  title?: string | null;
+  user_id?: string | null;
+}
+
+/**
+ * One provider-side custom field.
+ *
+ * `field_name` is the CRM's API name, not its label. Read the valid names
+ * from `GET /integrations/crm/fields`; a name the provider does not have is
+ * rejected by the provider, not here.
+ */
+export interface CrmCustomField {
+  field_name: string;
+  field_type?: string | null;
+  /** Required, but may be null - which is how a custom field is cleared. */
+  field_value: unknown;
+}
+
+export interface CrmDealCreateRequest {
+  amount?: number | null;
+  /** ISO 8601 date. */
+  close_date?: string | null;
+  company_id?: string | null;
+  contact_id?: string | null;
+  custom_fields?: Array<CrmCustomField>;
+  description?: string | null;
+  name: string;
+  probability?: number | null;
+  /** Provider's pipeline stage. Omit to take the provider's default stage. */
+  stage?: string | null;
+  type?: string | null;
+  user_id?: string | null;
+}
+
+export interface CrmDealUpdateRequest {
+  amount?: number | null;
+  close_date?: string | null;
+  company_id?: string | null;
+  contact_id?: string | null;
+  custom_fields?: Array<CrmCustomField> | null;
+  description?: string | null;
+  name?: string | null;
+  probability?: number | null;
+  stage?: string | null;
+  type?: string | null;
+  user_id?: string | null;
+}
+
+export interface CrmEmail {
+  email: string;
+  /** Provider's own label, e.g. `work`. Passed through unchanged. */
+  email_type?: string | null;
+}
+
+/**
+ * One CRM record, or one provider response.
+ *
+ * Open-shaped ON PURPOSE. These bodies carry whatever the provider returned,
+ * the field set differs between HubSpot, Salesforce, Pipedrive and SugarCRM,
+ * and it grows every time one of them ships something. Pinning it would drop
+ * whatever a provider reported that this contract had not caught up on -
+ * which on a CRM surface means silently hiding the customer's own data from
+ * them.
+ */
+export type CrmPayload = Record<string, unknown>;
+
+export interface CrmPhone {
+  phone: string;
+  phone_type?: string | null;
+}
+
+/**
+ * Import only what changed since a watermark.
+ *
+ * The response echoes `since` back as ISO 8601, so the caller learns the
+ * watermark the server actually used rather than assuming its own was
+ * accepted.
+ */
+export interface DeltaSyncRequest {
+  connection_id: string;
+  /** Limit to these entity types. Omit for all. */
+  entity_types?: Array<string> | null;
+  /** Also re-fetch records the previous run should have imported and did not. Slower, and the reason to use it is a suspected gap rather than routine. */
+  recover_missing?: boolean;
+  /** ISO 8601 timestamp. Omit and the app picks the last successful watermark - which is usually what you want, and always safer than guessing one. */
+  since?: string | null;
+}
+
+/**
+ * Get, or create, a list in the CUSTOMER'S CRM, matched by name.
+ *
+ * Not a mirror - the app takes these three as QUERY parameters on a POST,
+ * which is not a shape to publish. The field names and meanings are the
+ * handler's.
+ */
+export interface GetOrCreateCrmListRequest {
+  connection_id: string;
+  /** Which object the list holds. Omit for `contacts`. */
+  entity_type?: ("contacts" | "companies" | "deals" | "leads") | null;
+  /** List name. Matched in the CRM; created when absent. */
+  name: string;
+}
+
+/** An open envelope for one result. */
+export type IntegrationOpPayload = Record<string, unknown>;
+
+/**
+ * A Salesforce Lead. `last_name` and `company` are REQUIRED by Salesforce
+ * itself, which is why they are required here and not merely validated.
+ */
+export interface LeadCreateRequest {
+  address?: CrmAddress | null;
+  annual_revenue?: number | null;
+  company: string;
+  custom_fields?: Array<CrmCustomField>;
+  email?: string | null;
+  employee_count?: number | null;
+  first_name?: string | null;
+  industry?: string | null;
+  last_name: string;
+  lead_source?: string | null;
+  phone?: string | null;
+  /** Salesforce `Lead.Status` API name. Read the valid values from `GET /integrations/crm-sync/leads/statuses` - it is an OPEN picklist, so an invented value silently becomes a real status. */
+  status?: string | null;
+  title?: string | null;
+  user_id?: string | null;
+  website?: string | null;
+}
+
+/**
+ * Queue a readiness preview of what a lead push WOULD do.
+ *
+ * Nothing is written to the CRM. This is the call to make before
+ * `/integrations/crm-sync/leads/push`, and the only way to learn the record
+ * count that `large_population_confirmed` is acknowledging.
+ */
+export interface LeadPreviewRequest {
+  audience_id?: number | null;
+  audience_ids?: Array<number> | null;
+  /** Which CRM connection to preview against. */
+  connection_id: string;
+  /** Acknowledge that this job covers a population large enough that the app asks first. Leave unset to keep that refusal in place; set true ONLY when you have read the preview's record count and accept it. This is a safety interlock, not a tuning option - the records land in the customer's Salesforce and cannot be un-pushed. */
+  large_population_confirmed?: boolean | null;
+  /** Rows scanned per page while previewing. Omit for the app's default. */
+  page_size?: number | null;
+  /** Which population to preview. `saved_segment` REQUIRES `audience_id`; `segments_union` REQUIRES `audience_ids`. */
+  source_mode?: ("all_qualified" | "saved_segment" | "segments_union" | "all_contacts") | null;
+  status_qualified?: string | null;
+  status_unqualified?: string | null;
+}
+
+/**
+ * What a lead push would do. Open-shaped - the readiness detail is
+ * per-provider and grows with it.
+ */
+export type LeadPreviewResponse = Record<string, unknown>;
+
+/**
+ * The org's Salesforce `Lead.Status` picklist.
+ *
+ * Open-shaped: each entry carries whatever Salesforce reports about the
+ * status, and the set of flags grows with their API. Converted statuses are
+ * already filtered out by the app - setting one through the push would
+ * silently convert leads.
+ */
+export interface LeadStatusesResponse {
+  /** The status Salesforce marks as the org default, when one exists. */
+  default?: string | null;
+  statuses?: Array<Record<string, unknown>>;
+  [key: string]: unknown;
+}
+
+export interface LeadUpdateRequest {
+  address?: CrmAddress | null;
+  annual_revenue?: number | null;
+  company?: string | null;
+  custom_fields?: Array<CrmCustomField> | null;
+  email?: string | null;
+  employee_count?: number | null;
+  first_name?: string | null;
+  industry?: string | null;
+  last_name?: string | null;
+  lead_source?: string | null;
+  phone?: string | null;
+  status?: string | null;
+  title?: string | null;
+  user_id?: string | null;
+  website?: string | null;
+}
+
+/**
+ * Add and/or remove contacts from one CRM list, in a single call.
+ *
+ * Both lists are applied in the same request, so this is not two calls
+ * pretending to be one - and a retry with the same body is idempotent on the
+ * provider side.
+ */
+export interface ModifyListMembershipsRequest {
+  add_contact_ids?: Array<string>;
+  /** The CRM's list id. */
+  list_id: string;
+  remove_contact_ids?: Array<string>;
+}
+
+export interface PaginationMeta {
+  /** Whether there are more pages */
+  has_next: boolean;
+  /** Items per page */
+  limit: number;
+  /** Opaque cursor for the next page; null when there are no more items. Pass it back as the `cursor` query param to fetch the following page without computing page numbers. */
+  next_cursor?: string | null;
+  /** Current page number (1-indexed) */
+  page: number;
+  /** Total number of items */
+  total: number;
+}
+
+/** Pull every CRM contact into graph8. */
+export interface PullAllContactsRequest {
+  /** Records per batch. */
+  chunk_size?: number | null;
+  /** Which CRM connection to run against. */
+  connection_id: string;
+  /** Fill missing fields from the graph8 index as rows arrive. Omit to take the app's default - this SPENDS enrichment credit when on. */
+  enrich_from_graph8?: boolean | null;
+  entity_type?: string | null;
+  /** Ceiling on records processed. OMIT to take the app's own default (5,000 pulling, 10,000 pushing) rather than freezing a copy of it here. */
+  limit?: number | null;
+  /** graph8 audience list to land in. */
+  list_id?: number | null;
+  /** Concurrent batches. */
+  max_parallel?: number | null;
+}
+
+export interface PullAllDealsRequest {
+  chunk_size?: number | null;
+  connection_id: string;
+  crm_list_id?: string | null;
+  crm_list_title?: string | null;
+  limit?: number | null;
+  list_id?: number | null;
+}
+
+/**
+ * Pull Salesforce Leads into graph8.
+ *
+ * Sending none of the optional fields runs the org's SAVED `pull.leads`
+ * settings; sending any of them overrides those settings for this one run.
+ * That is the app's behaviour and it is worth knowing, because an empty body
+ * here is not "pull everything" - it is "pull what I configured".
+ */
+export interface PullAllLeadsRequest {
+  /** Salesforce Campaign ids to pull members of. */
+  campaign_ids?: Array<string> | null;
+  /** Records per batch. */
+  chunk_size?: number | null;
+  /** Which CRM connection to pull from. */
+  connection_id: string;
+  /** Fill missing fields from the graph8 index as rows arrive. This SPENDS ENRICHMENT CREDIT when on. Omit to take the app's default rather than turning a spend on by accident. */
+  enrich_from_graph8?: boolean | null;
+  /** Include leads Salesforce has already converted to a Contact. */
+  include_converted?: boolean | null;
+  /** Ceiling on records pulled. */
+  limit?: number | null;
+  /** graph8 audience to land the leads in. */
+  list_id?: number | null;
+  /** Concurrent batches. */
+  max_parallel?: number | null;
+  /** `campaigns` restricts the pull to `campaign_ids`. Omit for the saved setting. */
+  source_mode?: ("all_leads" | "campaigns") | null;
+  /** Skip leads that appear on an opt-out list. */
+  suppress_from_optouts?: boolean | null;
+}
+
+/** Pull ONE CRM list, rather than everything. */
+export interface PullCrmListRequest {
+  /** Create a matching graph8 audience if none is given. */
+  auto_create_audience?: boolean | null;
+  connection_id: string;
+  /** REQUIRED - the CRM list to pull. */
+  crm_list_id: string;
+  /** SPENDS enrichment credit when on. */
+  enrich_from_graph8?: boolean | null;
+  entity_type?: string | null;
+  graph8_list_id?: number | null;
+  limit?: number | null;
+  reconcile?: boolean | null;
+}
+
+/** Push every graph8 contact into the CRM. */
+export interface PushAllContactsRequest {
+  /** Records per batch. */
+  chunk_size?: number | null;
+  /** Which CRM connection to run against. */
+  connection_id: string;
+  /** Target list in the CRM. */
+  crm_list_id?: string | null;
+  entity_type?: string | null;
+  file_import_threshold?: number | null;
+  /** Ceiling on records processed. OMIT to take the app's own default (5,000 pulling, 10,000 pushing) rather than freezing a copy of it here. */
+  limit?: number | null;
+  /** Concurrent batches. */
+  max_parallel?: number | null;
+  sync_list_mode?: string | null;
+  /** Use the provider's bulk file import instead of the API. */
+  use_file_import?: boolean | null;
+}
+
+export interface PushAllDealsRequest {
+  chunk_size?: number | null;
+  connection_id: string;
+  crm_list_id?: string | null;
+  limit?: number | null;
+  list_id?: number | null;
+  sync_list_mode?: string | null;
+}
+
+/**
+ * Push graph8 people into Salesforce as first-class Leads.
+ *
+ * Salesforce is the CRM that distinguishes a Lead from a Contact; the other
+ * providers do not, which is why this is a separate surface from
+ * `/integrations/crm-sync/contacts/push` rather than an `entity_type` on it.
+ */
+export interface PushAllLeadsRequest {
+  /** graph8 audience for `saved_segment`. */
+  audience_id?: number | null;
+  /** graph8 audiences for `segments_union`. */
+  audience_ids?: Array<number> | null;
+  /** Run Salesforce's assignment rules on each created lead. */
+  auto_assign_on_create?: boolean | null;
+  /** Records per batch. */
+  chunk_size?: number | null;
+  /** Which CRM connection to push into. */
+  connection_id: string;
+  /** Target list in the CRM. */
+  crm_list_id?: string | null;
+  /** Record count above which the file import is used. */
+  file_import_threshold?: number | null;
+  /** Acknowledge that this job covers a population large enough that the app asks first. Leave unset to keep that refusal in place; set true ONLY when you have read the preview's record count and accept it. This is a safety interlock, not a tuning option - the records land in the customer's Salesforce and cannot be un-pushed. */
+  large_population_confirmed?: boolean | null;
+  /** Push a single graph8 lead row. */
+  lead_id?: number | null;
+  /** Ceiling on records pushed. Omit for the app's default. */
+  limit?: number | null;
+  /** Concurrent batches. */
+  max_parallel?: number | null;
+  /** Add every pushed lead to this Salesforce Campaign as a CampaignMember. */
+  salesforce_campaign_id?: string | null;
+  /** Which population to push. `saved_segment` REQUIRES `audience_id`; `segments_union` REQUIRES `audience_ids`. Omit for the app's default (`all_qualified`). */
+  source_mode?: ("all_qualified" | "saved_segment" | "segments_union" | "all_contacts") | null;
+  /** Salesforce `Lead.Status` API name to set on qualified leads. Read the valid values from `/integrations/crm-sync/leads/statuses` - Lead.Status is an OPEN picklist, so Salesforce stores whatever is sent and an invented value silently becomes a real status. */
+  status_qualified?: string | null;
+  /** Salesforce `Lead.Status` API name for unqualified leads. */
+  status_unqualified?: string | null;
+  /** `no_list` (the app's default), `new_list` or `existing_list`. Sending `crm_list_id` with no mode implies `existing_list`. */
+  sync_list_mode?: ("no_list" | "new_list" | "existing_list") | null;
+  /** Use the provider's bulk file import instead of the API. */
+  use_file_import?: boolean | null;
+}
+
+/** Push ONE audience, rather than everything. */
+export interface PushAudienceRequest {
+  /** graph8 audience to push. */
+  audience_id?: number | null;
+  /** Records per batch. */
+  chunk_size?: number | null;
+  /** Which CRM connection to run against. */
+  connection_id: string;
+  crm_list_id?: string | null;
+  entity_type?: string | null;
+  file_import_threshold?: number | null;
+  /** Ceiling on records processed. OMIT to take the app's own default (5,000 pulling, 10,000 pushing) rather than freezing a copy of it here. */
+  limit?: number | null;
+  /** Concurrent batches. */
+  max_parallel?: number | null;
+  /** Reconcile against what is already in the CRM first. */
+  reconcile?: boolean | null;
+  use_file_import?: boolean | null;
+}
+
+/** Pick a Studio library video (``cb_org_videos`` id) for a Video campaign. */
+export interface RegisterLibraryVideoAssetRequest {
+  org_video_id: string;
+}
+
+/** Register an object uploaded through /upload-url (the key it returned). */
+export interface RegisterVideoAssetRequest {
+  duration_s?: number | null;
+  height?: number | null;
+  key: string;
+  /** upload | studio */
+  source?: string;
+  title?: string | null;
+  width?: number | null;
+}
+
+/**
+ * Record a connection the OAuth flow has already established.
+ *
+ * This does NOT perform the OAuth handshake - the hosted flow does that, and
+ * this stores its result. `connection_id` is the id that flow handed back,
+ * not one you choose.
+ */
+export interface SaveConnectionRequest {
+  /** Provider-specific configuration captured during the flow. */
+  connection_config?: Record<string, string>;
+  /** The id the OAuth flow returned. */
+  connection_id: string;
+  /** Stable graph8 provider name. */
+  provider: string;
+  /** Provider config key. */
+  provider_config_key: string;
+}
+
+/**
+ * Mint a short-lived token for the hosted OAuth flow.
+ *
+ * Both fields are optional because the app's model has them optional - it
+ * falls back to its own default provider. They are NOT interchangeable
+ * spellings of one thing: `provider` is the stable graph8 name and
+ * `provider_config_key` is the key in the connection provider's own config,
+ * and the two can differ per environment.
+ */
+export interface SessionTokenRequest {
+  /** Stable graph8 provider name. */
+  provider?: string | null;
+  /** Provider config key on the connection provider. */
+  provider_config_key?: string | null;
+}
+
+/**
+ * Look at what is in the CRM. Reads the CRM, writes nothing to graph8.
+ *
+ * Discovery is the first half of a migration: it counts records, reads the
+ * field and pipeline shape, and proposes mappings. Nothing is imported until
+ * `confirm-and-start`.
+ */
+export interface StartDiscoveryRequest {
+  connection_id: string;
+  /** Which CRM. The app's default is `hubspot`. */
+  crm_type?: string;
+}
+
+/**
+ * SugarCRM credentials for the password-grant connection.
+ *
+ * WRITE-ONLY: the username, password and client secret are stored encrypted
+ * and no operation returns them.
+ */
+export interface SugarCrmConnectRequest {
+  /** OAuth client id configured in SugarCRM. */
+  client_id?: string;
+  /** OAuth client secret, if your client id has one. */
+  client_secret?: string;
+  /** Your SugarCRM instance, e.g. https://acme.sugarondemand.com. */
+  instance_url: string;
+  password: string;
+  username: string;
+}
+
+/** Turn continuous sync on or off for one connection. */
+export interface SyncEnabledRequest {
+  /** Which CRM connection. */
+  connection_id: string;
+  /** Explicit, not a toggle - a retried request is then idempotent. */
+  enabled: boolean;
+}
+
+/**
+ * A bulk job, or its status. Open-shaped - the payload carries per-provider
+ * progress detail that differs between CRMs and grows with them.
+ */
+export interface SyncJobResponse {
+  job_id?: string | null;
+  status?: string | null;
+  [key: string]: unknown;
+}
+
+export interface UpdateMeetingRequest {
+  company_ids?: Array<string> | null;
+  contact_ids?: Array<string> | null;
+  deal_ids?: Array<string> | null;
+  description?: string | null;
+  end_at?: string | null;
+  location?: string | null;
+  start_at?: string | null;
+  title?: string | null;
+  user_id?: string | null;
+}