Criar lista de contatos

POST /v1/contactBooks

Exemplo de requisição

curl -X POST "https://app.madmail.com.br/api/v1/contactBooks" \
  -H "Authorization: Bearer us_SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Exemplo"
  }'

Corpo da requisição

Campo	Tipo	Obrigatório
`name`	string	Sim
`emoji`	string	Não
`properties`	object	Não
`doubleOptInEnabled`	boolean	Não
`doubleOptInFrom`	string \| null	Não
`doubleOptInSubject`	string	Não
`doubleOptInContent`	string	Não
`variables`	array<string>	Não

Exemplo

{
  "name": "Exemplo"
}

Respostas

200 — Cria uma nova lista de contatos

Campo	Tipo	Descrição
`id`	string	ID da lista de contatos
`name`	string	Nome da lista de contatos
`teamId`	number	ID do workspace
`properties`	object	Propriedades personalizadas da lista de contatos
`variables`	array<string>	Variáveis de personalização permitidas para os contatos desta lista
`emoji`	string	Emoji associado à lista de contatos
`doubleOptInEnabled`	boolean	Indica se o double opt-in está ativo para novos contatos
`doubleOptInFrom`	string \| null	Remetente usado nos e-mails de double opt-in (precisa usar um domínio verificado)
`doubleOptInSubject`	string \| null	Assunto usado no e-mail de confirmação do double opt-in
`doubleOptInContent`	string \| null	Conteúdo JSON do editor usado na confirmação do double opt-in
`createdAt`	string	Data e hora de criação
`updatedAt`	string	Data e hora da última atualização
`_count`	object

Exemplo de resposta

{
  "id": "clx1234567890",
  "name": "Newsletter Subscribers",
  "teamId": 1,
  "properties": {
    "customField1": "value1"
  },
  "variables": [
    "registrationCode",
    "company"
  ],
  "emoji": "📙",
  "createdAt": "string",
  "updatedAt": "string"
}