# Globale Werte API

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

Basis-URL: `https://api.emailit.com/v2`. Authentifizieren Sie sich mit `Authorization: Bearer <API key>`.

## Globalen Wert erstellen — POST /global-values

> Einen Wert für den ganzen Workspace erstellen, etwa ein Webinardatum oder einen Buchungslink, den Sie als {{global.key}} in E-Mails, Schritten von Automatisierungen und Bedingungen verwenden.

# 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](/de/docs/contacts/global-values/).

`POST /global-values`

## Body-Parameter

- `key` (string, erforderlich): Beginnt mit einem Kleinbuchstaben und besteht aus Kleinbuchstaben, Ziffern und `_`, bis zu 64 Zeichen. Eindeutig im Workspace.

- `name` (string): Ein Anzeigename, bis zu 191 Zeichen.

- `type` (string): `text`, `number`, `boolean`, `date`, `datetime` oder `url`.

- `value` (string | 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`.

- `description` (string): Eine Notiz für Ihr Team, bis zu 1000 Zeichen.

## Rückgabe

Gibt `201` mit dem [globalen Wert](#the-global-value-object) 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.

**Anfrage** `POST /global-values`

**cURL**

```bash
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"}'
```

**Node.js**

```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**

```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**

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

## Objekt eines globalen Werts

- `object` (string): Immer `global_value`.

- `id` (string): Die ID (`gv_…`).

- `key` (string): Der Schlüssel, verwendet als `{{global.<key>}}`.

- `name` (string | null): Ein Anzeigename.

- `type` (string): `text`, `number`, `boolean`, `date`, `datetime` oder `url`.

- `value` (string | 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`).

- `description` (string | null): Eine Notiz für Ihr Team.

- `created_at` (string): Zeitpunkt der Erstellung.

- `updated_at` (string): Zeitpunkt der letzten Änderung.

---
Quelle: https://emailit.com/de/docs/api-reference/global-values/create/

## Globalen Wert abrufen — GET /global-values/{id}

> Einen globalen Wert anhand seiner ID oder seines Schlüssels abrufen.

# Globalen Wert abrufen

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

`GET /global-values/{id}`

## Pfadparameter

- `id` (string, erforderlich): Die ID (`gv_…`) oder der Schlüssel.

## Rückgabe

Gibt den [globalen Wert](/de/docs/api-reference/global-values/create/#the-global-value-object) in `data` zurück, oder `404`.

**Anfrage** `GET /global-values/{id}`

**cURL**

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

**Node.js**

```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**

```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**

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

---
Quelle: https://emailit.com/de/docs/api-reference/global-values/get/

## Globalen Wert aktualisieren — POST /global-values/{id}

> Wert, Schlüssel, Namen, Typ oder Beschreibung eines globalen Werts ändern. Ab dann gesendete E-Mails verwenden den neuen Wert.

# 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

- `id` (string, erforderlich): Die ID (`gv_…`) oder der Schlüssel.

## Body-Parameter

- `key` (string): Ein neuer Schlüssel, eindeutig im Workspace.

- `name` (string | null): Ein Anzeigename.

- `type` (string): Ein neuer Typ. Der aktuelle Wert muss dazu passen, oder Sie senden auch einen neuen `value`.

- `value` (string | number | boolean | null): Der neue Wert, geprüft gegen den Typ. `null` leert ihn.

- `description` (string | null): Eine Notiz für Ihr Team.

## Rückgabe

Gibt den aktualisierten [globalen Wert](/de/docs/api-reference/global-values/create/#the-global-value-object) 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.

**Anfrage** `POST /global-values/{id}`

**cURL**

```bash
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"}'
```

**Node.js**

```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**

```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**

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

---
Quelle: https://emailit.com/de/docs/api-reference/global-values/update/

## Globale Werte auflisten — GET /global-values

> Alle globalen Werte des Workspace auflisten, sortiert nach Schlüssel.

# 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

- `data` (object[]): Die [globalen Werte](/de/docs/api-reference/global-values/create/#the-global-value-object).

**Anfrage** `GET /global-values`

**cURL**

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

**Node.js**

```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**

```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**

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

---
Quelle: https://emailit.com/de/docs/api-reference/global-values/list/

## Globalen Wert löschen — DELETE /global-values/{id}

> Einen globalen Wert löschen. Vorlagen, die ihn verwenden, rendern ihn leer.

# 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

- `id` (string, erforderlich): Die ID (`gv_…`) oder der Schlüssel.

## Rückgabe

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

**Anfrage** `DELETE /global-values/{id}`

**cURL**

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

**Node.js**

```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**

```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**

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

---
Quelle: https://emailit.com/de/docs/api-reference/global-values/delete/