Valori globali

Valori validi per tutto il workspace, riutilizzati nelle email, nei passaggi delle automazioni e nelle condizioni come {{global.key}}.

URL di basehttps://api.emailit.com/v2Autenticazione Errori Limiti di frequenza

POST/global-values
GET/global-values/{id}
POST/global-values/{id}
GET/global-values
DEL/global-values/{id}

Crea un valore globale

Crea un valore globale: un unico valore per tutto il workspace, usato come {{global.<key>}} nei template, nelle campagne, nelle email e nelle impostazioni dei passaggi delle automazioni, nelle condizioni e come data da attendere. Richiede una chiave API con il permesso full. Vedi Valori globali.

POST/global-values

Parametri del corpo

keystringobbligatorio

Inizia con una lettera minuscola e usa lettere minuscole, cifre e _, fino a 64 caratteri. Univoca nel workspace.

namestring

Un nome visualizzato, fino a 191 caratteri.

typestringpredefinito: text

text, number, boolean, date, datetime or url.

valuestring | number | boolean

Il valore, controllato in base al tipo: un numero per number, true o false per boolean, YYYY-MM-DD per date, una data e un’ora ISO 8601 per datetime (salvate in UTC) e un URL http o https per url.

descriptionstring

Una nota per il tuo team, fino a 1000 caratteri.

Restituisce

Restituisce 201 con il valore globale in data. Restituisce 400 con errors quando un campo non è valido, 409 quando la chiave è già in uso e 422 quando il workspace ha già 500 valori globali.

L’oggetto valore globale

objectstring

Sempre global_value.

idstring

L’ID (gv_…).

keystring

La chiave, usata come {{global.<key>}}.

namestring | null

Un nome visualizzato.

typestring

text, number, boolean, date, datetime or url.

valuestring | number | boolean | null

Il valore: un numero per number, true o false per boolean e una stringa negli altri casi (YYYY-MM-DD per date, ISO 8601 in UTC per datetime).

descriptionstring | null

Una nota per il tuo team.

created_atstring

Quando è stato creato.

updated_atstring

Quando è stato modificato l’ultima volta.

POST/global-values

Terminal

curl -X POST https://api.emailit.com/v2/global-values \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"key": "webinar_date", "name": "Webinar date", "type": "datetime", "value": "2026-11-05T17:00:00Z"}'

JavaScript

const res = await fetch('https://api.emailit.com/v2/global-values', {
  method: 'POST',
  headers: { Authorization: `Bearer ${process.env.EMAILIT_API_KEY}`, 'Content-Type': 'application/json' },
  body: JSON.stringify({"key": "webinar_date", "name": "Webinar date", "type": "datetime", "value": "2026-11-05T17:00:00Z"}),
});
const result = await res.json();

Python

import os, requests

r = requests.post(
    "https://api.emailit.com/v2/global-values",
    headers={"Authorization": f"Bearer {os.environ['EMAILIT_API_KEY']}"},
    json={"key": "webinar_date", "name": "Webinar date", "type": "datetime", "value": "2026-11-05T17:00:00Z"},
)
result = r.json()

PHP

$client = new GuzzleHttp\Client(['base_uri' => 'https://api.emailit.com/v2/']);

$response = $client->post('global-values', [
    'headers' => ['Authorization' => 'Bearer ' . getenv('EMAILIT_API_KEY')],
    'json' => ['key' => 'webinar_date', 'name' => 'Webinar date', 'type' => 'datetime', 'value' => '2026-11-05T17:00:00Z'],
]);
$result = json_decode($response->getBody(), true);

Recupera un valore globale

Restituisce un valore globale. Richiede una chiave API con il permesso full.

GET/global-values/{id}

Parametri di percorso

idstringobbligatorio

L’ID (gv_…) o la chiave.

Restituisce

Restituisce il valore globale in data oppure 404.

GET/global-values/{id}

Terminal

curl https://api.emailit.com/v2/global-values/webinar_date \
  -H "Authorization: Bearer $EMAILIT_API_KEY"

JavaScript

const res = await fetch('https://api.emailit.com/v2/global-values/webinar_date', {
  method: 'GET',
  headers: { Authorization: `Bearer ${process.env.EMAILIT_API_KEY}` },
});
const result = await res.json();

Python

import os, requests

r = requests.get(
    "https://api.emailit.com/v2/global-values/webinar_date",
    headers={"Authorization": f"Bearer {os.environ['EMAILIT_API_KEY']}"},
)
result = r.json()

PHP

$client = new GuzzleHttp\Client(['base_uri' => 'https://api.emailit.com/v2/']);

$response = $client->get('global-values/webinar_date', [
    'headers' => ['Authorization' => 'Bearer ' . getenv('EMAILIT_API_KEY')],
]);
$result = json_decode($response->getBody(), true);

Aggiorna un valore globale

