Globale Werte

Werte für den ganzen Workspace, die Sie als {{global.key}} in E-Mails, Schritten von Automatisierungen und Bedingungen wiederverwenden.

Basis-URLhttps://api.emailit.com/v2Authentifizierung Fehler Rate Limits

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

Globalen Wert erstellen

Erstellt einen globalen Wert: einen Wert für den ganzen Workspace, den Sie als {{global.<key>}} in Vorlagen, Kampagnen, E-Mails aus Automatisierungen und Schritteinstellungen, in Bedingungen und als Datum zum Warten verwenden. Erfordert einen API-Schlüssel mit dem Scope full. Siehe Globale Werte.

POST/global-values

Body-Parameter

keystringerforderlich

Beginnt mit einem Kleinbuchstaben und besteht aus Kleinbuchstaben, Ziffern und _, bis zu 64 Zeichen. Eindeutig im Workspace.

namestring

Ein Anzeigename, bis zu 191 Zeichen.

typestringStandardwert: text

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

valuestring | number | boolean

Der Wert, geprüft gegen den Typ: eine Zahl bei number, true oder false bei boolean, YYYY-MM-DD bei date, Datum und Uhrzeit im Format ISO 8601 bei datetime (gespeichert in UTC) und eine http- oder https-URL bei url.

descriptionstring

Eine Notiz für Ihr Team, bis zu 1000 Zeichen.

Rückgabe

Gibt 201 mit dem globalen Wert in data zurück. Gibt 400 mit errors zurück, wenn ein Feld ungültig ist, 409, wenn der Schlüssel schon vergeben ist, und 422, wenn der Workspace bereits 500 globale Werte hat.

Objekt eines globalen Werts

objectstring

Immer global_value.

idstring

Die ID (gv_…).

keystring

Der Schlüssel, verwendet als {{global.<key>}}.

namestring | null

Ein Anzeigename.

typestring

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

valuestring | number | boolean | null

Der Wert: eine Zahl bei number, true oder false bei boolean, sonst ein String (YYYY-MM-DD bei date, ISO 8601 in UTC bei datetime).

descriptionstring | null

Eine Notiz für Ihr Team.

created_atstring

Zeitpunkt der Erstellung.

updated_atstring

Zeitpunkt der letzten Änderung.

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);

Globalen Wert abrufen

Gibt einen globalen Wert zurück. Erfordert einen API-Schlüssel mit dem Scope full.

GET/global-values/{id}

Pfadparameter

idstringerforderlich

Die ID (gv_…) oder der Schlüssel.

Rückgabe

Gibt den globalen Wert in data zurück, oder 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);

Globalen Wert aktualisieren

Ändert einen globalen Wert. Senden Sie nur die Felder, die sich ändern sollen. Erfordert einen API-Schlüssel mit dem Scope full.

Ab dann gesendete E-Mails verwenden den neuen Wert, ebenso Durchläufe von Automatisierungen, die danach einen Schritt Wait until erreichen. Bereits wartende Durchläufe behalten das Datum, das sie gelesen haben. Eine Änderung des Schlüssels macht {{global.<old key>}} in Ihren Vorlagen unbrauchbar.

POST/global-values/{id}

Pfadparameter

idstringerforderlich

Die ID (gv_…) oder der Schlüssel.

Body-Parameter

keystring

Ein neuer Schlüssel, eindeutig im Workspace.

namestring | null

Ein Anzeigename.

typestring

Ein neuer Typ. Der aktuelle Wert muss dazu passen, oder Sie senden auch einen neuen value.

valuestring | number | boolean | null

Der neue Wert, geprüft gegen den Typ. null leert ihn.

descriptionstring | null

Eine Notiz für Ihr Team.

Rückgabe

Gibt den aktualisierten globalen Wert in data zurück. Gibt 400 zurück, wenn ein Feld ungültig ist, 404, wenn er nicht existiert, und 409, wenn der neue Schlüssel schon vergeben ist.

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);

Globale Werte auflisten

Gibt alle globalen Werte des Workspace zurück, sortiert nach Schlüssel. Ein Workspace hat höchstens 500, daher gibt es keine Paginierung. Erfordert einen API-Schlüssel mit dem Scope full.

GET/global-values

Rückgabe

dataobject[]

Die globalen Werte.

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);

Globalen Wert löschen

Löscht einen globalen Wert. {{global.<key>}} wird danach leer gerendert, Bedingungen darauf sehen keinen Wert, und Schritte Wait until, die ihn lesen, nehmen ihren Pfad „date passed“. Erfordert einen API-Schlüssel mit dem Scope full.

DELETE/global-values/{id}

Pfadparameter

idstringerforderlich

Die ID (gv_…) oder der Schlüssel.

Rückgabe

Gibt { "message": "Global value was deleted." } oder 404 zurück.

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);