fix(apollo): align tools and block with live API docs

Final pass over the Apollo integration after a per-tool forensic audit
against Apollo.io docs. Notable fixes:

- organization_enrich: GET+querystring -> POST+JSON body (canonical, non
  master-key)
- organization_bulk_enrich: ?domains[]= -> JSON body { organizations }
- people_search: declare/forward organization_num_employees_ranges; fix
  contact_email_status placeholder ("likely to engage", with spaces)
- account_bulk_create: surface failed_accounts and failed count
- contact_bulk_create: expand documented per-contact fields (CRM IDs,
  phone_numbers, contact_emails, typed_custom_fields, etc.)
- sequence_add_contacts: surface remaining documented filter params
- task_create: confirm wire field name (note) and remap from task_notes
- types: tighten params/responses for the above

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

Author: waleedlatif1

apps/docs/content/docs/en/tools/apollo.mdx

@@ -409,7 +409,7 @@ Create up to 100 accounts at once in your Apollo database. Set run_dedupe=true t
 | Parameter | Type | Required | Description |
 | --------- | ---- | -------- | ----------- |
 | `apiKey` | string | Yes | Apollo API key \(master key required\) |
-| `accounts` | array | Yes | Array of accounts to create \(max 100\). Each account should include name \(required\), and optionally domain, phone, owner_id |
+| `accounts` | array | Yes | Array of accounts to create \(max 100\). Each account should include a name, and may optionally include domain, phone, phone_status_cd, raw_address, owner_id, linkedin_url, facebook_url, twitter_url, salesforce_id, and hubspot_id. |
 | `append_label_names` | array | No | Array of label names to add to ALL accounts in this request |
 | `run_dedupe` | boolean | No | When true, performs aggressive deduplication by domain, organization_id, and name \(defaults to false\) |
 
@@ -574,6 +574,13 @@ Add contacts to an Apollo sequence
 | `sequence_job_change` | boolean | No | Add contacts who recently changed jobs |
 | `sequence_active_in_other_campaigns` | boolean | No | Add contacts active in other campaigns |
 | `sequence_finished_in_other_campaigns` | boolean | No | Add contacts who finished other campaigns |
+| `sequence_same_company_in_same_campaign` | boolean | No | Add contacts even if others from the same company are in the sequence |
+| `contacts_without_ownership_permission` | boolean | No | Add contacts without ownership permission |
+| `add_if_in_queue` | boolean | No | Add contacts even if they are in the queue |
+| `contact_verification_skipped` | boolean | No | Skip contact verification when adding |
+| `user_id` | string | No | ID of the user performing the action |
+| `status` | string | No | Initial status for added contacts: "active" or "paused" |
+| `auto_unpause_at` | string | No | ISO 8601 datetime to automatically unpause contacts |
 
 #### Output
 
