Find Pipedrive Person by Email

What the model is told

Look up one person in Pipedrive by the exact email address the customer gives you. Returns the matching person, including their ID, which other Pipedrive tools need. If nothing is returned, no person has that email. Do not read out details the customer has not asked for.

Request

Headers

• x-api-tokenYOUR_PIPEDRIVE_API_TOKEN

Parameters

• email stringThe customer's full email address.

{
  "source": "VOICE_AI",
  "tool": {
    "id": "300f7e4c-253a-45ec-a14d-302b70ec67f2",
    "type": "HTTP_REQUEST",
    "label": "Find Pipedrive Person by Email",
    "name": "find_pipedrive_person_by_email",
    "customName": false,
    "description": "Look up one person in Pipedrive by the exact email address the customer gives you. Returns the matching person, including their ID, which other Pipedrive tools need. If nothing is returned, no person has that email. Do not read out details the customer has not asked for.",
    "parameters": [
      {
        "name": "email",
        "type": "string",
        "description": "The customer's full email address."
      }
    ],
    "config": {
      "endpoint": {
        "method": "GET",
        "url": "https://YOUR_COMPANY_DOMAIN.pipedrive.com/api/v2/persons/search?term={{email}}&fields=email&exact_match=true&limit=1"
      },
      "headers": [
        {
          "name": "x-api-token",
          "value": "YOUR_PIPEDRIVE_API_TOKEN"
        }
      ],
      "body": null,
      "timeout": null
    }
  }
}

IDs are regenerated on every copy.