La prima richiesta

L’API Emailx usa https://app.emailx.ai. L’accesso di produzione non è abilitato nella beta attuale: una richiesta può restituire 503 api_disabled. Prima di procedere, chiedi al referente Emailx un ambiente abilitato e la chiave corrispondente. Le chiavi di test e di produzione non sono intercambiabili.

Richiedi l'accesso beta

Crea una chiave con scadenza in Emailx, da Impostazioni > Chiavi API. Per questa guida servono workspaces:read e campaigns:read. L’accesso ai clienti di un’agenzia richiede anche agency:read e un’assegnazione attiva.

Scegli l'ambiente corretto

Usa l’origine ufficiale dell’app per un account di produzione abilitato:

export EMAILX_BASE_URL="https://app.emailx.ai"

Carica EMAILX_API_KEY dal tuo gestore di segreti. Non inserire la chiave in URL, file versionati o log per l’assistenza. La produzione richiede un account abilitato e una chiave separata. Una chiave di test legge dati reali di staging: non crea una sandbox.

Verifica la connessione

curl "$EMAILX_BASE_URL/api/v1/me" \
  -H "Authorization: Bearer $EMAILX_API_KEY"

import json, os, urllib.request
request = urllib.request.Request(
    os.environ["EMAILX_BASE_URL"] + "/api/v1/me",
    headers={"Authorization": "Bearer " + os.environ["EMAILX_API_KEY"]},
)
with urllib.request.urlopen(request, timeout=30) as response:
    print(json.load(response))

const response = await fetch(`${process.env.EMAILX_BASE_URL}/api/v1/me`, {
  headers: { Authorization: `Bearer ${process.env.EMAILX_API_KEY}` },
  signal: AbortSignal.timeout(30000),
});
if (!response.ok) throw new Error(`Emailx: ${response.status}`);
console.log(await response.json());

La risposta contiene i metadati della credenziale in data. Controlla ambiente, scadenza e scope prima di proseguire. I campi sono descritti in Verificare la chiave API.

Scopri gli accessi attuali

curl "$EMAILX_BASE_URL/api/v1/workspaces?limit=25" \
  -H "Authorization: Bearer $EMAILX_API_KEY"

Scegli un ID presente in data. Gli accessi configurati sulla chiave sono solo il perimetro massimo; questa lista riflette i permessi attuali.

Leggi le campagne di un canale

Sostituisci 123 con l’ID appena ricevuto.

curl "$EMAILX_BASE_URL/api/v1/workspaces/123/campaigns?channel=linkedin&limit=25" \
  -H "Authorization: Bearer $EMAILX_API_KEY"

Un array data vuoto è un risultato valido. Quando has_more è true, usa next_cursor.

Passaggi successivi

Prepara una bozza, gestisci la paginazione oppure installa la CLI. Esegui le richieste dal backend o dal terminale: i cookie della sessione browser non le autenticano.

Per iniziare

Inviare con cura

Flussi operativi

La prima richiesta

Passaggi successivi

​Passaggi successivi

Passaggi successivi