simstudioai--sim/apps/sim/tools/apollo/contact_create.ts

import type { ApolloContactCreateParams, ApolloContactCreateResponse } from '@/tools/apollo/types'
import type { ToolConfig } from '@/tools/types'

export const apolloContactCreateTool: ToolConfig<
  ApolloContactCreateParams,
  ApolloContactCreateResponse
> = {
  id: 'apollo_contact_create',
  name: 'Apollo Create Contact',
  description: 'Create a new contact in your Apollo database',
  version: '1.0.0',

  params: {
    apiKey: {
      type: 'string',
      required: true,
      visibility: 'user-only',
      description: 'Apollo API key',
    },
    first_name: {
      type: 'string',
      required: true,
      visibility: 'user-or-llm',
      description: 'First name of the contact',
    },
    last_name: {
      type: 'string',
      required: true,
      visibility: 'user-or-llm',
      description: 'Last name of the contact',
    },
    email: {
      type: 'string',
      required: false,
      visibility: 'user-or-llm',
      description: 'Email address of the contact',
    },
    title: {
      type: 'string',
      required: false,
      visibility: 'user-or-llm',
      description: 'Job title (e.g., "VP of Sales", "Software Engineer")',
    },
    account_id: {
      type: 'string',
      required: false,
      visibility: 'user-or-llm',
      description: 'Apollo account ID to associate with (e.g., "acc_abc123")',
    },
    owner_id: {
      type: 'string',
      required: false,
      visibility: 'user-only',
      description:
        'User ID of the contact owner (accepted by Apollo but not officially documented for POST /contacts)',
    },
    organization_name: {
      type: 'string',
      required: false,
      visibility: 'user-or-llm',
      description: 'Name of the contact\'s employer (e.g., "Apollo")',
    },
    website_url: {
      type: 'string',
      required: false,
      visibility: 'user-or-llm',
      description: 'Corporate website URL (e.g., "https://www.apollo.io/")',
    },
    label_names: {
      type: 'array',
      required: false,
      visibility: 'user-or-llm',
      description: 'Lists/labels to add the contact to (e.g., ["Prospects"])',
    },
    contact_stage_id: {
      type: 'string',
      required: false,
      visibility: 'user-or-llm',
      description: 'Apollo ID for the contact stage',
    },
    present_raw_address: {
      type: 'string',
      required: false,
      visibility: 'user-or-llm',
      description: 'Personal location for the contact (e.g., "Atlanta, United States")',
    },
    direct_phone: {
      type: 'string',
      required: false,
      visibility: 'user-or-llm',
      description: 'Primary phone number',
    },
    corporate_phone: {
      type: 'string',
      required: false,
      visibility: 'user-or-llm',
      description: 'Work/office phone number',
    },
    mobile_phone: {
      type: 'string',
      required: false,
      visibility: 'user-or-llm',
      description: 'Mobile phone number',
    },
    home_phone: {
      type: 'string',
      required: false,
      visibility: 'user-or-llm',
      description: 'Home phone number',
    },
    other_phone: {
      type: 'string',
      required: false,
      visibility: 'user-or-llm',
      description: 'Alternative phone number',
    },
    typed_custom_fields: {
      type: 'json',
      required: false,
      visibility: 'user-or-llm',
      description: 'Custom field values keyed by custom field ID',
    },
    run_dedupe: {
      type: 'boolean',
      required: false,
      visibility: 'user-only',
      description: 'When true, Apollo deduplicates against existing contacts',
    },
  },

  request: {
    url: 'https://api.apollo.io/api/v1/contacts',
    method: 'POST',
    headers: (params: ApolloContactCreateParams) => ({
      'Content-Type': 'application/json',
      'Cache-Control': 'no-cache',
      'X-Api-Key': params.apiKey,
    }),
    body: (params: ApolloContactCreateParams) => {
      const body: Record<string, unknown> = {
        first_name: params.first_name,
        last_name: params.last_name,
      }
      if (params.email) body.email = params.email
      if (params.title) body.title = params.title
      if (params.account_id) body.account_id = params.account_id
      if (params.owner_id) body.owner_id = params.owner_id
      if (params.organization_name) body.organization_name = params.organization_name
      if (params.website_url) body.website_url = params.website_url
      if (params.label_names && params.label_names.length > 0) {
        body.label_names = params.label_names
      }
      if (params.contact_stage_id) body.contact_stage_id = params.contact_stage_id
      if (params.present_raw_address) body.present_raw_address = params.present_raw_address
      if (params.direct_phone) body.direct_phone = params.direct_phone
      if (params.corporate_phone) body.corporate_phone = params.corporate_phone
      if (params.mobile_phone) body.mobile_phone = params.mobile_phone
      if (params.home_phone) body.home_phone = params.home_phone
      if (params.other_phone) body.other_phone = params.other_phone
      if (params.typed_custom_fields) body.typed_custom_fields = params.typed_custom_fields
      if (params.run_dedupe !== undefined) body.run_dedupe = params.run_dedupe
      return body
    },
  },

  transformResponse: async (response: Response) => {
    if (!response.ok) {
      const errorText = await response.text()
      throw new Error(`Apollo API error: ${response.status} - ${errorText}`)
    }

    const data = await response.json()
    const contact = data?.contact ?? (data?.id ? data : null)

    return {
      success: true,
      output: {
        contact,
        created: !!contact,
      },
    }
  },

  outputs: {
    contact: { type: 'json', description: 'Created contact data from Apollo', optional: true },
    created: { type: 'boolean', description: 'Whether the contact was successfully created' },
  },
}