Bulk update contact tags
Adds, removes, or replaces tags on multiple contacts in one request, returning counts of updated and failed records. One request carries at most 1000 ids.
POST
Adds, removes, or replaces tags on multiple contacts in one request, returning counts of updated and failed records. One request carries at most 1000 ids.
apiKeyheader
x-api-key<token>application/json- body
ids*array<>Items
1 <= items <= 1000operation*stringValue in
"add""remove""set"tags*array<string>Items
1 <= itemsBulkUpdateResult
application/json- response
updated*integerRange
0 <= value <= 9007199254740991failed*integerRange
0 <= value <= 9007199254740991import { createClient } from "samva";
const samva = createClient({ apiKey: process.env.SAMVA_API_KEY! });
const result = await samva.contacts.bulkUpdateTags({
"ids": [
"example"
],
"operation": "add",
"tags": [
"example"
]
});Example Response
{
"updated": 0,
"failed": 0
}