import_contacts

Purpose

Bulk-import merchant contact details (email, owner name, country, plan) keyed by myshopify domain — e.g. a CSV export or customers read from a previous analytics tool's MCP. Non-null fields win; nulls never clobber existing data. Max 500 per call; batch larger sets.

Credentials and scope

Owner workspace credential. The credential determines tool visibility. For tools with appId, use the HeyCrust app UUID from list_apps; the dashboard app selector does not supply MCP arguments for you.

Inputs

• contacts: required; array; minItems: 1; maxItems: 500

Example request

The identifiers and merchant are fictional. Replace them with records returned for your own workspace; this example is schema-checked, not a promise that the fictional record exists.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "import_contacts",
    "arguments": {
      "contacts": [
        {
          "shopDomain": "example.myshopify.com",
          "email": "owner@example.com",
          "ownerName": "Example owner"
        }
      ]
    }
  }
}

POST this JSON to https://heycrust.com/api/mcp with Content-Type: application/json and Authorization: Bearer <YOUR_CREDENTIAL>. The tool result normally contains JSON encoded as text in result.content; inspect JSON-RPC errors and result.isError before using it.

Result

Returns imported count. It does not establish that merchant addresses have received any email.

Effects and verification

Writes merchant contacts, keyed by normalized shop domain. Non-null values update fields; null values do not overwrite existing values. This changes stored contact data.

Troubleshooting

A missing tool can mean that the credential lacks its catalog or required scopes. Invalid arguments are different from unavailable source data or a record outside the workspace. A handler can return a business error even when the argument schema is valid. Read MCP overview and Help.

Contact object fields