Update Contacts Tags

POST https://services.leadconnectorhq.com/contacts/bulk/tags/update/{type}

Permite actualizar etiquetas a múltiples contactos al mismo tiempo; puedes añadir o eliminar etiquetas de los contactos en PowerLeads.

Request

Security: Bearer Auth

Utiliza el Access Token generado con tipo de usuario Subcuenta o el Token de Integración Privada de la Subcuenta en PowerLeads. Proporciona tu token Bearer en el encabezado Authorization al realizar solicitudes a recursos protegidos.

Example: Authorization: Bearer 123

Path Parameters

type

string

required

Tags operation type

Allowed values: add remove
Examples: add

Headers

Authorization

string

required

Access Token

Example: Bearer 9c48df2694a849b6089f9d0d3513efe

Version

string

required

API Version

Allowed value: 2021-07-28

Request Sample: Shell / cURL

curl --request POST \
  --url https://services.leadconnectorhq.com/contacts/bulk/tags/update/add \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer 123' \
  --header 'Content-Type: application/json' \
  --header 'Version: 2021-07-28' \
  --data '{
  "contacts": [
    "qFSqySFkVvNzOSqgGqFi",
    "abcdef",
    "qFSqySFkVvNzOSqgGqFi",
    "3ualbhnV7j3n3a9r2moD"
  ],
  "tags": [
    "tag1",
    "tag2"
  ],
  "locationId": "asdrwHvLUxlfw5SqKVCN",
  "removeAllTags": false
}'

Response Example

{
  "succeded": true,
  "errorCount": 3,
  "responses": [
    {
      "contactId": "qFSqySFkVvNzOSqgGqFi",
      "message": "Tags updated",
      "type": "success",
      "oldTags": [
        "tag-1",
        "tag-2"
      ],
      "tagsAdded": [],
      "tagsRemoved": []
    },
    {
      "contactId": "abcdef",
      "message": "contact id is not a valid firebase id",
      "type": "error"
    },
    {
      "contactId": "qFSqySFkVvNzOSqgGqFi",
      "message": "contact is deleted",
      "type": "error"
    },
    {
      "contactId": "3ualbhnV7j3n3a9r2moD",
      "message": "contact does not belong to location",
      "type": "error"
    }
  ]
}