Contacts

Contacts are the people you message. Create and find them with the create_contact and search_contacts tools, then pass a contact’s id to send_message.

Create a contact

first_name and last_name are required; email, phone, company, title, and tags are optional.

{
  "jsonrpc": "2.0", "id": 1, "method": "tools/call",
  "params": {
    "name": "create_contact",
    "arguments": {
      "first_name": "Sam",
      "last_name": "Rivera",
      "email": "sam@acme.com",
      "phone": "+15551234567",
      "tags": ["signup", "pro"]
    }
  }
}

Search contacts

Filter by free-text query (name/email/company), status, tags, and lead-score range (min_score/max_score).

{
  "jsonrpc": "2.0", "id": 2, "method": "tools/call",
  "params": {
    "name": "search_contacts",
    "arguments": { "query": "acme", "status": "active", "min_score": 60 }
  }
}