Search leads

//native

type Pipedrive = {

  apiToken: string;

};

/**

 * Search leads

 * Searches all leads by title, notes and/or custom fields. This endpoint is a wrapper of /v1/itemSearch with a narrower OAuth scope. Found leads can be filtered by the person ID and the organization ID.

 */

export async function main(

  auth: Pipedrive,

  term: string | undefined,

  fields: "custom_fields" | "notes" | "title" | undefined,

  exact_match: string | undefined,

  person_id: string | undefined,

  organization_id: string | undefined,

  include_fields: "lead.was_seen" | undefined,

  limit: string | undefined,

  cursor: string | undefined,

) {

  const url = new URL(`https://api.pipedrive.com/api/v2/leads/search`);

  for (const [k, v] of [

    ["term", term],

    ["fields", fields],

    ["exact_match", exact_match],

    ["person_id", person_id],

    ["organization_id", organization_id],

    ["include_fields", include_fields],

    ["limit", limit],

    ["cursor", cursor],

  ]) {

    if (v !== undefined && v !== "" && k !== undefined) {

      url.searchParams.append(k, v);

    }

  }

  const response = await fetch(url, {

    method: "GET",

    headers: {

      "x-api-token": auth.apiToken,

    },

    body: undefined,

  });

  if (!response.ok) {

    const text = await response.text();

    throw new Error(`${response.status} ${text}`);

  }

  return await response.json();

}