> ## Documentation Index
> Fetch the complete documentation index at: https://docs.automate.ax/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Automate.ax automations are TypeScript programs.
> Use Bun for installation and command examples.
> Use Automate.ax for the product name and automate.ax for the package, CLI, and domain.
> Treat documented public APIs as current; do not invent transitional or deprecated names.

# Bulk create contacts

> Create up to 100 Apollo contacts and separate deduplication matches.

`bulkCreateContacts` creates up to 100 contacts in one provider request.

```ts automations/bulk-create-apollo-contacts.automation.ts theme={null}
import { automation, onHttpRequest } from "automate.ax"
import { bulkCreateContacts } from "automate.ax/apollo"

export default automation("Import Apollo contacts", () => {
  onHttpRequest({ scope: "automation" })
  bulkCreateContacts({
    contacts: [
      { email: "ada@example.com", firstName: "Ada" },
      { email: "grace@example.com", firstName: "Grace" },
    ],
    owner: "seller@example.com",
    listNames: ["Imported"],
  })
})
```

| Input       | Type                                              | Required | Default         | Description                                             |
| ----------- | ------------------------------------------------- | -------- | --------------- | ------------------------------------------------------- |
| `contacts`  | `BulkContactInput[]`                              | Yes      | —               | 1–100 contacts.                                         |
| `owner`     | `ApolloReference`                                 | No       | None            | Owner applied to every new contact.                     |
| `listNames` | `string[]`                                        | No       | None            | Exact list names applied to every new contact.          |
| `runDedupe` | `boolean`                                         | No       | `true`          | Return existing matches instead of creating duplicates. |
| `account`   | `string \| IntegrationAccountReference<"apollo">` | No       | Project default | Connected workspace.                                    |

Each contact may include account/stage references, names, email, title,
organization, LinkedIn URL, address, and custom fields. Returns
`{ createdContacts, existingContacts }`.