BullhornHub Company icon

BullhornHub Company

Manage Bullhorn companies — CRUD, contacts, industries, leads, notes, parent/child

Actions14

Upsert

AI-generated

Summary

Upsert a Company record in Bullhorn by either updating an existing record matched by a specified field or entity ID or creating a new one if no match is found, with configurable update behavior and data source options.

Inputs

  • Authentication — Choose the authentication method: user credentials (email and password) or enterprise credentials (API key). Defaults to enterprise.
  • Enable Operations Log — Optionally enable logging of each write operation to an audit log output for auditing purposes.
  • Matched Entity ID — Provide a pre-resolved Bullhorn Company entity ID to directly update or create without searching. When set, match fields are ignored.
  • Match Field — Bullhorn Company field name to search for an existing matching record when no Matched Entity ID is given.
  • Match Value — Value to search for in the match field to find a matching record. Not used if Matched Entity ID is provided.
  • Update Mode — Defines update behavior on an existing matching record: only update empty fields, overwrite all specified fields, or do not update (match only). Defaults to updating empty fields only.
  • Create If Not Found — Indicates whether to create a new Company record with the mapped data if no existing record matches. Defaults to true.
  • Input Mode (required) — Selects the source of field data for the upsert operation: from mapped output of a BullhornHub Importer node or manual field mapping.
  • Mapped Data Reference — Expression returning the mapped field data object, defaulting to $json.mapped from the input. Used only if Input Mode is 'From BHH Importer'.
  • Values to Send — Manually map Bullhorn Company fields to values for the upsert when Input Mode is 'Manual Mapping'. Each field includes the target Bullhorn field name and the value to assign, which can be an expression.

Output shape

a single JSON object representing the upserted Company entity, including its Bullhorn ID.

If Enable Operations Log is enabled, a third output stream emits audit log rows for each write operation. If Matched Entity ID is provided, the node bypasses internal search and uses that ID directly for update or creation decision. Update Mode controls field-level update behavior when updating existing records.

Examples

Example 1: Upsert a company by matching its companyURL field value, creating if not found, updating only empty fields, using data from a BullhornHub Importer node.

Set Authentication to 'Enterprise Credentials', Match Field to 'companyURL', provide Match Value, leave Matched Entity ID empty, set Update Mode to 'Update Empty Fields Only', turn on Create If Not Found, Input Mode set to 'From BHH Importer' with appropriate Mapped Data Reference.

Links

Discussion