Criar assinante no AWeber, por uma API

Adiciona um assinante a uma lista, o que inicia a série de follow-up da lista. Um email já presente na lista retorna 400, a menos que update_existing seja true. Adicione pessoas uma a uma: adicionar em massa pela API viola os termos da AWeber.

Identificador
aweber_create_subscriber

A chamada

POST https://connect.reportei.com/api/tools/aweber_create_subscriber/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json

{
  "customer_toolkit": "<connection UUID>",
  "arguments": {
    "accountId": 1,
    "listId": 1,
    "email": "<email>"
  }
}

Seu sistema envia o id da conexão do cliente e os argumentos da tool. Os headers são os mesmos de toda a API do Connect: o token do seu produto e o token do cliente.

Parâmetros

As descrições dos parâmetros seguem a documentação oficial do app, em inglês.

ParâmetroTipoObrigatórioDescrição
accountIdintegerSimId of the account, from List accounts.
listIdintegerSimId of the list, from List lists.
emailstringSimEmail address of the subscriber.
namestringNãoName of the subscriber.
tagsarrayNãoTags to apply. Tags can start automations of the account.
custom_fieldsobjectNãoValues of the custom fields of the list, keyed by the field name as it appears in the custom_fields of List subscribers. The fields must already exist in the list.
ad_trackingstringNãoLabel of where the subscriber came from.
misc_notesstringNãoFree notes about the subscriber.
update_existingstringNãotrue updates the subscriber when the email is already on the list, adding the tags and keeping the status. When custom_fields is sent, the fields left out are cleared.Valores: true, false

Conexões possíveis

O seu cliente conecta a conta do AWeber uma vez, por um dos modos abaixo. A mesma conexão serve para todas as tools do toolkit.

OAuth com o app do seu produto

Você cadastra o app OAuth do seu produto uma vez, em POST /api/merchants/credentials/aweber, e o cliente autoriza a conta numa tela de consentimento. O Connect renova o token quando ele está para vencer.

A resposta

Em caso de sucesso, o Connect preserva o status e o corpo da resposta do app. Erros HTTP retornados pelo app usam o envelope {error, api_error}; falhas de autenticação ou validação podem ocorrer antes da execução. O header X-Toolkit-Execution-Id identifica a execução registrada, consultável em GET /api/tools/executions/{uuid}.

Pronta para agentes de IA

O input desta tool é um JSON Schema, disponível em GET /api/tools/aweber_create_subscriber. Ele vira a definição de tool do seu agente sem conversão.

Outras tools do AWeber

Ver as 12 tools

Toolkits da mesma categoria

Ver os 100 toolkits

Veja o Connect aplicado ao seu produto.

Teste por 15 dias sem cartão, ou mostre seu cenário ao nosso time.