@@ -598,10 +605,10 @@ Create one or more tasks in Apollo (one task per contact_id, master key required
 | `apiKey` | string | Yes | Apollo API key \(master key required\) |
 | `user_id` | string | Yes | ID of the Apollo user the task is assigned to |
 | `contact_ids` | array | Yes | Array of contact IDs. One task is created per contact. |
-| `priority` | string | Yes | Task priority: "high", "medium", or "low" |
+| `priority` | string | No | Task priority: "high", "medium", or "low" \(defaults to "medium"\) |
 | `due_at` | string | Yes | Due date/time in ISO 8601 format \(e.g., "2024-12-31T23:59:59Z"\) |
-| `type` | string | Yes | Task type: "call", "outreach_manual_email", or "action_item" |
-| `status` | string | Yes | Task status: "scheduled", "completed", or "archived" |
+| `type` | string | Yes | Task type: "call", "outreach_manual_email", "linkedin_step_connect", "linkedin_step_message", "linkedin_step_view_profile", "linkedin_step_interact_post", or "action_item" |
+| `status` | string | Yes | Task status: "scheduled", "completed", or "skipped" |
 | `note` | string | No | Free-form note providing context for the task |
 
 #### Output

apps/sim/blocks/blocks/apollo.ts

@@ -103,7 +103,7 @@ export const ApolloBlock: BlockConfig<ApolloResponse> = {
       id: 'contact_email_status',
       title: 'Contact Email Status',
       type: 'code',
-      placeholder: '["verified", "unverified", "likely_to_engage"]',
+      placeholder: '["verified", "unverified", "likely to engage"]',
       condition: { field: 'operation', value: 'people_search' },
       mode: 'advanced',
     },
@@ -213,9 +213,10 @@ export const ApolloBlock: BlockConfig<ApolloResponse> = {
     },
     {
       id: 'organizations',
-      title: 'Organizations (JSON Array of domain objects)',
+      title: 'Organizations (JSON Array)',
       type: 'code',
-      placeholder: '[{"domain": "companya.com"}, {"domain": "companyb.com"}]',
+      placeholder:
+        '[{"name": "Company A", "domain": "companya.com"}, {"name": "Company B", "domain": "companyb.com"}]',
       condition: { field: 'operation', value: 'organization_bulk_enrich' },
       required: true,
     },
@@ -258,7 +259,7 @@ export const ApolloBlock: BlockConfig<ApolloResponse> = {
       title: 'Employee Count Ranges',
       type: 'code',
       placeholder: '["1,10", "11,50", "51,200"]',
-      condition: { field: 'operation', value: 'organization_search' },
+      condition: { field: 'operation', value: ['organization_search', 'people_search'] },
       mode: 'advanced',
     },
     {
@@ -709,6 +710,61 @@ Return ONLY the date string in YYYY-MM-DD format - no explanations, no quotes, n
       condition: { field: 'operation', value: 'sequence_add' },
       mode: 'advanced',
     },
+    {
+      id: 'sequence_same_company_in_same_campaign',
+      title: 'Allow Same Company in Same Campaign',
+      type: 'switch',
+      condition: { field: 'operation', value: 'sequence_add' },
+      mode: 'advanced',
+    },
+    {
+      id: 'contacts_without_ownership_permission',
+      title: 'Add Contacts Without Ownership Permission',
+      type: 'switch',
+      condition: { field: 'operation', value: 'sequence_add' },
+      mode: 'advanced',
+    },
+    {
+      id: 'add_if_in_queue',
+      title: 'Add If In Queue',
+      type: 'switch',
+      condition: { field: 'operation', value: 'sequence_add' },
+      mode: 'advanced',
+    },
+    {
+      id: 'contact_verification_skipped',
+      title: 'Skip Contact Verification',
+      type: 'switch',
+      condition: { field: 'operation', value: 'sequence_add' },
+      mode: 'advanced',
+    },
+    {
+      id: 'sequence_user_id',
+      title: 'Acting User ID',
+      type: 'short-input',
+      placeholder: 'Apollo user ID',
+      condition: { field: 'operation', value: 'sequence_add' },
+      mode: 'advanced',
+    },
+    {
+      id: 'sequence_status',
+      title: 'Initial Status',
+      type: 'dropdown',
+      options: [
+        { label: 'Active', id: 'active' },
+        { label: 'Paused', id: 'paused' },
+      ],
+      condition: { field: 'operation', value: 'sequence_add' },
+      mode: 'advanced',
+    },
+    {
+      id: 'auto_unpause_at',
+      title: 'Auto Unpause At',
+      type: 'short-input',
+      placeholder: 'ISO 8601 (e.g., 2024-12-31T23:59:59Z)',
+      condition: { field: 'operation', value: 'sequence_add' },
+      mode: 'advanced',
+    },
 
     // Task Create Fields
     {
@@ -730,7 +786,6 @@ Return ONLY the date string in YYYY-MM-DD format - no explanations, no quotes, n
       ],
       value: () => 'medium',
       condition: { field: 'operation', value: 'task_create' },
-      required: true,
     },
     {
       id: 'type',
@@ -739,6 +794,10 @@ Return ONLY the date string in YYYY-MM-DD format - no explanations, no quotes, n
       options: [
         { label: 'Call', id: 'call' },
         { label: 'Outreach Manual Email', id: 'outreach_manual_email' },
+        { label: 'LinkedIn — Connect', id: 'linkedin_step_connect' },
+        { label: 'LinkedIn — Message', id: 'linkedin_step_message' },
+        { label: 'LinkedIn — View Profile', id: 'linkedin_step_view_profile' },
+        { label: 'LinkedIn — Interact with Post', id: 'linkedin_step_interact_post' },
         { label: 'Action Item', id: 'action_item' },
       ],
       value: () => 'action_item',
@@ -752,7 +811,7 @@ Return ONLY the date string in YYYY-MM-DD format - no explanations, no quotes, n
       options: [
         { label: 'Scheduled', id: 'scheduled' },
         { label: 'Completed', id: 'completed' },
-        { label: 'Archived', id: 'archived' },
+        { label: 'Skipped', id: 'skipped' },
       ],
       value: () => 'scheduled',
       condition: { field: 'operation', value: 'task_create' },
@@ -1056,6 +1115,14 @@ Return ONLY the timestamp string in ISO 8601 format - no explanations, no quotes
             parsedParams.label_names = parsedParams.sequence_add_label_names
           }
           parsedParams.sequence_add_label_names = undefined
