logo Windmill Hub
Login
Back to HubSpot integration
0

Batch Read CRM Objects

by
Published today

Retrieve up to 100 CRM records of one object type by ID, or by a unique property via `id_property`.

Script hubspot Verified
Use in Windmill

The script

Submitted by hugo989 Typescript (fetch-only)
Verified 4 hours ago
All edits
Permalink
1 
//native
2
3 
export type DynSelect_object_type = string
4
5 
// Dropdown of the standard CRM object types plus the account's custom objects.
6 
export async function object_type(auth: RT.Hubspot) {
7 
  const standard = [
8 
    "contacts",
9 
    "companies",
10 
    "deals",
11 
    "tickets",
12 
    "line_items",
13 
    "products",
14 
    "quotes",
15 
    "leads",
16 
    "notes",
17 
    "tasks",
18 
    "meetings",
19 
    "calls",
20 
    "emails",
21 
    "communications",
22 
  ].map((o) => ({ value: o, label: o }))
23 
  const response = await fetch("https://api.hubapi.com/crm/v3/schemas", {
24 
    headers: {
25 
      Authorization: `Bearer ${auth.token}`,
26 
      Accept: "application/json",
27 
    },
28 
  })
29 
  // A token without crm.schemas.custom.read still gets the standard objects.
30 
  if (!response.ok) return standard
31 
  const { results } = (await response.json()) as {
32 
    results: { fullyQualifiedName: string; labels: { plural: string } }[]
33 
  }
34 
  return [
35 
    ...standard,
36 
    ...results.map((s) => ({
37 
      value: s.fullyQualifiedName,
38 
      label: `${s.labels.plural} (custom)`,
39 
    })),
40 
  ]
41 
}
42
43 
export type DynMultiselect_properties = string[]
44
45 
// Dependent checklist: the properties of the chosen object type.
46 
export async function properties(
47 
  auth: RT.Hubspot,
48 
  object_type: DynSelect_object_type
49 
) {
50 
  if (!object_type) return []
51 
  const response = await fetch(
52 
    `https://api.hubapi.com/crm/v3/properties/${object_type}`,
53 
    {
54 
      headers: {
55 
        Authorization: `Bearer ${auth.token}`,
56 
        Accept: "application/json",
57 
      },
58 
    }
59 
  )
60 
  if (!response.ok) {
61 
    throw new Error(`${response.status} ${await response.text()}`)
62 
  }
63 
  const { results } = (await response.json()) as {
64 
    results: { name: string; label: string }[]
65 
  }
66 
  return results.map((p) => ({
67 
    value: p.name,
68 
    label: `${p.label} (${p.name})`,
69 
  }))
70 
}
71
72 
/**
73 
 * Batch Read CRM Objects
74 
 * Retrieve up to 100 CRM records of one object type by ID, or by a unique property via `id_property`. Object types other than contacts, companies and deals need their own scope on the connection (e.g. tickets, crm.objects.line_items.read, crm.objects.custom.read).
75 
 */
76 
export async function main(
77 
  auth: RT.Hubspot,
78 
  object_type: DynSelect_object_type,
79 
  ids: string[],
80 
  properties: DynMultiselect_properties | undefined,
81 
  id_property: string | undefined
82 
) {
83 
  const body: { [key: string]: any } = { inputs: ids.map((id) => ({ id })) }
84 
  if (properties?.length) body.properties = properties
85 
  if (id_property != null && id_property !== "") body.idProperty = id_property
86
87 
  const response = await fetch(
88 
    `https://api.hubapi.com/crm/v3/objects/${object_type}/batch/read`,
89 
    {
90 
      method: "POST",
91 
      headers: {
92 
        Authorization: `Bearer ${auth.token}`,
93 
        "Content-Type": "application/json",
94 
        Accept: "application/json",
95 
      },
96 
      body: JSON.stringify(body),
97 
    }
98 
  )
99
100 
  if (!response.ok) {
101 
    throw new Error(`${response.status} ${await response.text()}`)
102 
  }
103
104 
  return await response.json()
105 
}
106