AdHub App icon

AdHub App

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

Lead → Bulk Sync Tags

AI-generated

Summary

Synchronize tags in bulk on leads by adding and/or removing specified tags for targeted leads selected either by their IDs or by applying filter rules.

Inputs

  • Body Type (required) — Specify the format of the request body, either as 'form' parameters or as raw JSON.
  • Target Type (required) — Define the target leads by selecting specific lead IDs or by using filter rules (only applicable when 'Body Type' is 'form').
  • Lead IDs — A JSON array of lead ID strings to target leads directly (shown if 'Body Type' is 'form' and 'Target Type' is 'ids').
  • Filter Mode — Logical operator to combine multiple filter rules, either 'AND' or 'OR' (shown if 'Body Type' is 'form' and 'Target Type' is 'filter').
  • Filter Rules — One or more filter rules specifying categories, fields, operators, and values for lead selection (shown if 'Body Type' is 'form' and 'Target Type' is 'filter').
  • Add Tag IDs — One or more tags to be added to the targeted leads, specified by name or ID (shown only if 'Body Type' is 'form').
  • Remove Tag IDs — One or more tags to be removed from the targeted leads, specified by name or ID (shown only if 'Body Type' is 'form').
  • Bulk Sync Tags Body (JSON) (required) — A JSON object request body directly specifying lead IDs, filter criteria, tags to add, and tags to remove (shown only if 'Body Type' is 'json').

Output shape

A JSON response object representing the result of the bulk tag synchronization operation returned by the AdHub API.

Results correspond to the API response from the bulk sync endpoint. Use either 'form' inputs or provide a raw JSON body but not both. The operation may affect multiple leads simultaneously based on targeting criteria.

Examples

Example 1: Add and remove tags on leads using IDs

Set Body Type to 'form', Target Type to 'IDs', provide Lead IDs array, specify tags to add and/or remove.

Example 2: Bulk sync tags on leads filtered by conditions

Set Body Type to 'form', Target Type to 'Filter', specify Filter Mode and multiple Filter Rules, define tags to add and remove.

Example 3: Use JSON request body to bulk sync tags

Set Body Type to 'JSON' and provide full JSON request body with 'lead_ids', 'filter', 'add_tag_ids', and 'remove_tag_ids'.

Links

Discussion