Valores globales

Valores para todo el espacio de trabajo que se reutilizan en emails, pasos de automatización y condiciones como {{global.key}}.

URL basehttps://api.emailit.com/v2Autenticación Errores Límites de velocidad

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

Crear un valor global

Crea un valor global: un único valor para todo el espacio de trabajo, que se usa como {{global.<key>}} en plantillas, campañas, emails y ajustes de los pasos de las automatizaciones, en condiciones y como fecha hasta la que esperar. Requiere una clave de API con el permiso full. Consulta Valores globales.

POST/global-values

Parámetros del cuerpo

keystringobligatorio

Empieza por una letra minúscula y usa letras minúsculas, dígitos y _, hasta 64 caracteres. Única en el espacio de trabajo.

namestring

Un nombre visible, de hasta 191 caracteres.

typestringpor defecto: text

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

valuestring | number | boolean

El valor, que se comprueba según el tipo: un número para number, true o false para boolean, YYYY-MM-DD para date, una fecha y hora ISO 8601 para datetime (se guarda en UTC) y una URL http o https para url.

descriptionstring

Una nota para tu equipo, de hasta 1000 caracteres.

Devuelve

Devuelve 201 con el valor global en data. Devuelve 400 con errors si un campo no es válido, 409 si la clave ya está en uso y 422 si el espacio de trabajo ya tiene 500 valores globales.

Objeto de valor global

objectstring

Siempre global_value.

idstring

El ID (gv_…).

keystring

La clave, que se usa como {{global.<key>}}.

namestring | null

Un nombre visible.

typestring

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

valuestring | number | boolean | null

El valor: un número para number, true o false para boolean y, en los demás casos, una cadena (YYYY-MM-DD para date, ISO 8601 en UTC para datetime).

descriptionstring | null

Una nota para tu equipo.

created_atstring

Cuándo se creó.

updated_atstring

Cuándo cambió por última vez.

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

Obtener un valor global

Devuelve un valor global. Requiere una clave de API con el permiso full.

GET/global-values/{id}

Parámetros de ruta

idstringobligatorio

El ID (gv_…) o la clave.

Devuelve

Devuelve el valor global en data, o 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);

Actualizar un valor global

Cambia un valor global. Envía solo los campos que quieras cambiar. Requiere una clave de API con el permiso full.

Los emails que se envíen a partir de ese momento usan el valor nuevo, y también las ejecuciones de automatizaciones que lleguen después a un paso Wait until. Las ejecuciones que ya están esperando conservan la fecha que leyeron. Cambiar la clave rompe {{global.<old key>}} en tus plantillas.

POST/global-values/{id}

Parámetros de ruta

idstringobligatorio

El ID (gv_…) o la clave.

Parámetros del cuerpo

keystring

Una clave nueva, única en el espacio de trabajo.

namestring | null

Un nombre visible.

typestring

Un tipo nuevo. El valor actual tiene que encajar en él; si no, envía también un value nuevo.

valuestring | number | boolean | null

El valor nuevo, que se comprueba según el tipo. null lo borra.

descriptionstring | null

Una nota para tu equipo.

Devuelve

Devuelve el valor global actualizado en data. Devuelve 400 si un campo no es válido, 404 si no existe y 409 si la clave nueva ya está en 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);

Listar valores globales

Devuelve todos los valores globales del espacio de trabajo, ordenados por clave. Un espacio de trabajo tiene como máximo 500, así que no hay paginación. Requiere una clave de API con el permiso full.

GET/global-values

Devuelve

dataobject[]

Los valores globales.

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

Eliminar un valor global

Elimina un valor global. A partir de ese momento, {{global.<key>}} se renderiza vacío, las condiciones sobre él no ven ningún valor y los pasos Wait until que lo leen toman su camino de «fecha pasada». Requiere una clave de API con el permiso full.

DELETE/global-values/{id}

Parámetros de ruta

idstringobligatorio

El ID (gv_…) o la clave.

Devuelve

Devuelve { "message": "Global value was deleted." }, o 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);