AdHub App icon

AdHub App

Manage AdHub leads, activities, sources, statuses, tags, and custom fields

Lead → Bulk Update Custom Fields

AI-generated

Summary

Update multiple leads' custom fields in bulk by specifying either a list of lead IDs or filter rules to select target leads, using either form inputs or a raw JSON request body.

Inputs

  • Body Type — Choose the format for specifying the update payload: either as separate form parameters or as a raw JSON object.
  • Target Type — When using form input body type, select whether to target leads by their IDs or by applying filter rules.
  • Lead IDs — A JSON array of lead UUIDs to update when targeting by IDs.
  • Filter Mode — When targeting by filter rules, specify whether the rules are combined using AND or OR logic.
  • Filter Rules — Set of rules to filter which leads to update, supporting various field categories and operators.
  • Custom Fields — Specify the custom field keys and their new values to apply to the targeted leads.
  • Additional / Undocumented Fields (JSON) — Additional custom field data as raw JSON object to include in the update request.
  • Bulk Update Custom Fields Body (JSON) — Use this raw JSON object input to define the entire request payload, including lead IDs, filters, and custom field values, in JSON format.

Output shape

an object representing the API response, typically confirming the bulk update result

The output shape depends on the API response and may include success status and any errors; pagination does not apply.

Examples

Example 1: Update custom fields for leads identified by a list of IDs.

Select 'form' for Body Type, 'ids' for Target Type, provide JSON array of lead IDs, and specify the custom fields to update.

Example 2: Update custom fields for leads filtered by specific field criteria.

Select 'form' for Body Type, 'filter' for Target Type, define filter rules with AND/OR logic, and specify the custom fields to update.

Example 3: Provide the complete update request as a JSON body.

Select 'json' for Body Type and enter the entire bulk update payload as raw JSON in the provided field.

Links

Discussion