Skip to main content
POST
Add contacts to an assistant's contact filter

Autorizações

Authorization
string
header
obrigatório

Personal access token (izap_pat_…) sent as Authorization: Bearer ; dashboard session JWTs are also accepted.

Cabeçalhos

business-id
string | null
obrigatório

UUID of the business the request is scoped to. Required on this route; the deprecated /businesses/{business_id}/... form takes it from the path instead.

Parâmetros de caminho

chatbot_id
string<uuid>
obrigatório

Corpo

application/json
list
enum<string>
obrigatório

Which list to add the contacts to: allow or block.

Opções disponíveis:
allow,
block
phone_numbers
string[]
obrigatório

A WhatsApp phone number with its country code (+5585987504325; spaces, dashes and parentheses are ignored), or a WhatsApp business-scoped user ID for contacts whose number is hidden. Numbers are stored in canonical E.164 form.

Required array length: 1 - 500 elements
label
string | null

Optional note stored with each contact.

Maximum string length: 100

Resposta

Successful Response

added
ContactFilterEntryOut · object[]
obrigatório
already_listed
string[]
obrigatório

Contacts that were already on the list, in canonical form.

invalid
string[]
obrigatório

Inputs that are not a usable phone number, as sent.