Actions60
- Ad Actions
- Ad Account Actions
- Attribution Actions
- Call Actions
- Cart Actions
- Click Actions
- Conversion Path Actions
- Custom Cost Actions
- Domain Actions
- Keyword Actions
- Lead Actions
- Order Actions
- Product Actions
- Request Status Actions
- Sale Actions
- Source Actions
- Stage Actions
- Subscription Actions
- Tag Actions
- Tracking Script Actions
- URL Rule Actions
- User Info Actions
- Webhook Subscription Actions
Lead → Add Tags
AI-generatedSummary
Add one or more tags to specified leads identified by their IDs and/or email addresses, optionally backdating the tags with a provided date.
Inputs
- Lead IDs — Comma-separated list of lead IDs to tag (max 50). Can include Lead IDs, Emails, or both.
- Emails — Comma-separated list of emails to tag (max 50), matched exactly; tagging an email tags all leads associated with it.
- Tags (required) — Comma-separated list of tags to apply to every selected lead (max 50). Tags are prefixed with $ for sale tags, @ for source tags, ! for action tags; no prefix defaults to an action tag. A $ tag that matches a product generates a sale for each lead that did not already have it.
- Tags Date — Date to assign to every tag in this request, allowing backdating historical tags (defaults to current time if omitted, cannot be set in the future). Action tags already carried by a lead are re-dated to this date.
Output shape
a single response object confirming tag application status for the specified leads
The API accepts up to 50 Lead IDs and/or Emails and up to 50 tags per request. Tags are applied as per the specified prefixes. The Tags Date field defaults to now if left blank and cannot be set in the future. The output confirms the result of the tag addition operation per lead.