Bulk add campaign contacts

Bulk add contacts to a campaign using filter criteria.

Instead of passing individual contact IDs, pass filter criteria:

tags: Filter by contact tags (with tagMode for ANY/ALL matching)
company: Filter by company name (exact match)
search: Full-text search across name, company, occupation, email

This allows adding thousands of contacts in a single request efficiently.

Bulk add contacts to a campaign using filter criteria. Instead of passing individual contact IDs, pass filter criteria: - `tags`: Filter by contact tags (with `tagMode` for ANY/ALL matching) - `company`: Filter by company name (exact match) - `search`: Full-text search across name, company, occupation, email This allows adding thousands of contacts in a single request efficiently.

Authentication

AuthorizationBearer

Pass a JWT access token or an API key (prefixed with tif_live_) as a Bearer token.

Path parameters

campaignIdstringRequiredformat: "uuid"

Campaign ID

Request

This endpoint expects an object.

filterobjectRequired

Filter criteria to select which contacts to add

Response

Contacts added via filter criteria

addedlong

Number of contacts successfully added to the campaign

matchedlong

Total number of contacts that matched the filter criteria

skippedlong

Number of contacts skipped because they were already in the campaign

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

429

Too Many Requests Error

500

Internal Server Error