cURL
curl -X GET "https://app.emailx.ai/api/v1/workspaces/123/contacts" \
-H "Authorization: Bearer $EMAILX_API_KEY"import os, requests
response = requests.get(
"https://app.emailx.ai/api/v1/workspaces/123/contacts",
headers={"Authorization": "Bearer " + os.environ["EMAILX_API_KEY"]},
timeout=30,
)
response.raise_for_status()
print(response.json())const response = await fetch("https://app.emailx.ai/api/v1/workspaces/123/contacts", {
method: "GET",
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());{
"data": [
{
"id": 789,
"workspace_id": 123,
"name": "Alex",
"last_name": "Rivera",
"email": "alex@example.com",
"company": "Example Studio",
"unsubscribed": false
}
],
"has_more": false,
"next_cursor": null
}{
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "<string>",
"details": {}
}
}Contatti
Elencare i contatti
Elenca i contatti di un workspace. Filtra per email per controllare se una persona esiste già prima di aggiungerla.
Permesso: contacts:read
GET
/
workspaces
/
{workspace_id}
/
contacts
cURL
curl -X GET "https://app.emailx.ai/api/v1/workspaces/123/contacts" \
-H "Authorization: Bearer $EMAILX_API_KEY"import os, requests
response = requests.get(
"https://app.emailx.ai/api/v1/workspaces/123/contacts",
headers={"Authorization": "Bearer " + os.environ["EMAILX_API_KEY"]},
timeout=30,
)
response.raise_for_status()
print(response.json())const response = await fetch("https://app.emailx.ai/api/v1/workspaces/123/contacts", {
method: "GET",
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());{
"data": [
{
"id": 789,
"workspace_id": 123,
"name": "Alex",
"last_name": "Rivera",
"email": "alex@example.com",
"company": "Example Studio",
"unsubscribed": false
}
],
"has_more": false,
"next_cursor": null
}{
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "<string>",
"details": {}
}
}Autorizzazioni
Chiave ex_test_ o ex_live_ emessa da un operatore Emailx. Non usare credenziali provider o cookie di sessione.
Parametri del percorso
ID account del workspace Emailx, non ID del collegamento agenzia.
Intervallo richiesto:
x >= 1Parametri della query
Intervallo richiesto:
1 <= x <= 100next_cursor opaco della risposta precedente. Mantieni invariati i filtri.
Corrispondenza email esatta senza distinzione tra maiuscole e minuscole.
Opzioni disponibili:
true, false 