+          if (rest.sequence_user_id !== undefined && rest.sequence_user_id !== '') {
+            parsedParams.user_id = rest.sequence_user_id
+          }
+          parsedParams.sequence_user_id = undefined
+          if (rest.sequence_status !== undefined && rest.sequence_status !== '') {
+            parsedParams.status = rest.sequence_status
+          }
+          parsedParams.sequence_status = undefined
         }
 
         if (params.operation === 'task_create') {

apps/sim/tools/apollo/account_bulk_create.ts

@@ -26,7 +26,7 @@ export const apolloAccountBulkCreateTool: ToolConfig<
       required: true,
       visibility: 'user-or-llm',
       description:
-        'Array of accounts to create (max 100). Each account should include name (required), and optionally domain, phone, owner_id',
+        'Array of accounts to create (max 100). Each account should include a name, and may optionally include domain, phone, phone_status_cd, raw_address, owner_id, linkedin_url, facebook_url, twitter_url, salesforce_id, and hubspot_id.',
     },
     append_label_names: {
       type: 'array',
@@ -76,15 +76,18 @@ export const apolloAccountBulkCreateTool: ToolConfig<
         ? data.accounts
         : []
     const existingAccounts = Array.isArray(data.existing_accounts) ? data.existing_accounts : []
+    const failedAccounts = Array.isArray(data.failed_accounts) ? data.failed_accounts : []
 
     return {
       success: true,
       output: {
         created_accounts: createdAccounts,
         existing_accounts: existingAccounts,
-        total_submitted: createdAccounts.length + existingAccounts.length,
+        failed_accounts: failedAccounts,
+        total_submitted: createdAccounts.length + existingAccounts.length + failedAccounts.length,
         created: createdAccounts.length,
         existing: existingAccounts.length,
+        failed: failedAccounts.length,
       },
     }
   },
@@ -98,9 +101,13 @@ export const apolloAccountBulkCreateTool: ToolConfig<
       type: 'json',
       description: 'Array of existing accounts returned by Apollo (when duplicates are detected)',
     },
+    failed_accounts: {
+      type: 'json',
+      description: 'Array of accounts that failed to be created, with reasons for failure',
+    },
     total_submitted: {
       type: 'number',
-      description: 'Total number of accounts in the response (created + existing)',
+      description: 'Total number of accounts in the response (created + existing + failed)',
     },
     created: {
       type: 'number',
@@ -110,5 +117,9 @@ export const apolloAccountBulkCreateTool: ToolConfig<
       type: 'number',
       description: 'Number of existing accounts found',
     },