Modifica un valore globale. Invia solo i campi da modificare. Richiede una chiave API con il permesso full.

Le email inviate da quel momento usano il nuovo valore, e lo stesso vale per le esecuzioni delle automazioni che arrivano dopo a un passaggio Wait until. Le esecuzioni già in attesa mantengono la data che hanno letto. Se cambi la chiave, {{global.<old key>}} smette di funzionare nei template.

POST/global-values/{id}

Parametri di percorso

idstringobbligatorio

L’ID (gv_…) o la chiave.

Parametri del corpo

keystring

Una nuova chiave, univoca nel workspace.

namestring | null

Un nome visualizzato.

typestring

Un nuovo tipo. Il valore attuale deve essere compatibile, altrimenti invia anche un nuovo value.

valuestring | number | boolean | null

Il nuovo valore, controllato in base al tipo. null lo cancella.

descriptionstring | null

Una nota per il tuo team.

Restituisce

Restituisce il valore globale aggiornato in data. Restituisce 400 quando un campo non è valido, 404 se non esiste e 409 quando la nuova chiave è già in uso.

POST/global-values/{id}

Terminal

curl -X POST https://api.emailit.com/v2/global-values/webinar_date \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"value": "2026-12-03T17:00:00Z"}'

JavaScript

const res = await fetch('https://api.emailit.com/v2/global-values/webinar_date', {
  method: 'POST',
  headers: { Authorization: `Bearer ${process.env.EMAILIT_API_KEY}`, 'Content-Type': 'application/json' },
  body: JSON.stringify({"value": "2026-12-03T17:00:00Z"}),
});
const result = await res.json();

Python

import os, requests

r = requests.post(
    "https://api.emailit.com/v2/global-values/webinar_date",
    headers={"Authorization": f"Bearer {os.environ['EMAILIT_API_KEY']}"},
    json={"value": "2026-12-03T17:00:00Z"},
)
result = r.json()

PHP

$client = new GuzzleHttp\Client(['base_uri' => 'https://api.emailit.com/v2/']);

$response = $client->post('global-values/webinar_date', [
    'headers' => ['Authorization' => 'Bearer ' . getenv('EMAILIT_API_KEY')],
    'json' => ['value' => '2026-12-03T17:00:00Z'],
]);
$result = json_decode($response->getBody(), true);

Elenca i valori globali

Restituisce tutti i valori globali del workspace, ordinati per chiave. Un workspace ne ha al massimo 500, quindi non c’è paginazione. Richiede una chiave API con il permesso full.

GET/global-values

Restituisce

dataobject[]

I valori globali.

GET/global-values

Terminal

curl https://api.emailit.com/v2/global-values \
  -H "Authorization: Bearer $EMAILIT_API_KEY"

JavaScript

const res = await fetch('https://api.emailit.com/v2/global-values', {
  method: 'GET',
  headers: { Authorization: `Bearer ${process.env.EMAILIT_API_KEY}` },
});
const result = await res.json();

Python

import os, requests

r = requests.get(
    "https://api.emailit.com/v2/global-values",
    headers={"Authorization": f"Bearer {os.environ['EMAILIT_API_KEY']}"},
)
result = r.json()

PHP

$client = new GuzzleHttp\Client(['base_uri' => 'https://api.emailit.com/v2/']);

$response = $client->get('global-values', [
    'headers' => ['Authorization' => 'Bearer ' . getenv('EMAILIT_API_KEY')],
]);
$result = json_decode($response->getBody(), true);

Elimina un valore globale

Elimina un valore globale. Da quel momento {{global.<key>}} viene elaborato come vuoto, le condizioni su di esso non trovano alcun valore e i passaggi Wait until che lo leggono seguono il percorso «data passata». Richiede una chiave API con il permesso full.

DELETE/global-values/{id}

Parametri di percorso

idstringobbligatorio

L’ID (gv_…) o la chiave.

Restituisce

Restituisce { "message": "Global value was deleted." } oppure 404.

DELETE/global-values/{id}

Terminal

curl -X DELETE https://api.emailit.com/v2/global-values/seats \
  -H "Authorization: Bearer $EMAILIT_API_KEY"

JavaScript

const res = await fetch('https://api.emailit.com/v2/global-values/seats', {
  method: 'DELETE',
  headers: { Authorization: `Bearer ${process.env.EMAILIT_API_KEY}` },
});
const result = await res.json();

Python

import os, requests

r = requests.delete(
    "https://api.emailit.com/v2/global-values/seats",
    headers={"Authorization": f"Bearer {os.environ['EMAILIT_API_KEY']}"},
)
result = r.json()

PHP

$client = new GuzzleHttp\Client(['base_uri' => 'https://api.emailit.com/v2/']);

$response = $client->delete('global-values/seats', [
    'headers' => ['Authorization' => 'Bearer ' . getenv('EMAILIT_API_KEY')],
]);
$result = json_decode($response->getBody(), true);