Create Batch Add Tags Job

POST

/v1/tags/batch-add-tags-jobs

Schedule an asynchronous job that adds the tags in data.attributes.tags to a set of companies. Every tag is added to every selected company. The companies are supplied either as an explicit items array (up to 100 items per request), or as an advanced_search selection that is resolved into companies (up to 100,000) when the job runs. To remove tags, use POST /v1/tags/batch-remove-tags-jobs — adding and removing are separate jobs.

Returns 202 Accepted with a job handle. Poll GET /v1/tags/batch-add-tags-jobs/{job_id} to observe progress and the outcome summary.

Credit Note: Adding tags does not consume credits.

INFO

Requires the companies:write OAuth2 scope.

Request

Authorization

API Key

Add parameter in header

X-Api-Key

Example:

X-Api-Key: ********************

Query Params

Body Params application/jsonRequired

Examples

Tag every company matching an advanced searchAdd tags to a set of companies

{
    "data": {
        "attributes": {
            "advanced_search": {
                "excluded_company_ids": [
                    "651713"
                ],
                "filters": {
                    "items": [
                        {
                            "field": "country_code",
                            "operator": "in",
                            "type": "filter",
                            "value": [
                                "DE"
                            ]
                        },
                        {
                            "field": "employee_count",
                            "operator": "in_range",
                            "type": "filter",
                            "value": {
                                "gte": 50
                            }
                        }
                    ],
                    "operator": "and",
                    "type": "group"
                },
                "page": {
                    "size": 1000
                },
                "sort": {
                    "direction": "desc",
                    "field": "employee_count"
                }
            },
            "tags": [
                {
                    "id": "dd11fc370098e78e",
                    "type": "tag"
                }
            ]
        },
        "type": "batch_add_tags_job"
    }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

Tag every company matching an advanced searchAdd tags to a set of companies

curl --location 'https://api.leadfeeder.com/v1/tags/batch-add-tags-jobs?account_id=123456' \
--header 'X-Api-Key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "data": {
        "attributes": {
            "advanced_search": {
                "excluded_company_ids": [
                    "651713"
                ],
                "filters": {
                    "items": [
                        {
                            "field": "country_code",
                            "operator": "in",
                            "type": "filter",
                            "value": [
                                "DE"
                            ]
                        },
                        {
                            "field": "employee_count",
                            "operator": "in_range",
                            "type": "filter",
                            "value": {
                                "gte": 50
                            }
                        }
                    ],
                    "operator": "and",
                    "type": "group"
                },
                "page": {
                    "size": 1000
                },
                "sort": {
                    "direction": "desc",
                    "field": "employee_count"
                }
            },
            "tags": [
                {
                    "id": "dd11fc370098e78e",
                    "type": "tag"
                }
            ]
        },
        "type": "batch_add_tags_job"
    }
}'

Responses

🟢202Accepted

application/json

Batch add-tags job accepted and enqueued

Bodyapplication/json

Example

{
    "data": {
        "attributes": {
            "completed_at": null,
            "configuration": {
                "items": [
                    {
                        "id": "159001425",
                        "type": "company"
                    },
                    {
                        "id": "159001426",
                        "type": "company"
                    }
                ],
                "tags": [
                    {
                        "id": "dd11fc370098e78e",
                        "type": "tag"
                    },
                    {
                        "id": "8bb95c4d8e7c5fd2",
                        "type": "tag"
                    }
                ]
            },
            "created_at": "2026-05-13T12:00:00Z",
            "status": "running"
        },
        "id": "job_550e8400-e29b-41d4-a716-446655440000",
        "type": "batch_add_tags_job"
    },
    "meta": {
        "request_id": "cf054205-dd8c-4473-8689-07c30fe0789f"
    }
}

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠422Parameter Error

🟠429

🔴500Server Error

🔴504Gateway Timeout

Modified at 2026-10-13 07:27:21

Create Tag

Get Batch Add Tags Job