+    failed: {
+      type: 'number',
+      description: 'Number of accounts that failed to be created',
+    },
   },
 }

apps/sim/tools/apollo/contact_bulk_create.ts

@@ -26,7 +26,7 @@ export const apolloContactBulkCreateTool: ToolConfig<
       required: true,
       visibility: 'user-or-llm',
       description:
-        'Array of contacts to create (max 100). Each contact may include first_name, last_name, email, title, organization_name, owner_id, contact_stage_id, linkedin_url, phone_numbers, and contact_emails',
+        'Array of contacts to create (max 100). Each contact may include first_name, last_name, email, title, organization_name, account_id, owner_id, contact_stage_id, linkedin_url, phone (single string) or phone_numbers (array of {raw_number, position}), contact_emails, typed_custom_fields, and CRM IDs (salesforce_contact_id, hubspot_id, team_id) for cross-system matching',
     },
     append_label_names: {
       type: 'array',

apps/sim/tools/apollo/organization_bulk_enrich.ts

@@ -24,24 +24,22 @@ export const apolloOrganizationBulkEnrichTool: ToolConfig<
       type: 'array',
       required: true,
       visibility: 'user-or-llm',
-      description: 'Array of organizations to enrich (max 10)',
+      description:
+        'Array of organizations to enrich (max 10). Each item requires `name` and may include `domain` (e.g., [{"name": "Example Corp", "domain": "example.com"}])',
     },
   },
 
   request: {
-    url: (params: ApolloOrganizationBulkEnrichParams) => {
-      const domains = params.organizations
-        .slice(0, 10)
-        .map((o) => o.domain)
-        .filter((d): d is string => Boolean(d))
-      const qs = domains.map((d) => `domains[]=${encodeURIComponent(d)}`).join('&')
-      return `https://api.apollo.io/api/v1/organizations/bulk_enrich${qs ? `?${qs}` : ''}`
-    },
+    url: 'https://api.apollo.io/api/v1/organizations/bulk_enrich',
     method: 'POST',
     headers: (params: ApolloOrganizationBulkEnrichParams) => ({
+      'Content-Type': 'application/json',
       'Cache-Control': 'no-cache',
       'X-Api-Key': params.apiKey,
     }),
+    body: (params: ApolloOrganizationBulkEnrichParams) => ({
+      organizations: params.organizations.slice(0, 10),
+    }),
   },
 
   transformResponse: async (response: Response) => {

apps/sim/tools/apollo/organization_enrich.ts

@@ -29,18 +29,20 @@ export const apolloOrganizationEnrichTool: ToolConfig<
   },
 
   request: {
-    url: (params: ApolloOrganizationEnrichParams) => {
+    url: 'https://api.apollo.io/api/v1/organizations/enrich',
+    method: 'POST',
+    headers: (params: ApolloOrganizationEnrichParams) => ({
+      'Content-Type': 'application/json',
+      'Cache-Control': 'no-cache',
+      'X-Api-Key': params.apiKey,
+    }),
+    body: (params: ApolloOrganizationEnrichParams) => {
       const domain = params.domain?.trim()
       if (!domain) {
         throw new Error('domain is required for organization enrichment')
       }
-      return `https://api.apollo.io/api/v1/organizations/enrich?domain=${encodeURIComponent(domain)}`
+      return { domain }
     },
-    method: 'GET',
-    headers: (params: ApolloOrganizationEnrichParams) => ({
-      'Cache-Control': 'no-cache',
-      'X-Api-Key': params.apiKey,
-    }),
   },
 
   transformResponse: async (response: Response) => {

apps/sim/tools/apollo/people_search.ts

@@ -68,12 +68,19 @@ export const apolloPeopleSearchTool: ToolConfig<
       description:
         'Employer domain names (e.g., ["apollo.io", "microsoft.com"]) — up to 1,000, no www. or @',
     },
+    organization_num_employees_ranges: {
+      type: 'array',
+      required: false,
+      visibility: 'user-or-llm',
+      description:
+        'Employee count ranges for the person\'s current employer. Each entry is "min,max" (e.g., ["1,10", "250,500", "10000,20000"])',
+    },
     contact_email_status: {
       type: 'array',
       required: false,
       visibility: 'user-or-llm',
       description:
-        'Email statuses to filter by: verified, unverified, likely to engage, unavailable',
+        'Email statuses to filter by: "verified", "unverified", "likely to engage", "unavailable"',
     },
     q_keywords: {
       type: 'string',
@@ -133,6 +140,12 @@ export const apolloPeopleSearchTool: ToolConfig<
       if (params.q_organization_domains_list && params.q_organization_domains_list.length > 0) {
         body.q_organization_domains_list = params.q_organization_domains_list
       }
+      if (
+        params.organization_num_employees_ranges &&
+        params.organization_num_employees_ranges.length > 0
+      ) {
+        body.organization_num_employees_ranges = params.organization_num_employees_ranges
+      }
       if (params.contact_email_status && params.contact_email_status.length > 0) {
         body.contact_email_status = params.contact_email_status
       }

apps/sim/tools/apollo/sequence_add_contacts.ts

@@ -83,6 +83,48 @@ export const apolloSequenceAddContactsTool: ToolConfig<
       visibility: 'user-only',
       description: 'Add contacts who finished other campaigns',
     },
+    sequence_same_company_in_same_campaign: {
+      type: 'boolean',
+      required: false,
+      visibility: 'user-only',
+      description: 'Add contacts even if others from the same company are in the sequence',
+    },
+    contacts_without_ownership_permission: {
+      type: 'boolean',
+      required: false,
+      visibility: 'user-only',
+      description: 'Add contacts without ownership permission',
+    },
+    add_if_in_queue: {
+      type: 'boolean',
+      required: false,
+      visibility: 'user-only',
+      description: 'Add contacts even if they are in the queue',
+    },
+    contact_verification_skipped: {
+      type: 'boolean',
+      required: false,
+      visibility: 'user-only',
+      description: 'Skip contact verification when adding',
+    },
+    user_id: {
+      type: 'string',
+      required: false,
+      visibility: 'user-only',
+      description: 'ID of the user performing the action',
+    },
+    status: {
+      type: 'string',
+      required: false,
+      visibility: 'user-only',
+      description: 'Initial status for added contacts: "active" or "paused"',
+    },
+    auto_unpause_at: {
+      type: 'string',
+      required: false,
+      visibility: 'user-only',
+      description: 'ISO 8601 datetime to automatically unpause contacts',
+    },
   },
 
   request: {
@@ -124,6 +166,19 @@ export const apolloSequenceAddContactsTool: ToolConfig<
       if (params.sequence_finished_in_other_campaigns !== undefined) {
         body.sequence_finished_in_other_campaigns = params.sequence_finished_in_other_campaigns
       }
+      if (params.sequence_same_company_in_same_campaign !== undefined) {
+        body.sequence_same_company_in_same_campaign = params.sequence_same_company_in_same_campaign
+      }
+      if (params.contacts_without_ownership_permission !== undefined) {
+        body.contacts_without_ownership_permission = params.contacts_without_ownership_permission
+      }
+      if (params.add_if_in_queue !== undefined) body.add_if_in_queue = params.add_if_in_queue
+      if (params.contact_verification_skipped !== undefined) {
+        body.contact_verification_skipped = params.contact_verification_skipped
+      }
+      if (params.user_id) body.user_id = params.user_id
+      if (params.status) body.status = params.status
+      if (params.auto_unpause_at) body.auto_unpause_at = params.auto_unpause_at
       return body
     },
   },