{
  "info": {
    "name": "Heyreach — mcp.ai",
    "description": "REST API for the Heyreach MCP. Set {{apiKey}} to a workspace key (sk_live_…) created at https://mcp.ai/settings/api-keys.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "auth": {
    "type": "bearer",
    "bearer": [
      {
        "key": "token",
        "value": "{{apiKey}}",
        "type": "string"
      }
    ]
  },
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://api.mcp.ai/api/heyreach",
      "type": "string"
    },
    {
      "key": "apiKey",
      "value": "sk_live_...",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "heyreach_add_leads_to_list_v2",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/add/leads/to/list/v2",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "add",
            "leads",
            "to",
            "list",
            "v2"
          ]
        },
        "description": "Tool to add leads to a lead list in HeyReach for LinkedIn campaigns. Accepts up to 100 leads per request and returns counts of added, updated, and failed leads.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"leads\": \"\",\n  \"listId\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "heyreach_check_api_key",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/check/api/key",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "check",
            "api",
            "key"
          ]
        },
        "description": "Tool to check if the API key is valid. Use before making other API calls to confirm authentication.",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "heyreach_create_empty_list",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/empty/list",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "empty",
            "list"
          ]
        },
        "description": "Tool to create an empty list. Use after deciding on the list name and type.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"name\": \"\",\n  \"type\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "heyreach_create_tags",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/tags",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "tags"
          ]
        },
        "description": "Tool to create one or multiple tags for your workspace. Use when you need to organize leads with custom labels.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"tags\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "heyreach_create_webhook",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/webhook",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "webhook"
          ]
        },
        "description": "Tool to create a new webhook. Use when you need programmatic callbacks for HeyReach events after confirming a valid API key.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"eventType\": \"\",\n  \"webhookUrl\": \"\",\n  \"campaignIds\": \"\",\n  \"webhookName\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "heyreach_delete_webhook",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/delete/webhook",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "delete",
            "webhook"
          ]
        },
        "description": "Tool to delete an existing webhook. Use when you need to remove callbacks for outdated or unwanted webhooks.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"webhookId\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "heyreach_get_all_campaigns",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/all/campaigns",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "all",
            "campaigns"
          ]
        },
        "description": "Tool to retrieve all campaigns. Use when you need a paginated list of campaigns for management or reporting.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"limit\": 0,\n  \"offset\": 0,\n  \"keyword\": \"\",\n  \"statuses\": \"\",\n  \"accountIds\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "heyreach_get_all_leads",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/all/leads",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "all",
            "leads"
          ]
        },
        "description": "Tool to retrieve all leads in a HeyReach list. Use when you need paginated collection of leads after confirming a valid API key.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"limit\": 0,\n  \"listId\": 0,\n  \"offset\": 0,\n  \"keyword\": \"\",\n  \"createdTo\": \"\",\n  \"createdFrom\": \"\",\n  \"leadLinkedInId\": \"\",\n  \"leadProfileUrl\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "heyreach_get_all_linkedin_accounts",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/all/linkedin/accounts",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "all",
            "linkedin",
            "accounts"
          ]
        },
        "description": "Tool to retrieve all LinkedIn accounts. Use when you need a paginated list of LinkedIn accounts after confirming a valid API key.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"limit\": 0,\n  \"offset\": 0,\n  \"keyword\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "heyreach_get_all_lists",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/all/lists",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "all",
            "lists"
          ]
        },
        "description": "Tool to retrieve all lists. Use when you need a paginated list of lists after confirming a valid API key.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"limit\": 0,\n  \"offset\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "heyreach_get_all_webhooks",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/all/webhooks",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "all",
            "webhooks"
          ]
        },
        "description": "Tool to retrieve all webhooks. Use when you need a paginated collection of webhooks after confirming a valid API key.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"limit\": 0,\n  \"offset\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "heyreach_get_companies_from_list",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/companies/from/list",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "companies",
            "from",
            "list"
          ]
        },
        "description": "Tool to get companies from a company list. Use when you need a paginated list of companies after specifying a list ID.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"limit\": 0,\n  \"listId\": 0,\n  \"offset\": 0,\n  \"keyword\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "heyreach_get_conversations_v2",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/conversations/v2",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "conversations",
            "v2"
          ]
        },
        "description": "Tool to retrieve paginated LinkedIn conversations with advanced filters. Use when you need to fetch inbox conversations filtered by lead or profile details.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"limit\": 0,\n  \"offset\": 0,\n  \"filters\": {}\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "heyreach_get_lead",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/lead",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "lead"
          ]
        },
        "description": "Tool to retrieve detailed information for a lead by profile URL. Use after obtaining the exact LinkedIn profile URL to fetch full lead details.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"profileUrl\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "heyreach_get_lists_for_lead",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/lists/for/lead",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "lists",
            "for",
            "lead"
          ]
        },
        "description": "Tool to retrieve all lists that contain a specific lead by profile URL. Use when you need to find which lists a lead belongs to.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"limit\": 0,\n  \"offset\": 0,\n  \"profileUrl\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "heyreach_get_my_network_for_sender",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/my/network/for/sender",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "my",
            "network",
            "for",
            "sender"
          ]
        },
        "description": "Tool to get the LinkedIn network for a specified sender account. Use when you need to retrieve paginated connections for a sender.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"pageSize\": 0,\n  \"senderId\": 0,\n  \"pageNumber\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "heyreach_get_overall_stats",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/overall/stats",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "overall",
            "stats"
          ]
        },
        "description": "Tool to get overall statistics for LinkedIn accounts and campaigns. Use when you need performance metrics including connection requests, messages, replies, and engagement rates for specified date rang",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"dateTo\": \"\",\n  \"dateFrom\": \"\",\n  \"accountIds\": \"\",\n  \"campaignIds\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "heyreach_get_webhook_by_id",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/webhook/by/id",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "webhook",
            "by",
            "id"
          ]
        },
        "description": "Tool to retrieve a webhook by its ID. Use when you need detailed configuration of a specific webhook after listing or creating it.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"webhookId\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "heyreach_update_webhook",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/update/webhook",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "update",
            "webhook"
          ]
        },
        "description": "Tool to update an existing webhook’s configuration. Use when you need to modify a webhook's name, URL, event type, campaigns, or activation status after confirming the webhookId.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"isActive\": false,\n  \"eventType\": \"\",\n  \"webhookId\": \"\",\n  \"webhookUrl\": \"\",\n  \"campaignIds\": \"\",\n  \"webhookName\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    }
  ]
}