​
MCP Tool: create_bulk_customer_contacts

Creates multiple customer contacts in a single request. This tool is useful for bulk importing contacts or creating multiple contacts for an account at once.

​
Example Prompt

Create bulk customer contacts for account ACC001 with contacts John Smith and Jane Doe

​
Input Parameters

NameTypeRequiredDescription
contactsarrayYesList of customer contacts to create

​
Contact Object Structure

Each contact in the contacts array contains:
FieldTypeRequiredDescription
accountIdstringYesThe account ID to associate the contact with
firstNamestringNoFirst name of the contact
lastNamestringNoLast name of the contact
emailstringYesEmail address of the contact
phonestringNoPhone number of the contact
jobTitlestringNoJob title of the contact
contactTypestringNoType of contact (e.g., primary, billing, technical)
metadataobjectNoAdditional metadata for the contact

​
Response Fields

The response will contain a summary of the bulk creation operation:
FieldTypeDescription
totalnumberThe total number of contacts provided
creatednumberThe number of contacts successfully created
skippednumberThe number of contacts skipped due to existing contacts with the same email

​
Sample Response

{
  "data": {
    "total": 3,
    "created": 2,
    "skipped": 1
  },
  "status": true,
  "message": "Bulk customer contacts created successfully!",
  "timestamp": "2025-07-25T12:50:38.937Z"
}