API Reference
  1. MapFlow API
  2. Locations - Customers

Bulk actions on customers (asynchronous)

post
https://api.mapflow.co/api/v1/locations/customers/bulk_action/

Lance une tâche asynchrone pour effectuer des actions en lot sur plusieurs customers.

DEUX MODES DE SÉLECTION :

  1. Par liste d'IDs explicites (customer_ids) :
    • Fournir une liste d'UUIDs de customers
    • Maximum : 10000 customers
  2. Par filtres de recherche (filters) :
    • Applique l'action sur TOUS les customers correspondant aux filtres
    • Support de la recherche globale via le paramètre "search"
    • Support de tous les filtres (customer_type, is_active, etc.)
    • Maximum : 10000 customers (sécurité)

Actions supportées : activate, deactivate, add_tags, remove_tags, change_type, change_billing_city,
change_billing_country, add_emails, remove_emails, add_phones, remove_phones,
set_notes, append_notes, change_priority, change_external_reference, delete.

Exemples :

Mode IDs :

{
    "action": "add_tags",
    "customer_ids": ["uuid1", "uuid2", "uuid3"],
    "tag_ids": ["tag-uuid"]
}

Mode filtres (recherche) :

{
    "action": "add_tags",
    "filters": {
        "search": "Paris"
    },
    "tag_ids": ["tag-uuid"]
}
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

Serializer pour les actions en lot sur les clients

Supporte deux modes de sélection :

  1. Par liste d'IDs explicites (customer_ids)
  2. Par filtres de recherche (filters) - applique l'action sur tous les résultats

customer_ids
array of uuids
length between 1 and 5000

Liste des IDs de clients (max 5000). Optionnel si 'filters' est fourni.

customer_ids
string

Filtres de recherche pour sélectionner les clients (ex: {'search': 'Dupont'}). Applique l'action sur tous les résultats correspondants.

string
enum
required
  • activate - Activer
  • deactivate - Désactiver
  • change_type - Changer le type
  • add_tags - Ajouter des tags
  • remove_tags - Retirer des tags
  • change_billing_city - Changer la ville de facturation
  • change_billing_country - Changer le pays de facturation
  • change_external_reference - Changer la référence externe
  • add_emails - Ajouter des emails
  • remove_emails - Retirer des emails
  • add_phones - Ajouter des téléphones
  • remove_phones - Retirer des téléphones
  • set_notes - Définir des notes
  • append_notes - Ajouter des notes
  • change_priority - Changer la priorité
  • delete - Supprimer définitivement
string
enum

Nouveau type de client (requis si action=change_type)

  • individual - Particulier
  • company - Entreprise
Allowed:
tag_ids
array of uuids

Liste des IDs de tags (requis si action=add_tags ou remove_tags)

tag_ids
string
length between 1 and 100

Nouvelle ville de facturation (requis si action=change_billing_city)

string
length between 1 and 2

Nouveau pays de facturation (requis si action=change_billing_country)

string
length between 1 and 255

Nouvelle référence externe (requis si action=change_external_reference)

emails
array of strings

Liste des emails à ajouter/retirer (requis si action=add_emails ou remove_emails)

emails
phones
array of strings

Liste des téléphones à ajouter/retirer (requis si action=add_phones ou remove_phones)

phones
string
length between 1 and 1000

Notes à définir ou ajouter (requis si action=set_notes ou append_notes)

integer
1 to 5

Nouvelle priorité (1-5, requis si action=change_priority)

Headers
string
enum
Defaults to application/json

Generated from available request content types

Allowed:
Responses

Updated 9 months ago

Did this page help you?
Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 9 months ago

Did this page help you?