Créer un abonné avec l'API AWeber

Ajoute un abonné à une liste, ce qui lance la série de suivi de la liste. Un email déjà présent dans la liste renvoie 400, sauf si update_existing vaut true. Ajoutez les personnes une par une : l'ajout en masse par l'API enfreint les conditions d'AWeber.

Identifiant
aweber_create_subscriber

L'appel

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>"
  }
}

Votre système envoie l'id de la connexion de votre client et les arguments de la tool. Les headers sont les mêmes que pour toute l'API Connect : le token de votre produit et celui de votre client.

Paramètres

Les descriptions des paramètres suivent la documentation officielle de l'app, en anglais.

ParamètreTypeObligatoireDescription
accountIdintegerOuiId of the account, from List accounts.
listIdintegerOuiId of the list, from List lists.
emailstringOuiEmail address of the subscriber.
namestringNonName of the subscriber.
tagsarrayNonTags to apply. Tags can start automations of the account.
custom_fieldsobjectNonValues 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_trackingstringNonLabel of where the subscriber came from.
misc_notesstringNonFree notes about the subscriber.
update_existingstringNontrue 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.Valeurs : true, false

Connexions possibles

Votre client connecte son compte AWeber une seule fois, avec l'un des modes ci-dessous. La même connexion sert à toutes les tools du toolkit.

OAuth avec l'app de votre produit

Vous enregistrez une fois l'app OAuth de votre produit, avec POST /api/merchants/credentials/aweber, et votre client autorise le compte sur un écran de consentement. Connect renouvelle le token avant son expiration.

La réponse

En cas de succès, Connect conserve le statut et le corps de la réponse de l'app. Les erreurs HTTP renvoyées par l'app utilisent l'objet {error, api_error} ; l'authentification ou la validation peuvent échouer avant l'exécution. Le header X-Toolkit-Execution-Id identifie l'exécution enregistrée, consultable avec GET /api/tools/executions/{uuid}.

Prête pour les agents IA

L'input de cette tool est un JSON Schema, disponible via GET /api/tools/aweber_create_subscriber. Il devient la définition de tool de votre agent sans conversion.

Autres tools AWeber

Voir les 12 tools

Toolkits de la même catégorie

Voir les 100 toolkits

Voyez Connect appliqué à votre produit.

Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.