1. Docs
2. /
3. Tool reference
4. /
5. Contacts & CRM
6. /
7. importContacts

Contacts & CRM

importContacts

Import Contacts

Import contacts either from supplied rows or from a TripleSeat contacts export in Cloud Files.

write

Arguments

• batchIdstringoptionalRows path: append to this existing import batch instead of opening a new one.
• categoryobjectoptionalRows path, required with `rows`: what this import is, so the contacts are filed as the people they are.
• dryRunbooleanoptionalTripleSeat path: true (the default) reports what would land without writing anything. Pass false only once the owner has read the report and wants the address book committed.
• fileIdstringoptionalTripleSeat path: the Cloud Files id of the TripleSeat contacts export. Present means the TripleSeat path; omit it to import `rows`.
• folderIdstringoptionalTripleSeat path: the manual contact folder the imported people land in.
• rowsobject[]optionalRows path: the people to import (max 200 per call).
• sourcestringoptionalWhere the contacts came from.
• sourceAccountstringoptionalRows path: the account the rows were read from.
• teamIdstringoptionalTripleSeat path: the team whose shop receives the import.

Returns

The registry does not declare a return shape.

Declared limits

• rows: maximum items 200

Ask for it

The Cloud routes these requests to this verb.

• import these contacts
• add these people as friends
• import my address book
• bring our TripleSeat contacts across

Pair it with

The verbs that finish the job.

• previewContactImport
• undoContactImport
• restageContactImport
• listContactImports
• listContactFolders