Create contact list

Create an empty contact list in Findymail.

MCP tool findymail_write → create_contact_list

write

Returns the new list with its ID and dates. It changes only your own account and reaches nobody, so it does not wait for your OK.

Parameters

Parameters: create_contact_list
NameTypeDescription
name string required string Name of the new list.

tools/call

JSON-RPC

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "findymail_write",
    "arguments": {
      "operation": "create_contact_list",
      "arguments": {
        "name": "Jane Doe"
      }
    }
  }
}

Example response

JSON

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "list": {
      "id": 3140,
      "name": "Q1 outreach",
      "created_at": "2026-10-23T09:00:00Z",
      "updated_at": "2026-10-23T09:00:00Z",
      "shared_with_team": false,
      "is_owner": true
    }
  },
  "isError": false
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.