Batch Update CRM Objects

//native

export type DynSelect_object_type = string

// Dropdown of the standard CRM object types plus the account's custom objects.

export async function object_type(auth: RT.Hubspot) {

  const standard = [

    "contacts",

    "companies",

    "deals",

    "tickets",

    "line_items",

    "products",

    "quotes",

    "leads",

    "notes",

    "tasks",

    "meetings",

    "calls",

    "emails",

    "communications",

  ].map((o) => ({ value: o, label: o }))

  const response = await fetch("https://api.hubapi.com/crm/v3/schemas", {

    headers: {

      Authorization: `Bearer ${auth.token}`,

      Accept: "application/json",

    },

  })

  // A token without crm.schemas.custom.read still gets the standard objects.

  if (!response.ok) return standard

  const { results } = (await response.json()) as {

    results: { fullyQualifiedName: string; labels: { plural: string } }[]

  }

  return [

    ...standard,

    ...results.map((s) => ({

      value: s.fullyQualifiedName,

      label: `${s.labels.plural} (custom)`,

    })),

  ]

}

/**

 * Batch Update CRM Objects

 * Update up to 100 CRM records of one object type in a single call. Each input holds the record `id`, the `properties` to change, and optionally `idProperty` when `id` is a unique property value. 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).

 */

export async function main(

  auth: RT.Hubspot,

  object_type: DynSelect_object_type,

  inputs: {

    id: string

    properties: { [key: string]: any }

    idProperty?: string

  }[]

) {

  const url = new URL(

    `https://api.hubapi.com/crm/v3/objects/${object_type}/batch/update`

  )

  const body: { [key: string]: any } = {}

  body.inputs = inputs

  const response = await fetch(url, {

    method: "POST",

    headers: {

      Authorization: `Bearer ${auth.token}`,

      "Content-Type": "application/json",

      Accept: "application/json",

    },

    body: JSON.stringify(body),

  })

  if (!response.ok) {

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

  }

  return await response.json()

}